From 4501caae45aa88d3a49806df0ac5272f95ec6d82 Mon Sep 17 00:00:00 2001
From: Emoly Liu <emoly.liu@intel.com>
Date: Wed, 18 Sep 2013 16:57:10 +0800
Subject: [PATCH] LUDOC-11 proc: correct some errors in Chapter 31.9

This patch includes the following changes:
1) correct some proc parameter name erros
2) correct "lctl conf_param" description and add
   "lctl set_param -P" usage.

Signed-off-by: Emoly Liu <emoly.liu@intel.com>
Change-Id: I9e972558c389fa537b8d3cd59f6b9fc873fbcd91
Reviewed-on: http://review.whamcloud.com/7628
Tested-by: Hudson
Reviewed-by: Linda Bebernes <linda.bebernes@intel.com>
Reviewed-by: Richard Henwood <richard.henwood@intel.com>
---
 LustreProc.xml | 37 ++++++++++++++++++++++++++-----------
 1 file changed, 26 insertions(+), 11 deletions(-)

diff --git a/LustreProc.xml b/LustreProc.xml
index 6b29a57..d41b089 100644
--- a/LustreProc.xml
+++ b/LustreProc.xml
@@ -2078,7 +2078,7 @@ nid                    refs   peer    max   tx    min
           </row>
           <row>
             <entry>
-              <literal> mdt.MDS.mds </literal>
+              <literal> mds.MDS.mdt </literal>
             </entry>
             <entry>
               <para>Main metadata operations service</para>
@@ -2086,7 +2086,7 @@ nid                    refs   peer    max   tx    min
           </row>
           <row>
             <entry>
-              <literal> mdt.MDS.mds_readpage </literal>
+              <literal> mds.MDS.mdt_readpage </literal>
             </entry>
             <entry>
               <para>Metadata <literal>readdir</literal> service</para>
@@ -2094,7 +2094,7 @@ nid                    refs   peer    max   tx    min
           </row>
           <row>
             <entry>
-              <literal> mdt.MDS.mds_setattr </literal>
+              <literal> mds.MDS.mdt_setattr </literal>
             </entry>
             <entry>
               <para>Metadata <literal>setattr/close</literal> operations service </para>
@@ -2144,14 +2144,22 @@ nid                    refs   peer    max   tx    min
       </tgroup>
     </informaltable>
     <para>For each service, an entry as shown below is
-      created:<screen>/proc/fs/lustre/<replaceable>{service}</replaceable>/*/thread_<replaceable>{min,max,started}</replaceable></screen></para>
-    <para>To temporarily set this tunable, run:</para>
-    <screen># lctl <replaceable>{get,set}</replaceable>_param <replaceable>{service}</replaceable>.thread_<replaceable>{min,max,started}</replaceable> </screen>
-    <para>To permanently set this tunable, run:</para>
-    <screen># lctl conf_param <replaceable>{service}</replaceable>.thread_<replaceable>{min,max,started}</replaceable> </screen>
-    <para>The following examples show how to set thread counts and get the number of running threads
-      for the service <literal>ost_io</literal>  using the tunable
-        <literal>{service}.thread_{min,max,started}</literal>.</para>
+      created:<screen>/proc/fs/lustre/<replaceable>service</replaceable>/*/threads_<replaceable>min|max|started</replaceable></screen></para>
+    <itemizedlist>
+      <listitem>
+        <para>To temporarily set this tunable, run:</para>
+        <screen># lctl <replaceable>get|set</replaceable>_param <replaceable>service</replaceable>.threads_<replaceable>min|max|started</replaceable> </screen>
+	</listitem>
+      <listitem>
+        <para>To permanently set this tunable, run:</para>
+	<screen># lctl conf_param <replaceable>obdname|fsname.obdtype</replaceable>.threads_<replaceable>min|max|started</replaceable> </screen>
+	<para condition='l25'>For version 2.5 or later, run:
+		<screen># lctl set_param -P <replaceable>service</replaceable>.threads_<replaceable>min|max|started</replaceable></screen></para>
+      </listitem>
+    </itemizedlist>
+      <para>The following examples show how to set thread counts and get the number of running threads
+        for the service <literal>ost_io</literal>  using the tunable
+	<literal><replaceable>service</replaceable>.threads_<replaceable>min|max|started</replaceable></literal>.</para>
     <itemizedlist>
       <listitem>
         <para>To get the number of running threads, run:</para>
@@ -2170,6 +2178,13 @@ ost.OSS.ost_io.threads_max=512</screen>
 ost.OSS.ost_io.threads_max=256</screen>
       </listitem>
       <listitem>
+        <para>To set the maximum thread count to 256 instead of 512 permanently, run:</para>
+        <screen># lctl conf_param testfs.ost.ost_io.threads_max=256</screen>
+	<para condition='l25'>For version 2.5 or later, run:
+	<screen># lctl set_param -P ost.OSS.ost_io.threads_max=256
+ost.OSS.ost_io.threads_max=256 </screen> </para>
+      </listitem>
+      <listitem>
         <para> To check if the <literal>threads_max</literal> setting is active, run:</para>
         <screen># lctl get_param ost.OSS.ost_io.threads_max
 ost.OSS.ost_io.threads_max=256</screen>
-- 
1.8.3.1