Whamcloud - gitweb
LUDOC-222 mount: Fix some issue with mount documentation 28/9128/3
authorMatt Ezell <ezellma@ornl.gov>
Wed, 5 Feb 2014 05:23:26 +0000 (00:23 -0500)
committerRichard Henwood <richard.henwood@intel.com>
Wed, 26 Mar 2014 14:14:09 +0000 (14:14 +0000)
In 33.5:
- Missing 'localflock'
- Missing 'nomgs'
- Missing (no)user_fid2path
- Missing (no)acl, but left out because it's marked as deprecated
In 37.15.3:
- Added user_fid2path and nouser_fid2path entries were added
- 'nosvc' 'nomgs' and 'exclude' are listed twice
- The 'nomgs' was misspelled as 'nomsgs'

Signed-off-by: Matt Ezell <ezellma@ornl.gov>
Change-Id: I0fdf197f5c5fd5c8c4c8f82e390cd8dd945bff2b
Reviewed-on: http://review.whamcloud.com/9128
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <andreas.dilger@intel.com>
SystemConfigurationUtilities.xml
UserUtilities.xml

index da51d84..fc39f27 100644 (file)
@@ -1952,63 +1952,71 @@ mount.lustre</title>
                 <para> Disables Access Control List support.</para>
               </entry>
             </row>
-          </tbody>
-        </tgroup>
-      </informaltable>
-      <para>In addition to the standard mount options and backing disk type (e.g. ext3) options, Lustre understands the following server-specific options:</para>
-      <informaltable frame="all">
-        <tgroup cols="2">
-          <colspec colname="c1" colwidth="50*"/>
-          <colspec colname="c2" colwidth="50*"/>
-          <thead>
             <row>
               <entry>
-                <para><emphasis role="bold">Option</emphasis></para>
+                <para> <literal>verbose</literal></para>
               </entry>
               <entry>
-                <para><emphasis role="bold">Description</emphasis></para>
+                <para> Enable mount/umount console messages.</para>
               </entry>
             </row>
-          </thead>
-          <tbody>
             <row>
               <entry>
-                <para> <literal>nosvc</literal></para>
+                <para> <literal>noverbose</literal></para>
               </entry>
               <entry>
-                <para>  Starts the MGC (and MGS, if co-located) for a target service, not the actual service.</para>
+                <para> Disable mount/umount console messages.</para>
               </entry>
             </row>
             <row>
               <entry>
-                <para> <literal>nomsgs</literal></para>
+                <para> <literal>user_fid2path</literal></para>
               </entry>
               <entry>
-                <para>  Starts only the MDT (with a co-located MGS), without starting the MGS.</para>
+                <para condition='l23'>Enable FID to path translation by regular users. Note: This option allows a potential security hole because it allows regular users direct access to a file by its FID, bypassing POSIX path-based permission checks which could otherwise prevent the user from accessing a file in a directory that they do not have access to. Regular permission checks are still performed on the file itself, so the user cannot access a file to which they have no access rights.</para>
               </entry>
             </row>
             <row>
               <entry>
-                <para> <literal>exclude=<replaceable>ostlist</replaceable></literal></para>
+                <para> <literal>nouser_fid2path</literal></para>
               </entry>
               <entry>
-                <para>  Starts a client or MDT with a colon-separated list of known inactive OSTs.</para>
+                <para condition='l23'> Disable FID to path translation by regular users. Root and processes with CAP_DAC_READ_SEARCH can still perform FID to path translation.</para>
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+      <para>In addition to the standard mount options and backing disk type (e.g. ext3) options, Lustre understands the following server-specific options:</para>
+      <informaltable frame="all">
+        <tgroup cols="2">
+          <colspec colname="c1" colwidth="50*"/>
+          <colspec colname="c2" colwidth="50*"/>
+          <thead>
+            <row>
+              <entry>
+                <para><emphasis role="bold">Option</emphasis></para>
+              </entry>
+              <entry>
+                <para><emphasis role="bold">Description</emphasis></para>
               </entry>
             </row>
+          </thead>
+          <tbody>
             <row>
               <entry>
                 <para> <literal>nosvc</literal></para>
               </entry>
               <entry>
-                <para>  Only starts the MGC (and MGS, if co-located) for a target service, not the actual service.</para>
+                <para>  Starts the MGC (and MGS, if co-located) for a target service, not the actual service.</para>
               </entry>
             </row>
             <row>
               <entry>
-                <para> <literal>nomsgs</literal></para>
+                <para> <literal>nomgs</literal></para>
               </entry>
               <entry>
-                <para>  Starts a MDT with a co-located MGS, without starting the MGS.</para>
+                <para>  Starts only the MDT (with a co-located MGS), without starting the MGS.</para>
               </entry>
             </row>
             <row>
@@ -2016,7 +2024,7 @@ mount.lustre</title>
                 <para> <literal>exclude=<replaceable>ostlist</replaceable></literal></para>
               </entry>
               <entry>
-                <para>  Starts a client or MDT with a (colon-separated) list of known inactive OSTs.</para>
+                <para>  Starts a client or MDT with a colon-separated list of known inactive OSTs.</para>
               </entry>
             </row>
             <row>
index 34b8913..20f8319 100644 (file)
@@ -1067,12 +1067,28 @@ ext:       device_logical:         start..end              physical:
           </row>
           <row>
             <entry>
+              <para> <literal>nomgs</literal></para>
+            </entry>
+            <entry>
+              <para>Start a MDT with a co-located MGS without starting the MGS</para>
+            </entry>
+          </row>
+          <row>
+            <entry>
               <para> <literal>exclude</literal></para>
             </entry>
             <entry>
               <para>Starts with a dead OST</para>
             </entry>
           </row>
+          <row>
+            <entry>
+              <para> <literal>md_stripe_cache_size</literal></para>
+            </entry>
+            <entry>
+              <para>Sets the stripe cache size for server side disk with a striped raid configuration</para>
+            </entry>
+          </row>
         </tbody>
       </tgroup>
     </informaltable>
@@ -1093,10 +1109,10 @@ ext:       device_logical:         start..end              physical:
         <tbody>
           <row>
             <entry>
-              <para> <literal>flock</literal></para>
+              <para> <literal>flock/noflock/localflock</literal></para>
             </entry>
             <entry>
-              <para>Enables/disables flock support</para>
+              <para>Enables/disables global flock or local flock support</para>
             </entry>
           </row>
           <row>
@@ -1109,6 +1125,14 @@ ext:       device_logical:         start..end              physical:
           </row>
           <row>
             <entry>
+              <para> <literal>user_fid2path/nouser_fid2path</literal></para>
+            </entry>
+            <entry>
+              <para condition='l23'>Enables/disables FID to path translation by regular users</para>
+            </entry>
+          </row>
+          <row>
+            <entry>
               <para> <literal>retry=</literal></para>
             </entry>
             <entry>