1tunefs.ocfs2(8) OCFS2 Manual Pages tunefs.ocfs2(8)
2
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
16 tunefs.ocfs2(8) 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
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 --fs-features=[no]sparse...
31 Turn specific file system features on or off. tunefs.ocfs2(8)
32 will 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, refer to
35 mkfs.ocfs2(8).
36 -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,
42 refer to mkfs.ocfs2(8).
43 -L, --label volume-label
46 Change the volume label of the file system. Limit the label to
47 under 64 bytes.
48 -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 -S, --volume-size
59 Grow the size of the OCFS2 file system. If blocks-count is not
60 specified, tunefs.ocfs2(8) extends the volume to the current
61 size of the device.
62 -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 B Block size in bytes
73 T Cluster size in bytes
75 N Number of node slots
77 R Root directory block number
79 Y System directory block number
81 P First cluster group block number
83 V Volume label
85 U Volume uuid
87 M Compat flags
89 H Incompat flags
91 O RO Compat flags
93 -q, --quiet
96 Quiet mode.
97 -U, --uuid-reset[=new-uuid]
100 Reset the volume UUID of the file system. If not provided, the
101 utility will auto generate it. For custom UUID, specify in
102 either the plain (2A4D1C581FAA42A1A41D26EFC90C1315) or the tra‐
103 ditional (2a4d1c58-1faa-42a1-a41d-26efc90c1315) format. Users
104 specifying custom UUIDs must be careful to ensure that no two
105 volumes have the same UUID. If more than one file system were to
106 have the same UUID, one is very likely to encounter erratic
107 behavior, if not, outright file system corruption.
108 -v, --verbose
111 Verbose mode.
112 -V, --version
115 Show version and exit.
116 -y, --yes
119 Always answer Yes in interactive command line.
120 -n, --no
123 Always answer No in interactive command line.
124 --backup-super
127 Backs up the superblock to fixed offsets (1G, 4G, 16G, 64G, 256G
128 and 1T) on disk. This option is useful for users to backup the
129 superblock on volumes that the user either explicitly disallowed
130 while formatting, or, used a version of mkfs.ocfs2(8) (1.2.2 or
131 older) that did not provide this facility.
132 --list-sparse
135 Lists the files having holes. This option is useful when dis‐
136 abling the sparse feature.
137 --update-cluster-stack
140 Updating on-disk cluster information to match the running clus‐
141 ter. Users looking to update the on-disk cluster stack without
142 starting the new cluster should use the o2cluster(8) utility.
143 blocks-count
146 During resize, tunefs.ocfs2(8) automatically determines the size
147 of the given device and grows the file system such that it uses
148 all of the available space on the device. This optional argument
149 specifies that the file system should be extended to consume
150 only the given number of file system blocks on the device.
151
154 # tunefs.ocfs2 -Q "UUID = %U\nNumSlots = %N\n" /dev/sda1
155 UUID = CBB8D5E0C169497C8B52A0FD555C7A3E
156 NumSlots = 4
157
160 debugfs.ocfs2(8) fsck.ocfs2(8) fsck.ocfs2.checks(8) mkfs.ocfs2(8)
161 mount.ocfs2(8) mounted.ocfs2(8) o2cluster(8) o2image(8) o2info(1)
162
165 Oracle Corporation
166
169 Copyright © 2004, 2012 Oracle. All rights reserved.
170Version 1.8.5 January 2012 tunefs.ocfs2(8)