1tunefs.ocfs2(8) OCFS2 Manual Pages tunefs.ocfs2(8)
2
3
4
6 tunefs.ocfs2 - Change OCFS2 file system parameters.
7
9 tunefs.ocfs2 [--cloned-volume[=new-label] [--fs-features=list-of-fea‐
10 tures] [-J journal-options] [-L volume-label] [-N number-of-node-slots]
11 [-Q query-format] [-ipqnSUvVy] [--backup-super] [--list-sparse] device
12 [blocks-count]
13
14
16 tunefs.ocfs2 is used to adjust OCFS2 file system parameters on disk.
17 The tool expects the cluster to be online as it needs to take the
18 appropriate cluster locks to write safely to disk.
19
20
22 --cloned-volume[=new-label]
23 Change the volume UUID (auto-generated) and the label, if pro‐
24 vided, of a cloned OCFS2 volume. This option does not perform
25 volume cloning. It only changes the UUID and label on a cloned
26 volume so that it can be mounted on the node that has the origi‐
27 nal volume mounted.
28
29
30 --fs-features=[no]sparse...
31 Turn specific file system features on or off. tunefs.ocfs2 will
32 attempt to enable or disable the feature list provided. To
33 enable a feature, include it in the list. To disable a feature,
34 prepend no to the name. For a list of feature names, see the man
35 page for mkfs.ocfs2.
36
37
38 -J, --journal-options options
39 Modify the journal using options specified on the command-line.
40 Journal options are comma separated, and may take an argument
41 using the equals ('=') sign. For a list of possible options, see
42 the man page for mkfs.ocfs2.
43
44
45 -L, --label volume-label
46 Change the volume label of the file system. Limit the label to
47 under 64 bytes.
48
49
50 -N, --node-slots number-of-node-slots
51 Valid number ranges from 1 to 255. This number specifies the
52 maximum number of nodes that can concurrently mount the parti‐
53 tion. Use this to increase or decrease the number of node slots.
54 One reason to decrease could be to release the space consumed by
55 the journals for those slots.
56
57
58 -S, --volume-size
59 Grow the size of the OCFS2 file system. If blocks-count is not
60 specified, tunefs.ocfs2 extends the volume to the current size
61 of the device.
62
63
64 -Q, --query query-format
65 Query the file system for its attributes like block size, label,
66 etc. Query formats are modified versions of the standard
67 printf(3) formatting. The format is made up of static strings
68 (which may include standard C character escapes for newlines,
69 tabs, and other special characters) and printf(3) type format‐
70 ters. The list of type specifiers is as follows:
71
72 B Block size in bytes
73
74 T Cluster size in bytes
75
76 N Number of node slots
77
78 R Root directory block number
79
80 Y System directory block number
81
82 P First cluster group block number
83
84 V Volume label
85
86 U Volume uuid
87
88 M Compat flags
89
90 H Incompat flags
91
92 O RO Compat flags
93
94
95 -q, --quiet
96 Quiet mode.
97
98
99 -U, --uuid-reset
100 Change the volume UUID (auto-generated) for the file system.
101
102
103 -v, --verbose
104 Verbose mode.
105
106
107 -V, --version
108 Show version and exit.
109
110
111 -y, --yes
112 Always answer Yes in interactive command line.
113
114
115 -n, --no
116 Always answer No in interactive command line.
117
118
119 --backup-super
120 Backs up the superblock to fixed offsets (1G, 4G, 16G, 64G, 256G
121 and 1T) on disk. This option is useful for users to backup the
122 superblock on volumes that the user either explicitly disallowed
123 while formatting, or, used a version of mkfs.ocfs2 (1.2.2 or
124 older) that did not provide this facility.
125
126
127 --list-sparse
128 Lists the files having holes. This option is useful when dis‐
129 abling the sparse feature.
130
131
132 --update-cluster-stack
133 Updating on-disk cluster information to match the running clus‐
134 ter.
135
136
137 blocks-count
138 During resize, tunefs.ocfs2 automatically determines the size of
139 the given device and grows the file system such that it uses all
140 of the available space on the device. This optional argument
141 specifies that the file system should be extended to consume
142 only the given number of file system blocks on the device.
143
144
146 [root@node1 ~]# tunefs.ocfs2 -Q "UUID = %U\nNumSlots = %N\n" /dev/sda1
147 UUID = CBB8D5E0C169497C8B52A0FD555C7A3E
148 NumSlots = 4
149
150
152 mkfs.ocfs2(8) fsck.ocfs2(8) debugfs.ocfs2(8) mounted.ocfs2(8) ocfs2con‐
153 sole(8) o2cb(7)
154
155
157 Oracle Corporation
158
159
161 Copyright © 2004, 2009 Oracle. All rights reserved.
162
163
164
165Version 1.4.3 April 2009 tunefs.ocfs2(8)