1REISERFSTUNE(8) System Manager's Manual REISERFSTUNE(8)
2
3
4
6 reiserfstune - The tunning tool for the ReiserFS filesystem.
7
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
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
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
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
153 This version of reiserfstune has been written by Vladimir Demidov
154 <vova@namesys.com> and Edward Shishkin <edward@namesys.com>.
155
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
163 reiserfsck(8), debugreiserfs(8), mkreiserfs(8)
164
165
166
167
168
169Reiserfsprogs-3.6.19 February 2004 REISERFSTUNE(8)