Whamcloud - gitweb
FIX: validation, ulink -> link
authorRichard Henwood <rhenwood@whamcloud.com>
Fri, 20 May 2011 18:53:05 +0000 (13:53 -0500)
committerRichard Henwood <rhenwood@whamcloud.com>
Fri, 20 May 2011 18:53:05 +0000 (13:53 -0500)
LustreProc.xml

index 6ec2582..a40c96c 100644 (file)
@@ -73,28 +73,28 @@ lustre-MDT0000</screen>
       </itemizedlist>
       <para>Specific Lustre timeouts are described below.</para>
       <para><literal>
-          <emphasis role="bold">/proc/sys/lustre/timeout</emphasis>
+          <replaceable role="bold">/proc/sys/lustre/timeout</replaceable>
         </literal></para>
       <para>This is the time period that a client waits for a server to complete an RPC (default is 100s). Servers wait half of this time for a normal client RPC to complete and a quarter of this time for a single bulk request (read or write of up to 1 MB) to complete. The client pings recoverable targets (MDS and OSTs) at one quarter of the timeout, and the server waits one and a half times the timeout before evicting a client for being &quot;stale.&quot;</para>
       <note>
         <para>Lustre sends periodic &apos;PING&apos; messages to servers with which it had no communication for a specified period of time. Any network activity on the file system that triggers network traffic toward servers also works as a health check.</para>
       </note>
       <para><literal>
-          <emphasis role="bold">/proc/sys/lustre/ldlm_timeout</emphasis>
+          <replaceable role="bold">/proc/sys/lustre/ldlm_timeout</replaceable>
         </literal></para>
       <para>This is the time period for which a server will wait for a client to reply to an initial AST (lock cancellation request) where default is 20s for an OST and 6s for an MDS. If the client replies to the AST, the server will give it a normal timeout (half of the client timeout) to flush any dirty data and release the lock.</para>
       <para><literal>
-          <emphasis role="bold">/proc/sys/lustre/fail_loc</emphasis>
+          <replaceable role="bold">/proc/sys/lustre/fail_loc</replaceable>
         </literal></para>
       <para>This is the internal debugging failure hook.</para>
       <para>See <literal>lustre/include/linux/obd_support.h</literal> for the definitions of individual failure locations. The default value is 0 (zero).</para>
       <screen>sysctl -w lustre.fail_loc=0x80000122 # drop a single reply</screen>
       <para><literal>
-          <emphasis role="bold">/proc/sys/lustre/dump_on_timeout</emphasis>
+          <replaceable role="bold">/proc/sys/lustre/dump_on_timeout</replaceable>
         </literal></para>
       <para>This triggers dumps of the Lustre debug log when timeouts occur. The default value is 0 (zero).</para>
       <para><literal>
-          <emphasis role="bold">/proc/sys/lustre/dump_on_eviction</emphasis>
+          <replaceable role="bold">/proc/sys/lustre/dump_on_eviction</replaceable>
         </literal></para>
       <para>This triggers dumps of the Lustre debug log when an eviction occurs. The default value is 0 (zero). By default, debug logs are dumped to the /tmp folder; this location can be changed via /proc.</para>
     </section>
@@ -128,7 +128,7 @@ lustre-MDT0000</screen>
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">at_min</emphasis>
+                      <replaceable role="bold">at_min</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -138,7 +138,7 @@ lustre-MDT0000</screen>
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">at_max</emphasis>
+                      <replaceable role="bold">at_max</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -152,7 +152,7 @@ lustre-MDT0000</screen>
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">at_history</emphasis>
+                      <replaceable role="bold">at_history</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -162,7 +162,7 @@ lustre-MDT0000</screen>
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">at_early_margin</emphasis>
+                      <replaceable role="bold">at_early_margin</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -174,7 +174,7 @@ lustre-MDT0000</screen>
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">at_extra</emphasis>
+                      <replaceable role="bold">at_extra</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -187,7 +187,7 @@ lustre-MDT0000</screen>
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">ldlm_enqueue_min</emphasis>
+                      <replaceable role="bold">ldlm_enqueue_min</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -236,7 +236,7 @@ req_timeout               6 samples [sec] 1 10 15 105
       <title>31.1.4 LNET Information</title>
       <para>This section describes<literal> /proc</literal> entries for LNET information.</para>
       <para><literal>
-          <emphasis role="bold">/proc/sys/lnet/peers</emphasis>
+          <replaceable role="bold">/proc/sys/lnet/peers</replaceable>
         </literal></para>
       <para>Shows all NIDs known to this node and also gives information on the queue state.</para>
       <screen># cat /proc/sys/lnet/peers
@@ -263,9 +263,9 @@ nid                        refs            state           max             rtr
           <tbody>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>refs</literal>
-                  </emphasis></para>
+                <para> 
+                        <literal><replaceable>refs</replaceable></literal>
+                  </para>
               </entry>
               <entry>
                 <para>A reference count (principally used for debugging)</para>
@@ -273,9 +273,9 @@ nid                        refs            state           max             rtr
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>state</literal>
-                  </emphasis></para>
+                <para> 
+                        <literal><replaceable>state</replaceable></literal>
+                  </para>
               </entry>
               <entry>
                 <para>Only valid to refer to routers. Possible values:</para>
@@ -295,7 +295,7 @@ nid                        refs            state           max             rtr
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">max</emphasis>
+                    <replaceable role="bold">max</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -305,7 +305,7 @@ nid                        refs            state           max             rtr
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">rtr</emphasis>
+                    <replaceable role="bold">rtr</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -314,9 +314,9 @@ nid                        refs            state           max             rtr
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>min</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">min</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Minimum routing buffer credits seen.</para>
@@ -325,7 +325,7 @@ nid                        refs            state           max             rtr
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">tx</emphasis>
+                    <replaceable role="bold">tx</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -334,9 +334,9 @@ nid                        refs            state           max             rtr
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>min</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">min</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Minimum send credits seen.</para>
@@ -344,9 +344,9 @@ nid                        refs            state           max             rtr
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>queue</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">queue</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Total bytes in active/queued sends.</para>
@@ -360,7 +360,7 @@ nid                        refs            state           max             rtr
       <para>If <literal>rtr/tx</literal> is greater that max, there are operations blocking.</para>
       <para>LNET also limits concurrent sends and router buffers allocated to a single peer so that no peer can occupy all these resources.</para>
       <para><literal>
-          <emphasis role="bold">/proc/sys/lnet/nis</emphasis>
+          <replaceable role="bold">/proc/sys/lnet/nis</replaceable>
         </literal></para>
       <screen># cat /proc/sys/lnet/nis
 nid                                refs            peer            max             tx              min
@@ -386,7 +386,7 @@ nid                                refs            peer            max
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">nid</emphasis>
+                    <replaceable role="bold">nid</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -396,7 +396,7 @@ nid                                refs            peer            max
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">refs</emphasis>
+                    <replaceable role="bold">refs</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -405,9 +405,9 @@ nid                                refs            peer            max
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>peer</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">peer</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Number of peer-to-peer send credits on this NID. Credits are used to size buffer pools</para>
@@ -416,7 +416,7 @@ nid                                refs            peer            max
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">max</emphasis>
+                    <replaceable role="bold">max</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -425,9 +425,9 @@ nid                                refs            peer            max
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>tx</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">tx</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Current number of send credits available on this NID.</para>
@@ -435,9 +435,9 @@ nid                                refs            peer            max
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>min</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">min</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Lowest number of send credits available on this NID.</para>
@@ -445,9 +445,9 @@ nid                                refs            peer            max
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>queue</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">queue</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Total bytes in active/queued sends.</para>
@@ -505,7 +505,7 @@ nid                                refs            peer            max
     <title>31.2 Lustre I/O Tunables</title>
     <para>The section describes I/O tunables.</para>
     <para><literal>
-        <emphasis role="bold">/proc/fs/lustre/llite/&lt;fsname&gt;-&lt;uid&gt;/max_cache_mb</emphasis>
+        <replaceable role="bold">/proc/fs/lustre/llite/&lt;fsname&gt;-&lt;uid&gt;/max_cache_mb</replaceable>
       </literal></para>
     <screen># cat /proc/fs/lustre/llite/lustre-ce63ca00/max_cached_mb 128</screen>
     <para>This tunable is the maximum amount of inactive data cached by the client (default is 3/4 of RAM).</para>
@@ -521,26 +521,26 @@ blocksizefilesfree max_dirty_mb ost_server_uuid stats</screen>
       <para>... and so on.</para>
       <para>RPC stream tunables are described below.</para>
       <para><literal>
-          <emphasis role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/max_dirty_mb</emphasis>
+          <replaceable role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/max_dirty_mb</replaceable>
         </literal></para>
       <para>This tunable controls how many MBs of dirty data can be written and queued up in the OSC. POSIX file writes that are cached contribute to this count. When the limit is reached, additional writes stall until previously-cached writes are written to the server. This may be changed by writing a single ASCII integer to the file. Only values between 0 and 512 are allowable. If 0 is given, no writes are cached. Performance suffers noticeably unless you use large writes (1 MB or more).</para>
       <para><literal>
-          <emphasis role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/cur_dirty_bytes</emphasis>
+          <replaceable role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/cur_dirty_bytes</replaceable>
         </literal></para>
       <para>This tunable is a read-only value that returns the current amount of bytes written and cached on this OSC.</para>
       <para><literal>
-          <emphasis role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/max_pages_per_rpc</emphasis>
+          <replaceable role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/max_pages_per_rpc</replaceable>
         </literal></para>
       <para>This tunable is the maximum number of pages that will undergo I/O in a single RPC to the OST. The minimum is a single page and the maximum for this setting is platform dependent (256 for i386/x86_64, possibly less for ia64/PPC with larger <literal>PAGE_SIZE</literal>), though generally amounts to a total of 1 MB in the RPC.</para>
       <para><literal>
-          <emphasis role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/max_rpcs_in_flight</emphasis>
+          <replaceable role="bold">/proc/fs/lustre/osc/&lt;object name&gt;/max_rpcs_in_flight</replaceable>
         </literal></para>
       <para>This tunable is the maximum number of concurrent RPCs in flight from an OSC to its OST. If the OSC tries to initiate an RPC but finds that it already has the same number of RPCs outstanding, it will wait to issue further RPCs until some complete. The minimum setting is 1 and maximum setting is 32. If you are looking to improve small file I/O performance, increase the <literal>max_rpcs_in_flight</literal> value.</para>
       <para>To maximize performance, the value for <literal>max_dirty_mb</literal> is recommended to be 4 * <literal>max_pages_per_rpc</literal> * <literal>max_rpcs_in_flight</literal>.</para>
       <note>
-        <para>The <emphasis role="italic">
-            <literal>&lt;object name&gt;</literal>
-          </emphasis> varies depending on the specific Lustre configuration. For <literal>&lt;object name&gt;</literal> examples, refer to the sample command output.</para>
+        <para>The 
+            <literal><replaceable>&lt;object name&gt;</replaceable></literal>
+           varies depending on the specific Lustre configuration. For <literal>&lt;object name&gt;</literal> examples, refer to the sample command output.</para>
       </note>
     </section>
     <section remap="h3">
@@ -658,7 +658,7 @@ R          8385            500                     600                     100
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">R/W</emphasis>
+                    <replaceable role="bold">R/W</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -667,9 +667,9 @@ R          8385            500                     600                     100
             </row>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>PID</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">PID</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Process ID which made the read/write call.</para>
@@ -678,7 +678,7 @@ R          8385            500                     600                     100
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">Range Start/Range End</emphasis>
+                    <replaceable role="bold">Range Start/Range End</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -688,7 +688,7 @@ R          8385            500                     600                     100
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">Smallest Extent</emphasis>
+                    <replaceable role="bold">Smallest Extent</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -698,7 +698,7 @@ R          8385            500                     600                     100
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">Largest Extent</emphasis>
+                    <replaceable role="bold">Largest Extent</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -708,7 +708,7 @@ R          8385            500                     600                     100
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">Offset</emphasis>
+                    <replaceable role="bold">Offset</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -833,7 +833,7 @@ disk io size               rpcs    %       cum %   |       rpcs    %       cum %
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">pages per brw</emphasis>
+                    <replaceable role="bold">pages per brw</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -843,7 +843,7 @@ disk io size               rpcs    %       cum %   |       rpcs    %       cum %
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">discont pages</emphasis>
+                    <replaceable role="bold">discont pages</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -853,7 +853,7 @@ disk io size               rpcs    %       cum %   |       rpcs    %       cum %
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">discont blocks</emphasis>
+                    <replaceable role="bold">discont blocks</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -892,11 +892,11 @@ disk io size               rpcs    %       cum %   |       rpcs    %       cum %
         <title>31.2.6.1 Tuning File Readahead</title>
         <para>File readahead is triggered when two or more sequential reads by an application fail to be satisfied by the Linux buffer cache. The size of the initial readahead is 1 MB. Additional readaheads grow linearly, and increment until the readahead cache on the client is full at 40 MB.</para>
         <para><literal>
-            <emphasis role="bold">/proc/fs/lustre/llite/&lt;fsname&gt;-&lt;uid&gt;/max_read_ahead_mb</emphasis>
+            <replaceable role="bold">/proc/fs/lustre/llite/&lt;fsname&gt;-&lt;uid&gt;/max_read_ahead_mb</replaceable>
           </literal></para>
         <para>This tunable controls the maximum amount of data readahead on a file. Files are read ahead in RPC-sized chunks (1 MB or the size of read() call, if larger) after the second sequential read on a file descriptor. Random reads are done at the size of the read() call only (no readahead). Reads to non-contiguous regions of the file reset the readahead algorithm, and readahead is not triggered again until there are sequential reads again. To disable readahead, set this tunable to 0. The default value is 40 MB.</para>
         <para><literal>
-            <emphasis role="bold">/proc/fs/lustre/llite/&lt;fsname&gt;-&lt;uid&gt;/max_read_ahead_whole_mb</emphasis>
+            <replaceable role="bold">/proc/fs/lustre/llite/&lt;fsname&gt;-&lt;uid&gt;/max_read_ahead_whole_mb</replaceable>
           </literal></para>
         <para>This tunable controls the maximum size of a file that is read in its entirety, regardless of the size of the <literal>read()</literal>.</para>
       </section>
@@ -904,7 +904,7 @@ disk io size               rpcs    %       cum %   |       rpcs    %       cum %
         <title>31.2.6.2 Tuning Directory Statahead</title>
         <para>When the <literal>ls -l</literal> process opens a directory, its process ID is recorded. When the first directory entry is &apos;&apos;stated&apos;&apos; with this recorded process ID, a statahead thread is triggered which stats ahead all of the directory entries, in order. The <literal>ls -l</literal> process can use the stated directory entries directly, improving performance.</para>
         <para><literal>
-            <emphasis role="bold">/proc/fs/lustre/llite/*/statahead_max</emphasis>
+            <replaceable role="bold">/proc/fs/lustre/llite/*/statahead_max</replaceable>
           </literal></para>
         <para>This tunable controls whether directory <literal>statahead</literal> is enabled and the maximum statahead count. By default, statahead is active.</para>
         <para>To disable statahead, set this tunable to:</para>
@@ -912,11 +912,13 @@ disk io size               rpcs    %       cum %   |       rpcs    %       cum %
         <para>To set the maximum statahead count (n), set this tunable to:</para>
         <screen>echo n &gt; /proc/fs/lustre/llite/*/statahead_max</screen>
         <para>The maximum value of n is 8192.</para>
-        <emphasis role="bold">
+        <para>
           <literal>
-            <para>/proc/fs/lustre/llite/*/statahead_status</para>
+        <replaceable role="bold">
+            /proc/fs/lustre/llite/*/statahead_status
+        </replaceable>
           </literal>
-        </emphasis>
+      </para>
         <para>This is a read-only interface that indicates the current statahead status.</para>
       </section>
     </section>
@@ -1030,7 +1032,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
     <section remap="h3">
       <title>31.2.9 <literal>mballoc</literal> History</title>
       <para><literal>
-          <emphasis role="bold">/proc/fs/ldiskfs/sda/mb_history</emphasis>
+          <replaceable role="bold">/proc/fs/ldiskfs/sda/mb_history</replaceable>
         </literal></para>
       <para>Multi-Block-Allocate (<literal>mballoc</literal>), enables Lustre to ask <literal>ldiskfs</literal> to allocate multiple blocks with a single request to the block allocator. Typically, an <literal>ldiskfs</literal> file system allocates only one block per time. Each <literal>mballoc</literal>-enabled partition has this file. This is sample output:</para>
       <screen>pid  inode   goal            result          found   grps    cr      \   merge   tail    broken
@@ -1230,7 +1232,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">max_to_scan</emphasis>
+                    <replaceable role="bold">max_to_scan</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1240,7 +1242,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">min_to_scan</emphasis>
+                    <replaceable role="bold">min_to_scan</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1250,7 +1252,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">order2_req</emphasis>
+                    <replaceable role="bold">order2_req</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1260,7 +1262,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">stream_req</emphasis>
+                    <replaceable role="bold">stream_req</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1288,9 +1290,9 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
           <tbody>
             <row>
               <entry>
-                <para> <emphasis role="bold">
-                    <literal>stats</literal>
-                  </emphasis></para>
+                <para> <literal>
+                    <replaceable role="bold">stats</replaceable>
+                  </literal></para>
               </entry>
               <entry>
                 <para>Enables/disables the collection of statistics. Collected statistics can be found in <literal>/proc/fs/ldiskfs2/&lt;dev&gt;/mb_history</literal>.</para>
@@ -1299,7 +1301,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">max_to_scan</emphasis>
+                    <replaceable role="bold">max_to_scan</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1309,7 +1311,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">min_to_scan</emphasis>
+                    <replaceable role="bold">min_to_scan</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1319,7 +1321,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">order2_req</emphasis>
+                    <replaceable role="bold">order2_req</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1329,7 +1331,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">small_req</emphasis>
+                    <replaceable role="bold">small_req</replaceable>
                   </literal></para>
               </entry>
               <entry morerows="1">
@@ -1343,14 +1345,14 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">large_req</emphasis>
+                    <replaceable role="bold">large_req</replaceable>
                   </literal></para>
               </entry>
             </row>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">prealloc_table</emphasis>
+                    <replaceable role="bold">prealloc_table</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1360,7 +1362,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <para> <literal>
-                    <emphasis role="bold">group_prealloc</emphasis>
+                    <replaceable role="bold">group_prealloc</replaceable>
                   </literal></para>
               </entry>
               <entry>
@@ -1374,7 +1376,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
     <section remap="h3">
       <title>31.2.11 Locking</title>
       <para><literal>
-          <emphasis role="bold">/proc/fs/lustre/ldlm/ldlm/namespaces/&lt;OSC name|MDC name&gt;/lru_size</emphasis>
+          <replaceable role="bold">/proc/fs/lustre/ldlm/ldlm/namespaces/&lt;OSC name|MDC name&gt;/lru_size</replaceable>
         </literal></para>
       <para>The <literal>lru_size</literal> parameter is used to control the number of client-side locks in an LRU queue. LRU size is dynamic, based on load. This optimizes the number of locks available to nodes that have different workloads (e.g., login/build nodes vs. compute nodes vs. backup nodes).</para>
       <para>The total number of locks available is a function of the server&apos;s RAM. The default limit is 50 locks/1 MB of RAM. If there is too much memory pressure, then the LRU size is shrunk. The number of locks on the server is limited to {number of OST/MDT on node} * {number of clients} * {client lru_size}.</para>
@@ -1417,7 +1419,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> mdt.MDS.mds</para>
+                   mdt.MDS.mds
                 </literal>
               </entry>
               <entry>
@@ -1427,7 +1429,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> mdt.MDS.mds_readpage</para>
+                   mdt.MDS.mds_readpage
                 </literal>
               </entry>
               <entry>
@@ -1437,7 +1439,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> mdt.MDS.mds_setattr</para>
+                   mdt.MDS.mds_setattr
                 </literal>
               </entry>
               <entry>
@@ -1447,7 +1449,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> ost.OSS.ost</para>
+                   ost.OSS.ost
                 </literal>
               </entry>
               <entry>
@@ -1457,7 +1459,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> ost.OSS.ost_io</para>
+                   ost.OSS.ost_io
                 </literal>
               </entry>
               <entry>
@@ -1467,7 +1469,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> ost.OSS.ost_create</para>
+                   ost.OSS.ost_create
                 </literal>
               </entry>
               <entry>
@@ -1477,7 +1479,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> ldlm.services.ldlm_canceld</para>
+                   ldlm.services.ldlm_canceld
                 </literal>
               </entry>
               <entry>
@@ -1487,7 +1489,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
             <row>
               <entry>
                 <literal>
-                  <para> ldlm.services.ldlm_cbd</para>
+                   ldlm.services.ldlm_cbd
                 </literal>
               </entry>
               <entry>
@@ -1550,7 +1552,7 @@ obdfilter.lol-OST0001.sync_on_lock_cancel=never</screen>
   <section xml:id="dbdoclet.50438271_83523">
     <title>31.3 Debug</title>
     <para><literal>
-        <emphasis role="bold">/proc/sys/lnet/debug</emphasis>
+        <replaceable role="bold">/proc/sys/lnet/debug</replaceable>
       </literal></para>
     <para>By default, Lustre generates a detailed log of all operations to aid in debugging. The level of debugging can affect the performance or speed you achieve with Lustre. Therefore, it is useful to reduce this overhead by turning down the debug level<footnote>
         <para>This controls the level of Lustre debugging kept in the internal log buffer. It does not alter the level of debugging that goes to syslog.</para>
@@ -1594,11 +1596,11 @@ neterror warning ha
 # cat /proc/sys/lnet/debug 
 neterror ha</screen>
     <para><literal>
-        <emphasis role="bold">/proc/sys/lnet/subsystem_debug</emphasis>
+        <replaceable role="bold">/proc/sys/lnet/subsystem_debug</replaceable>
       </literal></para>
     <para>This controls the debug logs for subsystems (see <literal>S_*</literal> definitions).</para>
     <para><literal>
-        <emphasis role="bold">/proc/sys/lnet/debug_path</emphasis>
+        <replaceable role="bold">/proc/sys/lnet/debug_path</replaceable>
       </literal></para>
     <para>This indicates the location where debugging symbols should be stored for <literal>gdb</literal>. The default is set to <literal>/r/tmp/lustre-log-localhost.localdomain</literal>.</para>
     <para>These values can also be set via <literal>sysctl -w lnet.debug={value}</literal></para>
@@ -1606,11 +1608,11 @@ neterror ha</screen>
       <para>The above entries only exist when Lustre has already been loaded.</para>
     </note>
     <para><literal>
-        <emphasis role="bold">/proc/sys/lnet/panic_on_lbug</emphasis>
+        <replaceable role="bold">/proc/sys/lnet/panic_on_lbug</replaceable>
       </literal></para>
     <para>This causes Lustre to call &apos;&apos;panic&apos;&apos; when it detects an internal problem (an <literal>LBUG</literal>); panic crashes the node. This is particularly useful when a kernel crash dump utility is configured. The crash dump is triggered when the internal inconsistency is detected by Lustre.</para>
     <para><literal>
-        <emphasis role="bold">/proc/sys/lnet/upcall</emphasis>
+        <replaceable role="bold">/proc/sys/lnet/upcall</replaceable>
       </literal></para>
     <para>This allows you to specify the path to the binary which will be invoked when an <literal>LBUG</literal> is encountered. This binary is called with four parameters. The first one is the string &apos;&apos;<literal>LBUG</literal>&apos;&apos;. The second one is the file where the <literal>LBUG</literal> occurred. The third one is the function name. The fourth one is the line number in the file.</para>
     <section remap="h3">
@@ -1694,7 +1696,7 @@ ost_write  21              2               59      [bytes]         7648424\    1
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">Cur. Count</emphasis>
+                      <replaceable role="bold">Cur. Count</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -1704,7 +1706,7 @@ ost_write  21              2               59      [bytes]         7648424\    1
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">Cur. Rate</emphasis>
+                      <replaceable role="bold">Cur. Rate</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -1714,7 +1716,7 @@ ost_write  21              2               59      [bytes]         7648424\    1
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">#Events</emphasis>
+                      <replaceable role="bold">#Events</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -1723,9 +1725,9 @@ ost_write  21              2               59      [bytes]         7648424\    1
               </row>
               <row>
                 <entry>
-                  <para> <emphasis role="bold">
-                      <literal>Unit</literal>
-                    </emphasis></para>
+                  <para> <literal>
+                      <replaceable role="bold">Unit</replaceable>
+                    </literal></para>
                 </entry>
                 <entry>
                   <para>Unit of measurement for that statistic (microseconds, requests, buffers)</para>
@@ -1733,9 +1735,9 @@ ost_write  21              2               59      [bytes]         7648424\    1
               </row>
               <row>
                 <entry>
-                  <para> <emphasis role="bold">
-                      <literal>last</literal>
-                    </emphasis></para>
+                  <para> <literal>
+                      <replaceable role="bold">last</replaceable>
+                    </literal></para>
                 </entry>
                 <entry>
                   <para>Average rate of these events (in units/event) for the last interval during which they arrived. For instance, in the above mentioned case of <literal>ost_destroy</literal> it took an average of 736 microseconds per destroy for the 400 object destroys in the previous 10 seconds.</para>
@@ -1743,9 +1745,9 @@ ost_write  21              2               59      [bytes]         7648424\    1
               </row>
               <row>
                 <entry>
-                  <para> <emphasis role="bold">
-                      <literal>min</literal>
-                    </emphasis></para>
+                  <para> <literal>
+                      <replaceable role="bold">min</replaceable>
+                    </literal></para>
                 </entry>
                 <entry>
                   <para>Minimum rate (in units/events) since the service started</para>
@@ -1753,9 +1755,9 @@ ost_write  21              2               59      [bytes]         7648424\    1
               </row>
               <row>
                 <entry>
-                  <para> <emphasis role="bold">
-                      <literal>avg</literal>
-                    </emphasis></para>
+                  <para> <literal>
+                      <replaceable role="bold">avg</replaceable>
+                    </literal></para>
                 </entry>
                 <entry>
                   <para>Average rate</para>
@@ -1763,9 +1765,9 @@ ost_write  21              2               59      [bytes]         7648424\    1
               </row>
               <row>
                 <entry>
-                  <para> <emphasis role="bold">
-                      <literal>max</literal>
-                    </emphasis></para>
+                  <para> <literal>
+                      <replaceable role="bold">max</replaceable>
+                    </literal></para>
                 </entry>
                 <entry>
                   <para>Maximum rate</para>
@@ -1773,9 +1775,9 @@ ost_write  21              2               59      [bytes]         7648424\    1
               </row>
               <row>
                 <entry>
-                  <para> <emphasis role="bold">
-                      <literal>stddev</literal>
-                    </emphasis></para>
+                  <para> <literal>
+                      <replaceable role="bold">stddev</replaceable>
+                    </literal></para>
                 </entry>
                 <entry>
                   <para>Standard deviation (not measured in all cases)</para>
@@ -1803,7 +1805,7 @@ ost_write  21              2               59      [bytes]         7648424\    1
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">req_waittime</emphasis>
+                      <replaceable role="bold">req_waittime</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -1813,7 +1815,7 @@ ost_write  21              2               59      [bytes]         7648424\    1
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">req<literal>_</literal>qdepth</emphasis>
+                      <replaceable role="bold">req<literal>_</literal>qdepth</replaceable>
                     </literal></para>
                 </entry>
                 <entry>
@@ -1823,7 +1825,7 @@ ost_write  21              2               59      [bytes]         7648424\    1
               <row>
                 <entry>
                   <para> <literal>
-                      <emphasis role="bold">req_active</emphasis>
+                      <replaceable role="bold">req_active</replaceable>
                     </literal></para>
                 </entry>
                 <entry>