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.