Man Linux: Main Page and Category List

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
              Change the volume UUID (auto-generated) for the file system.

       -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, 2009 Oracle. All rights reserved.