docs/88429: FAQ 10.9. Quotas Improvement

[Alex Kelly]

The following reply was made to PR docs/88429; it has been noted by GNATS.

From: Alex Kelly <aekelly at gmail.com>
To: bug-followup at FreeBSD.org
Cc:  
Subject: Re: docs/88429: FAQ 10.9. Quotas Improvement
Date: Wed, 9 Nov 2005 10:50:51 -0500

 Followup and possible patch for 88429:
 
 --- book.sgml=09Wed Nov  9 10:39:46 2005
 +++ book.sgml.old=09Wed Nov  9 10:39:39 2005
 @@ -6105,31 +6105,47 @@
          </question>
 
          <answer>
 -         <para>It is possible that your kernel is not configured to use
 -           quotas. If this is the case, you will need to add the following
 -           line to your kernel configuration file and recompile:</para>
 -
 -           <programlisting>options QUOTA</programlisting>
 -
 -         <para>It is also possible that quotas are not enabled in the
 -           <filename>rc.conf</filename> file in <filename>/etc</filename>.
 -           If this is the case, you will need to add the following line to
 -           <filename>rc.conf</filename>:</para>
 -
 -           <programlisting>enable_quotas=3D"YES"</programlisting>
 -
 -         <para>It is also possible that the quota file is improperly place=
 d in
 -           <filename>/</filename>, the root directory of &os. The quota fi=
 le
 -           should instead be placed on the filesystem where quotas are to =
 be
 -           enforced, i.e.</para>
 -
 -            <filename>/usr                         /usr/admin/quotas</file=
 name>
 -            <filename>/home                      =20
 /home/admin/quotas</filename>
 -
 -         <para>For more information on quotas, please refer to
 -           <ulink
 url=3D"http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/quotas.htm=
 l">
 -           Chapter 8</ulink> of the &os Handbook.</para>
 -
 +            <!-- XXX
 +              This may be the worst answer in the entire document.
 +            -->
 +            <orderedlist>
 +              <listitem>
 +                <para>Do not turn on quotas on <filename>/</filename>.</pa=
 ra>
 +              </listitem>
 +
 +              <listitem>
 +                <para>Put the quota file on the filesystem that the quotas
 +                  are to be enforced on, i.e.:</para>
 +
 +                <informaltable frame=3D"none" pgwide=3D"1">
 +                  <tgroup cols=3D"2">
 +                    <thead>
 +                      <row>
 +                        <entry>Filesystem</entry>
 +                        <entry>Quota file</entry>
 +                      </row>
 +                    </thead>
 +
 +                    <tbody>
 +                      <row>
 +                        <entry><filename>/usr</filename></entry>
 +                        <entry><filename>/usr/admin/quotas</filename></ent=
 ry>
 +                      </row>
 +
 +                      <row>
 +                        <entry><filename>/home</filename></entry>
 +                        <entry><filename>/home/admin/quotas</filename></en=
 try>
 +                      </row>
 +
 +                      <row>
 +                        <entry>…</entry>
 +                        <entry>…</entry>
 +                      </row>
 +                    </tbody>
 +                  </tgroup>
 +                </informaltable>
 +              </listitem>
 +            </orderedlist>
          </answer>
        </qandaentry>