.\" -*- nroff -*-
-.\" Copyright 2006 by Cluster FileSystems. All Rights Reserved.
+.\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
+.\"
+.\" Copyright (c) 2011, Whamcloud, Inc.
+.\"
.\" This file may be copied under the terms of the GNU Public License.
.\"
-.TH mkfs.lustre 8 "2006 Jun 15" Lustre "configuration utilities"
+.TH mkfs.lustre 8 "2008 Mar 15" Lustre "configuration utilities"
.SH NAME
mkfs.lustre \- format a disk for a Lustre service
.SH SYNOPSIS
.br
-.B mkfs.lustre
-<target_type> [options]
+.BR mkfs.lustre { --ost | --mdt | --mgs }
+.I [options]
.I device
.br
-where
.B <target_type>
is one of
.TP
.TP
.BI \--failnode= nid,...
Set the NID(s) of a failover partner. This option can be repeated as desired.
+Cannot be used with --servicenode.
+.TP
+.BI \--servicenode= nid,....
+Set the NID(s) of all service partner. This option treats all nodes as equal
+service nodes. Cannot be used with --failnode.
.TP
.BI \--fsname= filesystem_name
-The Lustre filesystem this service will be part of. Default is 'lustre'
+The Lustre filesystem this service will be part of. The maximum
+filesystem_name length is 8 characters. Default is 'lustre'
.TP
.BI \--index= index
Force a particular OST or MDT index
Format options for the backing fs. For example, ext3 options could be set here.
.TP
.BI \--mountfsoptions= opts
-Set permanent mount options, equivalent to setting in /etc/fstab
+Set the mount options that will be used when mounting the backing fs.
+WARNING: unlike earlier versions of \fBmkfs.lustre\fR, this version completely
+replaces the default mount options with those specified on the command line,
+issuing a warning on stderr if any of the default mount options are omitted.
+The defaults for \fIldiskfs\fR are
+OST: \fIerrors=remount-ro,mballoc,extents\fR;
+MGS/MDT: \fIerrors=remount-ro,user_xattr\fR.
+\fBDO NOT\fR alter the default mount options unless you know what you are doing.
+.TP
+.BI \--network= net,...
+Network(s) to restrict this ost/mdt to. This option can be repeated as desired.
.TP
.BI \--mgsnode= nid,...
Set the NID(s) of the MGS node, required for all targets other than the MGS.
Set permanent parameter
.I key
to value
-.I value.
+.IR value .
This option can be repeated as desired. Typical options might include:
.RS
.I \--param sys.timeout=40
.RE
.I \--param failover.mode=failout
.RS
-Return errs instead of waiting for recovery
+Return errors instead of waiting for recovery
.RE
.RE
.TP
MDT for filesystem 'myfs1' on any node, using the above MGS
.SH BUGS
-Please report all bugs to Cluster FileSystems, support@clusterfs.com
+Please report all bugs to Sun Microsystems via http://bugzilla.lustre.org/
.SH AVAILABILITY
.B mkfs.lustre
is part of the
.BR Lustre (7)
-filesystem package and is available from CFS
+filesystem package and is available from Sun Microsystems via
.br
-http://clusterfs.com
+http://downloads.lustre.org/
.SH SEE ALSO
-.BR Lustre (7),
+.BR lustre (7),
.BR mount.lustre (8),
.BR tunefs.lustre (8),
.BR lctl (8),