1REISERFSTUNE(8)             System Manager's Manual            REISERFSTUNE(8)
2
3
4

NAME

6       reiserfstune - The tunning tool for the ReiserFS filesystem.
7

SYNOPSIS

9       reiserfstune  [  -f  ]  [  -j | --journal-device FILE ] [ --no-journal-
10       available ] [ --journal-new-device FILE ] [ --make-journal-standard ] [
11       -s  |  --journal-new-size  N  ]  [ -o | --journal-new-offset N ] [ -t |
12       --max-transaction-size N ] [ -b | --add-badblocks file ] [ -B |  --bad‐
13       blocks file ] [ -u | --uuid UUID ] [ -l | --label LABEL ] device
14

DESCRIPTION

16       reiserfstune is used for tuning the ReiserFS. It can change two journal
17       parameters (the journal size and the maximum transaction size), and  it
18       can  move  the journal's location to a new specified block device. (The
19       old ReiserFS's journal may be kept unused, or discarded at  the  user's
20       option.)  Besides that reiserfstune can store the bad block list to the
21       ReiserFS and set UUID and LABEL.  Note: At  the  time  of  writing  the
22       relocated  journal  was  implemented for a special release of ReiserFS,
23       and was not expected to be put into the mainstream kernel until approx‐
24       imately  Linux  2.5.   This means that if you have the stock kernel you
25       must apply a special patch. Without this patch the kernel  will  refuse
26       to mount the newly modified file system.  We will charge $25 to explain
27       this to you if you ask us why it doesn't work.
28
29       Perhaps the most interesting application of this code  is  to  put  the
30       journal on a solid state disk.
31
32       device is  the  special file corresponding to the newly specified block
33              device (e.g /dev/hdXX for IDE disk partition  or  /dev/sdXX  for
34              the SCSI disk partition).
35

OPTIONS

37       -j | --journal-device FILE
38              FILE  is  the  file name of the block device the file system has
39              the current journal (the one prior to running reiserfstune)  on.
40              This  option  is required when the journal is already on a sepa‐
41              rate device from the  main  data  device  (although  it  can  be
42              avoided with --no-journal-available). If you don't specify jour‐
43              nal device by this option, reiserfstune suppose that journal  is
44              on main device.
45
46       --no-journal-available
47              allows reiserfstune to continue when the current journal's block
48              device is no longer available.  This might happen if a disk goes
49              bad and you remove it (and run fsck).
50
51       --journal-new-device FILE
52              FILE is the file name of the block device which will contain the
53              new journal for the file system.  If  you  don't  specify  this,
54              reiserfstune   supposes   that   journal   device   remains  the
55              same.
56
57        -s | --journal-new-size N
58              N is the size parameter for the new journal. When journal is  to
59              be  on a separate device - its size defaults to number of blocks
60              that device has. When journal is to be on the same device as the
61              filesytem  - its size defaults to amount of blocks allocated for
62              journal by mkreiserfs when it created the filesystem. Minimum is
63              513 for both cases.
64
65        -o | --journal-new-offset N
66              N  is  an  offset  in blocks where journal will starts from when
67              journal is to be on a separate device.  Default  is  0.  Has  no
68              effect  when journal is to be on the same device as the filesys‐
69              tem.  Most users have no need to use this feature.   It  can  be
70              used  when  you  want  the journals from multiple filesystems to
71              reside on the same device, and you don't want to or cannot  par‐
72              tition that device.
73
74        -t | --maximal-transaction-size N
75              N is the maximum transaction size parameter for the new journal.
76              The default, and max possible, value is 1024 blocks.  It  should
77              be  less  than  half the size of the journal. If specifed incor‐
78              rectly, it will be adjusted.
79
80        -b | --add-badblocks file
81              File is the file name of the file  that  contains  the  list  of
82              blocks  to  be marked as bad on the fs. The list is added to the
83              fs list of bad blocks.
84
85        -B | --badblocks file
86              File is the file name of the file  that  contains  the  list  of
87              blocks  to be marked as bad on the fs. The bad block list on the
88              fs is cleared before the list specified in the File is added  to
89              the fs.
90
91       -f | --force
92              Normally  reiserfstune will refuse to change a journal of a file
93              system that was created before  this  journal  relocation  code.
94              This  is  because  if you change the journal, you cannot go back
95              (without special option --make-journal-standard) to an old  ker‐
96              nel  that  lacks this feature and be able to use your filesytem.
97              This option forces it to do that. Specified more  than  once  it
98              allows to avoid asking for confirmation.
99
100       --make-journal-standard
101              As  it was mentioned above, if your file system has non-standard
102              journal, it can not be mounted on  the  kernel  without  journal
103              relocation code. The thing can be changed, the only condition is
104              that there is reserved area on main device of the standard jour‐
105              nal size 8193 blocks  (it will be so for instance if you convert
106              standard journal to non-standard). Just specify this option when
107              you  relocate journal back, or without relocation if you already
108              have it on main device.
109
110       -u | --uuid UUID
111              Set  the  universally   unique   identifier  (  UUID  )  of  the
112              filesystem  to  UUID (see also uuidgen(8)). The  format  of  the
113              UUID  is  a series  of  hex  digits   separated   by   hypthens,
114              like  this: "c1b9d5a2-f162-11cf-9ece-0020afc76f16".
115
116       -l | --label LABEL
117              Set   the   volume   label   of  the filesystem. LABEL can be at
118              most 16 characters long; if it is  longer  than  16  characters,
119              reiserfstune will truncate it.
120

POSSIBLE SCENARIOS OF USING REISERFSTUNE:

122       1. You have ReiserFS on /dev/hda1, and you wish to have it working with
123       its journal on the device /dev/journal
124
125              boot kernel patched with special "relocatable journal support" patch
126              reiserfstune /dev/hda1 --journal-new-device /dev/journal -f
127              mount /dev/hda1 and use.
128              You would like to change max transaction size to 512 blocks
129              reiserfstune -t 512 /dev/hda1
130              You would like to use your file system on another kernel that doesn't
131              contain relocatable journal support.
132              umount /dev/hda1
133              reiserfstune /dev/hda1 -j /dev/journal --journal-new-device /dev/hda1 --make-journal-standard
134              mount /dev/hda1 and use.
135
136       2. You would like to have ReiserFS on /dev/hda1 and to be able to
137       switch between different journals including journal located on the
138       device containing the filesystem.
139
140              boot kernel patched with special "relocatable journal support" patch
141              mkreiserfs /dev/hda1
142              you got solid state disk (perhaps /dev/sda, they typically look like scsi disks)
143              reiserfstune --journal-new-device /dev/sda1 -f /dev/hda1
144              Your scsi device dies, it is three in the morning, you have an extra IDE device
145              lying around
146              reiserfsck --no-journal-available /dev/hda1
147              or
148              reiserfsck --rebuild-tree --no-journal-available /dev/hda1
149              reiserfstune --no-journal-available --journal-new-device /dev/hda1 /dev/hda1
150              using /dev/hda1 under patched kernel
151

AUTHOR

153       This version of reiserfstune  has  been  written  by  Vladimir  Demidov
154       <vova@namesys.com> and Edward Shishkin <edward@namesys.com>.
155

BUGS

157       Please    report   bugs   to   the   ReiserFS   developers   <reiserfs-
158       dev@namesys.com>, providing as much information as possible--your hard‐
159       ware, kernel, patches, settings, all printed messages; check the syslog
160       file for any related information.
161

SEE ALSO

163       reiserfsck(8), debugreiserfs(8), mkreiserfs(8)
164
165
166
167
168
169Reiserfsprogs-3.6.19             February 2004                 REISERFSTUNE(8)
Impressum