tunefs.ocfs2(8)

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 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  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

EXAMPLES

146       [root@node1 ~]# tunefs.ocfs2 -Q "UUID = %U\nNumSlots = %N\n" /dev/sda1
147       UUID = CBB8D5E0C169497C8B52A0FD555C7A3E
148       NumSlots = 4
149
150

AUTHORS

157       Oracle Corporation
158
159

COPYRIGHT

161       Copyright © 2004, 2009 Oracle. All rights reserved.
162
163
164
165Version 1.4.3                     April 2009                   tunefs.ocfs2(8)