Provided by: ocfs2-tools_1.6.3-4ubuntu1_amd64 bug

NAME

       tunefs.ocfs2 - Change OCFS2 file system parameters.

SYNOPSIS

       tunefs.ocfs2  [--cloned-volume[=new-label]  [--fs-features=list-of-features]  [-J journal-
       options]  [-L  volume-label]  [-N  number-of-node-slots]  [-Q  query-format]  [-ipqnSUvVy]
       [--backup-super] [--list-sparse] device  [blocks-count]

DESCRIPTION

       tunefs.ocfs2 is used to adjust OCFS2 file system parameters on disk.  The tool expects the
       cluster to be online as it needs to take the appropriate cluster locks to write safely  to
       disk.

OPTIONS

       --cloned-volume[=new-label]
              Change  the  volume  UUID  (auto-generated) and the label, if provided, of a cloned
              OCFS2 volume.  This option does not perform volume cloning.  It  only  changes  the
              UUID  and  label  on a cloned volume so that it can be mounted on the node that has
              the original volume mounted.

       --fs-features=[no]sparse...
              Turn specific file system features on or off. tunefs.ocfs2 will attempt  to  enable
              or  disable the feature list provided. To enable a feature, include it in the list.
              To disable a feature, prepend no to the name. For a list of feature names, see  the
              man page for mkfs.ocfs2.

       -J, --journal-options options
              Modify the journal using options specified on the command-line. Journal options are
              comma separated, and may take an argument using the equals ('=') sign. For  a  list
              of possible options, see the man page for mkfs.ocfs2.

       -L, --label volume-label
              Change the volume label of the file system. Limit the label to under 64 bytes.

       -N, --node-slots number-of-node-slots
              Valid  number  ranges  from  1  to 255. This number specifies the maximum number of
              nodes that can concurrently mount the partition. Use this to increase  or  decrease
              the  number  of  node  slots.  One reason to decrease could be to release the space
              consumed by the journals for those slots.

       -S, --volume-size
              Grow the size  of  the  OCFS2  file  system.  If  blocks-count  is  not  specified,
              tunefs.ocfs2 extends the volume to the current size of the device.

       -Q, --query query-format
              Query the file system for its attributes like block size, label, etc. Query formats
              are modified versions of the standard printf(3) formatting. The format is  made  up
              of  static  strings  (which  may include standard C character escapes for newlines,
              tabs, and other special characters) and printf(3) type formatters. The list of type
              specifiers is as follows:

                   B    Block size in bytes

                   T    Cluster size in bytes

                   N    Number of node slots

                   R    Root directory block number

                   Y    System directory block number

                   P    First cluster group block number

                   V    Volume label

                   U    Volume uuid

                   M    Compat flags

                   H    Incompat flags

                   O    RO Compat flags

       -q, --quiet
              Quiet mode.

       -U, --uuid-reset[=new-uuid]
              Set  the volume UUID for the file system. If not provided, will auto generate a new
              UUID. The format of the provided UUID should be 178BDC83D50241EF94EB474A677D498B or
              178BDC83-D502-41EF-94EB-474A677D498B.

       -v, --verbose
              Verbose mode.

       -V, --version
              Show version and exit.

       -y, --yes
              Always answer Yes in interactive command line.

       -n, --no
              Always answer No in interactive command line.

       --backup-super
              Backs  up  the superblock to fixed offsets (1G, 4G, 16G, 64G, 256G and 1T) on disk.
              This option is useful for users to backup the superblock on volumes that  the  user
              either  explicitly  disallowed  while  formatting, or, used a version of mkfs.ocfs2
              (1.2.2 or older) that did not provide this facility.

       --list-sparse
              Lists the files having holes. This option  is  useful  when  disabling  the  sparse
              feature.

       --update-cluster-stack
              Updating on-disk cluster information to match the running cluster.

       blocks-count
              During  resize,  tunefs.ocfs2 automatically determines the size of the given device
              and grows the file system such that it uses all  of  the  available  space  on  the
              device. This optional argument specifies that the file system should be extended to
              consume only the given number of file system blocks on the device.

EXAMPLES

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

SEE ALSO

       mkfs.ocfs2(8) fsck.ocfs2(8) debugfs.ocfs2(8) mounted.ocfs2(8) ocfs2console(8) o2cb(7)

AUTHORS

       Oracle Corporation

COPYRIGHT

       Copyright © 2004, 2010 Oracle. All rights reserved.