From nobody@FreeBSD.org  Thu Nov  3 02:53:06 2005
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6555E16A41F
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  3 Nov 2005 02:53:06 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 37CD043D48
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  3 Nov 2005 02:53:06 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id jA32r6B3071154
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 3 Nov 2005 02:53:06 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id jA32r5nD071153;
	Thu, 3 Nov 2005 02:53:05 GMT
	(envelope-from nobody)
Message-Id: <200511030253.jA32r5nD071153@www.freebsd.org>
Date: Thu, 3 Nov 2005 02:53:05 GMT
From: Alex Kelly <aekelly@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: FAQ 10.9. Quotas Improvement
X-Send-Pr-Version: www-2.3

>Number:         88429
>Category:       docs
>Synopsis:       [patch] FAQ: 10.9. Quotas Improvement
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jcamou
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 03 03:00:36 GMT 2005
>Closed-Date:    Thu Feb 16 14:28:40 GMT 2006
>Last-Modified:  Thu Feb 16 14:28:40 GMT 2006
>Originator:     Alex Kelly
>Release:        5.4-RELEASE
>Organization:
>Environment:
>Description:
             The stock GENERIC kernel does not have quotas enabled by default. An admin would need to add support for quotas to the kernel first before the other possible reasons for why the quotas are not working would apply.
>How-To-Repeat:
              
>Fix:
              Add the statement:

Before attempting to use disk quotas, it is necessary to make sure that quotas are configured in your kernel. This is done by adding the following line to your kernel configuration file:

options QUOTA

Also, you will need to enable disk quotas in /etc/rc.conf. This is done by adding the line:

enable_quotas="YES"
>Release-Note:
>Audit-Trail:

From: Alex Kelly <aekelly@gmail.com>
To: bug-followup@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>&hellip;</entry>
 +                        <entry>&hellip;</entry>
 +                      </row>
 +                    </tbody>
 +                  </tgroup>
 +                </informaltable>
 +              </listitem>
 +            </orderedlist>
          </answer>
        </qandaentry>
Responsible-Changed-From-To: freebsd-doc->jcamou  
Responsible-Changed-By: jcamou 
Responsible-Changed-When: Mon Nov 14 10:54:43 GMT 2005 
Responsible-Changed-Why:  
Set me as responsible for this pr.  

http://www.freebsd.org/cgi/query-pr.cgi?pr=88429 

From: "Jesus R. Camou" <jcamou@FreeBSD.org>
To: Alex Kelly <aekelly@gmail.com>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/88429: FAQ 10.9. Quotas Improvement
Date: Wed, 23 Nov 2005 15:26:55 -0800

 On Thu, Nov 10, 2005 at 05:50:16PM +0000, Alex Kelly wrote:
 > The following reply was made to PR docs/88429; it has been noted by GNATS.
 > 
 > From: Alex Kelly <aekelly@gmail.com>
 > To: bug-followup@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:
 
 Could you please send me the patch attatched?
 
 Thanks!
 
 -- 
 Jesus R. Camou - jcamou@FreeBSD.org
 

From: "Jesus R. Camou" <jcamou@FreeBSD.org>
To: Alex Kelly <aekelly@gmail.com>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/88429: FAQ 10.9. Quotas Improvement
Date: Wed, 23 Nov 2005 15:37:06 -0800

 On Thu, Nov 10, 2005 at 05:50:16PM +0000, Alex Kelly wrote:
 > The following reply was made to PR docs/88429; it has been noted by GNATS.
 > 
 > From: Alex Kelly <aekelly@gmail.com>
 > To: bug-followup@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>&hellip;</entry>
 >  +                        <entry>&hellip;</entry>
 >  +                      </row>
 >  +                    </tbody>
 >  +                  </tgroup>
 >  +                </informaltable>
 >  +              </listitem>
 >  +            </orderedlist>
 >           </answer>
 >         </qandaentry>
 
 I don't think this would be the correct patch to document the fact that
 in order to use quotas it is necessary to enable it in the kernel.
 
 Maybe you sent a wrong patch?
 
 -- 
 Jesus R. Camou - jcamou@FreeBSD.org
 

From: Alex Kelly <aekelly@gmail.com>
To: jcamou@freebsd.org
Cc: bug-followup@freebsd.org
Subject: Re: docs/88429: FAQ 10.9. Quotas Improvement
Date: Thu, 24 Nov 2005 11:59:25 -0500

 ------=_Part_11667_14801263.1132851565895
 Content-Type: text/plain; charset=ISO-8859-1
 Content-Transfer-Encoding: quoted-printable
 Content-Disposition: inline
 
 The patch is a re-write of all of FAQ 10.9.
 
 However, here is a smaller patch which only adds the paragraph
 enabling quotas in the kernel.
 
 On 11/23/05, Jesus R. Camou <jcamou@freebsd.org> wrote:
 > On Thu, Nov 10, 2005 at 05:50:16PM +0000, Alex Kelly wrote:
 > > The following reply was made to PR docs/88429; it has been noted by GNA=
 TS.
 > >
 > > From: Alex Kelly <aekelly@gmail.com>
 > > To: bug-followup@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=3D09Wed Nov  9 10:39:46 2005
 > >  +++ book.sgml.old=3D09Wed Nov  9 10:39:39 2005
 > >  @@ -6105,31 +6105,47 @@
 > >           </question>
 > >
 > >           <answer>
 > >  -         <para>It is possible that your kernel is not configured to u=
 se
 > >  -           quotas. If this is the case, you will need to add the foll=
 owing
 > >  -           line to your kernel configuration file and recompile:</par=
 a>
 > >  -
 > >  -           <programlisting>options QUOTA</programlisting>
 > >  -
 > >  -         <para>It is also possible that quotas are not enabled in the
 > >  -           <filename>rc.conf</filename> file in <filename>/etc</filen=
 ame>.
 > >  -           If this is the case, you will need to add the following li=
 ne to
 > >  -           <filename>rc.conf</filename>:</para>
 > >  -
 > >  -           <programlisting>enable_quotas=3D3D"YES"</programlisting>
 > >  -
 > >  -         <para>It is also possible that the quota file is improperly =
 place=3D
 > >  d in
 > >  -           <filename>/</filename>, the root directory of &os. The quo=
 ta fi=3D
 > >  le
 > >  -           should instead be placed on the filesystem where quotas ar=
 e to =3D
 > >  be
 > >  -           enforced, i.e.</para>
 > >  -
 > >  -            <filename>/usr                         /usr/admin/quotas<=
 /file=3D
 > >  name>
 > >  -            <filename>/home                      =3D20
 > >  /home/admin/quotas</filename>
 > >  -
 > >  -         <para>For more information on quotas, please refer to
 > >  -           <ulink
 > >  url=3D3D"http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/quo=
 tas.htm=3D
 > >  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=3D
 > >  ra>
 > >  +              </listitem>
 > >  +
 > >  +              <listitem>
 > >  +                <para>Put the quota file on the filesystem that the q=
 uotas
 > >  +                  are to be enforced on, i.e.:</para>
 > >  +
 > >  +                <informaltable frame=3D3D"none" pgwide=3D3D"1">
 > >  +                  <tgroup cols=3D3D"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=3D
 > >  ry>
 > >  +                      </row>
 > >  +
 > >  +                      <row>
 > >  +                        <entry><filename>/home</filename></entry>
 > >  +                        <entry><filename>/home/admin/quotas</filename=
 ></en=3D
 > >  try>
 > >  +                      </row>
 > >  +
 > >  +                      <row>
 > >  +                        <entry>&hellip;</entry>
 > >  +                        <entry>&hellip;</entry>
 > >  +                      </row>
 > >  +                    </tbody>
 > >  +                  </tgroup>
 > >  +                </informaltable>
 > >  +              </listitem>
 > >  +            </orderedlist>
 > >           </answer>
 > >         </qandaentry>
 >
 > I don't think this would be the correct patch to document the fact that
 > in order to use quotas it is necessary to enable it in the kernel.
 >
 > Maybe you sent a wrong patch?
 >
 > --
 > Jesus R. Camou - jcamou@FreeBSD.org
 >
 >
 
 ------=_Part_11667_14801263.1132851565895
 Content-Type: application/octet-stream; name=book.diff
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment; filename="book.diff"
 
 --- book.sgml.old	Thu Nov 24 11:45:10 2005
 +++ book.sgml	Thu Nov 24 11:50:53 2005
 @@ -6110,6 +6110,13 @@
              -->
              <orderedlist>
                <listitem>
 +                <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>
 +              </listitem>
 +
 +              <listitem>
                  <para>Do not turn on quotas on <filename>/</filename>.</para>
                </listitem>
  
 
 ------=_Part_11667_14801263.1132851565895--
State-Changed-From-To: open->closed  
State-Changed-By: jcamou 
State-Changed-When: Thu Feb 16 14:28:13 UTC 2006 
State-Changed-Why:  
Patch committed with some additions.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88429 
>Unformatted:
