.TH "tunefs.ocfs2" "8" "January 2012" "Version @VERSION@" "OCFS2 Manual Pages"
.SH "NAME"
tunefs.ocfs2 \- Change \fIOCFS2\fR file system parameters.
.SH "SYNOPSIS"
\fBtunefs.ocfs2\fR [\fB\-\-cloned\-volume\fR[=\fInew-label\fR] [\fB\-\-fs\-features=\fR\fIlist\-of\-features\fR] [\fB\-J\fR \fIjournal-options\fR] [\fB\-L\fR \fIvolume-label\fR] [\fB\-N\fR \fInumber-of-node-slots\fR] [\fB\-Q\fR \fIquery-format\fR] [\fB\-ipqnSUvVy\fR] [\fB\-\-backup-super\fR] [\fB\-\-list\-sparse\fR] \fIdevice\fR  [\fIblocks-count\fR]

.SH "DESCRIPTION"
.PP
\fBtunefs.ocfs2(8)\fR is used to adjust \fIOCFS2\fR 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.

.SH "OPTIONS"
.TP
\fB\-\-cloned\-volume\fR[=\fInew-label]\fR
Change the volume UUID (auto-generated) and the label, if provided, of a cloned \fIOCFS2\fR volume.
This option does \fBnot\fR 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.

.TP
\fB\-\-fs\-features=\fR\fI[no]sparse...\fR
Turn specific file system features on or off. \fBtunefs.ocfs2(8)\fR will attempt to enable or disable the feature list provided. To enable a feature, include it in the list. To disable a feature, prepend \fBno\fR to the name. For a list of feature names, refer to \fBmkfs.ocfs2(8)\fR.

.TP
\fB\-J, \-\-journal\-options\fR \fIoptions\fR
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, refer to \fBmkfs.ocfs2(8)\fR.

.TP
\fB\-L, \-\-label\fR \fIvolume\-label\fR
Change the volume label of the file system. Limit the label to under 64 bytes.

.TP
\fB\-N, \-\-node\-slots\fR \fInumber\-of\-node\-slots\fR
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.

.TP
\fB\-S, \-\-volume\-size\fR
Grow the size of the \fIOCFS2\fR file system. If \fIblocks-count\fR is not
specified, \fBtunefs.ocfs2(8)\fR extends the volume to the current size of
the device.

.TP
\fB\-Q, \-\-query\fR \fIquery\-format\fR
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:
.RS 1.2i
.TP
\fBB\fR	Block size in bytes
.TP
\fBT\fR	Cluster size in bytes
.TP
\fBN\fR	Number of node slots
.TP
\fBR\fR	Root directory block number
.TP
\fBY\fR	System directory block number
.TP
\fBP\fR	First cluster group block number
.TP
\fBV\fR	Volume label
.TP
\fBU\fR	Volume uuid
.TP
\fBM\fR	Compat flags
.TP
\fBH\fR	Incompat flags
.TP
\fBO\fR	RO Compat flags
.RE

.TP
\fB\-q, \-\-quiet\fR
Quiet mode.

.TP
\fB\-U, \-\-uuid\-reset\fR[=\fInew-uuid]\fR
Reset the volume UUID of the file system. If not provided, the utility will auto
generate it. For custom UUID, specify in either the plain (2A4D1C581FAA42A1A41D26EFC90C1315)
or the traditional (2a4d1c58-1faa-42a1-a41d-26efc90c1315) format. Users specifying
custom UUIDs must be careful to ensure that no two volumes have the same UUID. \fBIf more
than one file system were to have the same UUID, one is very likely to encounter erratic
behavior, if not, outright file system corruption.\fR

.TP
\fB\-v, \-\-verbose\fR
Verbose mode.

.TP
\fB\-V, \-\-version\fR
Show version and exit.

.TP
\fB\-y, \-\-yes\fR
Always answer Yes in interactive command line.

.TP
\fB\-n, \-\-no\fR
Always answer No in interactive command line.

.TP
\fB\-\-backup\-super\fR
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 \fBmkfs.ocfs2(8)\fR (1.2.2 or older) that did not provide this
facility.

.TP
\fB\-\-list-sparse\fR
Lists the files having holes. This option is useful when disabling the \fIsparse\fR feature.

.TP
\fB\-\-update-cluster-stack\fR
Updating on-disk cluster information to match the running cluster. Users looking to
update the on-disk cluster stack without starting the new cluster should use the
\fBo2cluster(8)\fR utility.

.TP
\fIblocks-count\fR
During resize, \fBtunefs.ocfs2(8)\fR 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.

.SH "EXAMPLES"

.nf
.ft 6
# tunefs.ocfs2 -Q "UUID = %U\\nNumSlots = %N\\n" /dev/sda1
UUID = CBB8D5E0C169497C8B52A0FD555C7A3E
NumSlots = 4
.ft
.fi

.SH "SEE ALSO"
.BR debugfs.ocfs2(8)
.BR fsck.ocfs2(8)
.BR fsck.ocfs2.checks(8)
.BR mkfs.ocfs2(8)
.BR mount.ocfs2(8)
.BR mounted.ocfs2(8)
.BR o2cluster(8)
.BR o2image(8)
.BR o2info(1)

.SH "AUTHORS"
Oracle Corporation

.SH "COPYRIGHT"
Copyright \(co 2004, 2012 Oracle. All rights reserved.
