1tunefs.ocfs2(8)               OCFS2 Manual Pages               tunefs.ocfs2(8)
2
3
4

NAME

6       tunefs.ocfs2 - Change OCFS2 file system parameters.
7

SYNOPSIS

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

DESCRIPTION

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
20

OPTIONS

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(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
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,
42              refer to mkfs.ocfs2(8).
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(8)  extends  the  volume to the current
61              size 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[=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
109
110       -v, --verbose
111              Verbose mode.
112
113
114       -V, --version
115              Show version and exit.
116
117
118       -y, --yes
119              Always answer Yes in interactive command line.
120
121
122       -n, --no
123              Always answer No in interactive command line.
124
125
126       --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
133
134       --list-sparse
135              Lists the files having holes. This option is  useful  when  dis‐
136              abling the sparse feature.
137
138
139       --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
144
145       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
152

EXAMPLES

154       # tunefs.ocfs2 -Q "UUID = %U\nNumSlots = %N\n" /dev/sda1
155       UUID = CBB8D5E0C169497C8B52A0FD555C7A3E
156       NumSlots = 4
157
158

SEE ALSO

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
163

AUTHORS

165       Oracle Corporation
166
167
169       Copyright © 2004, 2012 Oracle. All rights reserved.
170
171
172
173Version 1.8.5                    January 2012                  tunefs.ocfs2(8)
Impressum