Whamcloud - gitweb
b=12421
[fs/lustre-release.git] / lustre / doc / lmc.1
index 1b24ef8..9197ead 100644 (file)
@@ -51,6 +51,9 @@ Specify the location of the Portals upcall scripts used by the client for recove
 --upcall <path> 
 Specify the location of both (Lustre and Portals) upcall scripts used by the client for recovery.
 .TP
+--group_upcall <path> 
+Specify the location of the group upcall scripts used by the MDS for determiningsupplementary group membership.
+.TP
 --ptldebug <debug_level>
 Set the portals debug level.
 .TP
@@ -102,9 +105,6 @@ Common name of the MDS.
 .TP
 --mdsuuid <uuid>
 Specify MDS uuid.
-.TP
---failover
-Enable failover support on MDS.
 .TP 
 --dev <pathname> 
 Path of device on local system. If the is a file, then a loop device is created and used as the block device.
@@ -118,17 +118,21 @@ Optional argument indicating the size (in KB) of the device to be created (used
 --node <nodename> 
 Adds an MDS to the specified node. This requires a --node argument, and it must not be a profile node.
 .TP
---fstype extN|ext3 
+--fstype ldiskfs|ext3 
 Optional argument used to specify the file system type. Default is ext3.
-.TP
---backfstype ext3|tmpfs 
-Specify the backing filesystem type.
-.TP
---nspath 
-Local mount point of server namespace.
+For 2.6 kernels the ldiskfs filesystem must be used.
 .TP
 --inode_size <size> 
-Specify new inode size for underlying ext3 file system.
+Specify new inode size for underlying ext3 file system.  Must be a power of 2
+between 128 and 4096.  The default inode size is selected based on the default
+number of stripes specified for the filesystem.
+.TP
+--group_upcall <pathname> 
+The group upcall program to call for resolving a user's secondary groups.
+The default value is NONE, which means that the MDS will use whatever
+supplementary group is passed from the client.  The supplied upcall is
+/usr/sbin/l_getgroups, which gets groups from the MDS's /etc/group file
+based on the client-supplied UID.
 .TP
 --mkfsoptions <options> 
 Optional argument to mkfs.
@@ -137,7 +141,7 @@ Optional argument to mkfs.
 Optional argument to mount fs. Mount options will be passed by this argument. For example, extents are to be enabled by adding ",extents" to the --mountfsoptions option. "errors=remount-ro" and "asyncdel" can also be added to it.
 .TP
 --journal_size <size> 
-Optional arguement to specify the journal size for the ext2/ext3 file system. The size should be in the units expected by mkfs, so for ext3 it should be in MB. If this is option is not used, the ext2/ext3 filesystem will be configured with the default journal size.
+Optional arguement to specify the journal size for the ext3 file system. The size should be in the units expected by mkfs, so for ext3 it should be in MB. If this is option is not used, the ext3 filesystem will be configured with the default journal size.
 .PP
 .B --add lov 
 Creates an LOV with the specified parameters. The mds_name must already exist in the descriptor.
@@ -149,10 +153,10 @@ Common name for the LOV
 Common name for the MDS
 .TP
 --stripe_sz <size>
-Stripe size
+Specify the stripe size in bytes.  This much data is written to each stripe before starting to write in the next stripe.  Default is 1048576.
 .TP
 --stripe_cnt <count> 
-A value of 0 for this means to stripe on all available OSTs. Default is 0.
+A value of 0 for this means to use the currently optimal number of stripes.  Default is 1 stripe per file.
 .TP
 --stripe_pattern <pattern> 
 Only Pattern 0 (RAID 0) is supported currently.
@@ -166,15 +170,15 @@ Assign a name to the OST device.
 --node <nodename> 
 Node on which the OST service is run, can not be a profile node.
 .TP
---failover 
+--failout
+Disable failover support on OST.
+.TP
+--failover
 Enable failover support on OST.
 .TP
 --dev <pathname> 
 Path of device on local system. If this is a file, then a loop device is created and used as the block device.
 .TP
---backdev <pathname> 
-Path of the device for backing storage on local system.
-.TP
 --size [size] 
 Optional argument indicating the size (in KB) of the device to be created (used typically for loop devices).
 .TP
@@ -188,17 +192,11 @@ Optional arguement. Name of LOV to which this OSC will be attached.
 Specify the UUID of the OST device. 
 .TP
 --fstype 
-extN|ext3 Optional arguement used to specify the file system type. Default is ext3.
-.TP
---backfstype ext3|tmpfs 
-Optional argument to specify the backing filesystem type.
+ldiskfs|ext3 Optional arguement used to specify the file system type. Default is ext3.
 .TP
 --inode_size <size> 
 Specify new inode size for underlying ext3 file system.
 .TP
---nspath 
-Local mount point of server namespace.
-.TP
 --mkfsoptions <options> 
 Optional argument to mkfs.
 .TP
@@ -206,10 +204,10 @@ Optional argument to mkfs.
 Optional argument to mount fs. Mount options will be passed by this argument. For example, extents are to be enabled by adding ",extents" to the --mountfsoptions option. "errors=remount-ro" and "asyncdel" can also be added to it.
 .TP
 --journal_size <size> 
-Optional arguement to specify the journal size for the ext2/ext3 file system. The size should be in the units expected by mkfs, so for ext3 it should be in MB. If this is option is not used, the ext2/ext3 filesystem will be configured with the default journal size.
+Optional arguement to specify the journal size for the ext3 file system. The size should be in the units expected by mkfs, so for ext3 it should be in MB. If this is option is not used, the ext3 filesystem will be configured with a journal size dependent upon how large the filesystem is.
 .PP
 .B --add mtpt 
-Creates a mount-point on the specified node. Either an LOV or OSC name can be used.
+Creates a mount-point on the specified node for the given LOV.
 .TP
 --node node 
 Node that will use the mtpt.
@@ -222,9 +220,6 @@ MDS name
 .TP
 --ost ost_name | --lov lov_name
 OST or LOV name as specified earlier in the configuration
-.TP
---clientoptions options
-Specify the options for Lustre, such as async.
 .PP
 .B --add route 
 Creates a static route through a gateway to a specific nid or a range of nid's.
@@ -257,27 +252,6 @@ Used for testing purpose only.
 Name of the node that echo client should run on,
 .TP
 --obd obd_name 
-.PP
-.B --add mgmt 
-Management/monitoring service.
-.TP
---node nodename 
-Node on which the mgmt service resides.
-.TP
---mgmt <mgmt_service_name> 
-Specify management/monitoring service name.
-.PP
-.B --add cobd 
-Create the cobd on the specified node.
-.TP
---node nodename 
-Node on which the cobd resides.
-.TP
---cache_obd obd_name 
-Specify the cache device for the cache obd system.
-.TP
---real_obd obd_name 
-Specify the real device for the cache obd system.
 .SH OPTIONS
 One of the following options should be specified.
 .TP 12