From: Vikentsi Lapa <vlapa@whamcloud.com>
Date: Mon, 20 Jul 2020 12:23:07 +0000 (+0000)
Subject: LUDOC-475 quota: notes about lfs commands
X-Git-Url: https://git.whamcloud.com/?p=doc%2Fmanual.git;a=commitdiff_plain;h=968aeb8d2bb561cf3330980a2429bf1a169755d7;hp=25106a04c49c4acef6322b68ce22217fac9e523c

LUDOC-475 quota: notes about lfs commands

Update documentation according to changes in LU-1842.
Remove lsf commands quotachown, quotainv.
Update documentation according to changes in LU-5975.
Remove lsf commands quotacheck, quotaon, quotaoff.

Signed-off-by: Vikentsi Lapa <vlapa@whamcloud.com>
Change-Id: If0b823cf436a8154588ff2056a50fbdb247ad977
Reviewed-on: https://review.whamcloud.com/39451
Tested-by: jenkins <devops@whamcloud.com>
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
---

diff --git a/SettingLustreProperties.xml b/SettingLustreProperties.xml
index 8d2f714..567aedc 100644
--- a/SettingLustreProperties.xml
+++ b/SettingLustreProperties.xml
@@ -749,14 +749,6 @@ struct obd_uuid {
             </row>
             <row>
               <entry>
-                <para> <literal>EBUSY</literal></para>
-              </entry>
-              <entry>
-                <para>Cannot process during quotacheck.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
                 <para> <literal>ENOENT</literal></para>
               </entry>
               <entry>
diff --git a/UserUtilities.xml b/UserUtilities.xml
index 5c7684b..a07ec54 100644
--- a/UserUtilities.xml
+++ b/UserUtilities.xml
@@ -50,11 +50,6 @@ lfs pool_list <replaceable>filesystem</replaceable>[.<replaceable>pool</replacea
 lfs quota [-q] [-v] [-h] [-o <replaceable>obd_uuid</replaceable>|-I <replaceable>ost_idx</replaceable>|-i <replaceable>mdt_idx</replaceable>]
           [-u <replaceable>username|uid|-g</replaceable> <replaceable>group|gid</replaceable>|-p <replaceable>projid</replaceable>] <replaceable>/mount_point</replaceable>
 lfs quota -t -u|-g|-p <replaceable>/mount_point</replaceable>
-lfs quotacheck [-ug] <replaceable>/mount_point</replaceable>
-lfs quotachown [-i] <replaceable>/mount_point</replaceable>
-lfs quotainv [-ug] [-f] <replaceable>/mount_point</replaceable>
-lfs quotaon [-ugf] <replaceable>/mount_point</replaceable>
-lfs quotaoff [-ug] <replaceable>/mount_point</replaceable>
 lfs setquota {-u|--user|-g|--group|-p|--project} <replaceable>uname|uid|gname|gid|projid</replaceable>
              [--block-softlimit <replaceable>block_softlimit</replaceable>]
              [--block-hardlimit <replaceable>block_hardlimit</replaceable>]
@@ -90,6 +85,12 @@ lfs help
         <literal>-v</literal> option with 
         <literal>lfs quota</literal>.</para>
       </note>
+      <para condition="l24">
+       The <literal>quotacheck</literal>, <literal>quotaon</literal> and <literal>quotaoff</literal>
+       sub-commands were deprecated in the Lustre 2.4 release, and removed completely in
+       the Lustre 2.8 release.  See <xref linkend="enabling_disk_quotas"/> for details on
+       configuring and checking quotas.
+      </para>
     </section>
     <section remap="h5">
       <title>Description</title>
@@ -824,85 +825,6 @@ lfs help
             <row>
               <entry nameend="c2" namest="c1">
                 <para>
-                  <literal>quotachown</literal>
-                </para>
-              </entry>
-              <entry>
-                <para>Changes the file's owner and group on OSTs of the
-                specified file system.</para>
-              </entry>
-            </row>
-            <row>
-              <entry nameend="c2" namest="c1">
-                <para>
-                  <literal>quotacheck [-ugf] 
-                  <replaceable>/mount_point</replaceable></literal>
-                </para>
-              </entry>
-              <entry>
-                <para>Scans the specified file system for disk usage, and
-                creates or updates quota files. Options specify quota for users
-                (
-                <literal>-u</literal>), groups (
-                <literal>-g</literal>), and force (
-                <literal>-f</literal>).</para>
-              </entry>
-            </row>
-            <row>
-              <entry nameend="c2" namest="c1">
-                <para>
-                  <literal>quotaon [-ugf] 
-                  <replaceable>/mount_point</replaceable></literal>
-                </para>
-              </entry>
-              <entry>
-                <para>Turns on file system quotas. Options specify quota for
-                users (
-                <literal>-u</literal>), groups (
-                <literal>-g</literal>), and force (
-                <literal>-f</literal>).</para>
-              </entry>
-            </row>
-            <row>
-              <entry nameend="c2" namest="c1">
-                <para>
-                  <literal>quotaoff [-ugf] 
-                  <replaceable>/mount_point</replaceable></literal>
-                </para>
-              </entry>
-              <entry>
-                <para>Turns off file system quotas. Options specify quota for
-                users (
-                <literal>-u</literal>), groups (
-                <literal>-g</literal>), and force (
-                <literal>-f</literal>).</para>
-              </entry>
-            </row>
-            <row>
-              <entry nameend="c2" namest="c1">
-                <para>
-                  <literal>quotainv [-ug] [-f] 
-                  <replaceable>/mount_point</replaceable></literal>
-                </para>
-              </entry>
-              <entry>
-                <para>Clears quota files (administrative quota files if used
-                without 
-                <literal>-f</literal>, operational quota files otherwise), all
-                of their quota entries for users (
-                <literal>-u</literal>) or groups (
-                <literal>-g</literal>). After running 
-                <literal>quotainv</literal>, you must run 
-                <literal>quotacheck</literal> before using quotas.</para>
-                <caution>
-                  <para>Use extreme caution when using this command; its
-                  results cannot be undone.</para>
-                </caution>
-              </entry>
-            </row>
-            <row>
-              <entry nameend="c2" namest="c1">
-                <para>
                   <literal>setquota {-u|-g|-p
                   <replaceable>uname|uid|gname|gid|projid}</replaceable>
                   [--block-softlimit
@@ -1049,23 +971,6 @@ $ lfs quota -p 1 /mnt/lustre
       <screen>
 $ lfs quota -t -u /mnt/lustre
 </screen>
-      <para>Changes file owner and group.</para>
-      <screen>
-$ lfs quotachown -i /mnt/lustre
-</screen>
-      <para>Checks quotas for user and group. Turns on quotas after making the
-      check.</para>
-      <screen>
-$ lfs quotacheck -ug /mnt/lustre
-</screen>
-      <para>Turns on quotas of user and group.</para>
-      <screen>
-$ lfs quotaon -ug /mnt/lustre
-</screen>
-      <para>Turns off quotas of user and group.</para>
-      <screen>
-$ lfs quotaoff -ug /mnt/lustre
-</screen>
       <para>Sets quotas of user 'bob', with a 1 GB block quota hardlimit and a
       2 GB block quota softlimit.</para>
       <screen>
diff --git a/style/customstyle_fo.xsl b/style/customstyle_fo.xsl
index 52e546e..a689a92 100644
--- a/style/customstyle_fo.xsl
+++ b/style/customstyle_fo.xsl
@@ -146,6 +146,7 @@
     </xsl:variable>
 	<xsl:variable name="versionstr">
 		<xsl:choose>
+			<xsl:when test="@condition = 'l24'">Introduced in Lustre 2.4</xsl:when>
 			<xsl:when test="@condition = 'l25'">Introduced in Lustre 2.5</xsl:when>
 			<xsl:when test="@condition = 'l26'">Introduced in Lustre 2.6</xsl:when>
 			<xsl:when test="@condition = 'l27'">Introduced in Lustre 2.7</xsl:when>