From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from cuda.sgi.com (cuda3.sgi.com [192.48.176.15]) by oss.sgi.com (8.14.3/8.14.3/SuSE Linux 0.8) with ESMTP id n2L4GnqA217716 for ; Fri, 20 Mar 2009 23:17:10 -0500 Received: from mx2.redhat.com (localhost [127.0.0.1]) by cuda.sgi.com (Spam Firewall) with ESMTP id 1383E1C5CAA7 for ; Fri, 20 Mar 2009 21:16:30 -0700 (PDT) Received: from mx2.redhat.com (mx2.redhat.com [66.187.237.31]) by cuda.sgi.com with ESMTP id uxzrCtcQoDbzqdI2 for ; Fri, 20 Mar 2009 21:16:30 -0700 (PDT) Message-ID: <49C46A14.8000602@sandeen.net> Date: Fri, 20 Mar 2009 23:16:20 -0500 From: Eric Sandeen MIME-Version: 1.0 Subject: Re: [PATCH] xfsprogs: add projects(5) and projid(5) manpages References: <20090224132737.GA8161@infradead.org> <20090304173224.GB32471@infradead.org> In-Reply-To: <20090304173224.GB32471@infradead.org> List-Id: XFS Filesystem from SGI List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: xfs-bounces@oss.sgi.com Errors-To: xfs-bounces@oss.sgi.com To: Christoph Hellwig Cc: xfs@oss.sgi.com Christoph Hellwig wrote: > On Tue, Feb 24, 2009 at 08:27:37AM -0500, Christoph Hellwig wrote: >> Document the /etc/projects and /etc/projid files in their own manpages >> instead of in xfs_quota(8). > > Doh, I forgot to quilt add projects.5, here's the complete patch: Looks fine. Reviewed-by: Eric Sandeen > Index: xfsprogs-dev/man/man5/projid.5 > =================================================================== > --- /dev/null 1970-01-01 00:00:00.000000000 +0000 > +++ xfsprogs-dev/man/man5/projid.5 2009-03-04 18:30:40.451978384 +0100 > @@ -0,0 +1,29 @@ > +.TH projid 5 > +.SH NAME > +projid \- the project name mapping file > +.SH DESCRIPTION > +The > +.I /etc/projid > +file provides a mapping between numeric project identifiers and a > +simple human readable name (similar relationship to the one that > +exists between usernames and uids). > +Its format is simply: > +.nf > +.sp > +.in +5 > +# comments are hash-prefixed > +# ... > +cage:10 > +logfiles:42 > + > +.in -5 > +.fi > +.PP > + > +This file is optional, if a project identifier cannot be mapped to > +a name, it will be parsed and displayed as a numeric value. > + > +.SH SEE ALSO > +.BR xfs_quota (8), > +.BR xfsctl (3), > +.BR projects (5). > Index: xfsprogs-dev/man/man8/xfs_quota.8 > =================================================================== > --- xfsprogs-dev.orig/man/man8/xfs_quota.8 2009-03-03 16:45:43.355881326 +0100 > +++ xfsprogs-dev/man/man8/xfs_quota.8 2009-03-04 18:30:40.452978791 +0100 > @@ -628,46 +628,6 @@ for > .I /etc/projects > to exist. Note that if projects file exists then it is also used. > > -.SH FILE FORMATS > -There are two files involved with the tree quota mechanism, namely > -.I /etc/projects > -and > -.IR /etc/projid . > -The latter is optional. > -The > -.I /etc/projects > -file provides a mapping between numeric project identifiers and those > -directories which are the roots of the quota tree. > -Its format is simply: > -.nf > -.sp > -.in +5 > -# comments are hash-prefixed > -# ... > -10:/export/cage > -42:/var/log > -.in -5 > -.fi > -.PP > -The > -.I /etc/projid > -file provides a mapping between numeric project identifiers and a > -simple human readable name (similar relationship to the one that > -exists between usernames and uids). > -Its format is simply: > -.nf > -.sp > -.in +5 > -# comments are hash-prefixed > -# ... > -cage:10 > -logfiles:42 > -.in -5 > -.fi > -.PP > -This file is optional, if a project identifier cannot be mapped to > -a name, it will be displayed as a number only. > -.PP > .SH EXAMPLES > Enabling quota enforcement on an XFS filesystem (restrict a user > to a set amount of space). > @@ -752,4 +712,6 @@ Mapping of numeric project identifiers t > .SH SEE ALSO > .BR df (1), > .BR mount (1), > -.BR sync (2). > +.BR sync (2), > +.BR projid (5), > +.BR projects (5). > Index: xfsprogs-dev/man/man5/projects.5 > =================================================================== > --- /dev/null 1970-01-01 00:00:00.000000000 +0000 > +++ xfsprogs-dev/man/man5/projects.5 2009-03-04 18:31:01.456981579 +0100 > @@ -0,0 +1,31 @@ > +.TH projects 5 > +.SH NAME > +projects \- persistent project root defintion > +.SH DESCRIPTION > +The > +.I /etc/projects > +file provides a mapping between numeric project identifiers and those directories > +which are the roots of the quota tree. Its format is simply: > + > +.nf > +.sp > +.in +5 > +# comments are hash-prefixed > +# ... > +10:/export/cage > +42:/var/log > +.in -5 > +.fi > +.PP > +The > +.I /etc/projects > +file is optional, instead > +.BR xfs_quota (8) > +can be used with the > +.B \-p > +argument to specify a project root directly for each operation. > + > +.SH SEE ALSO > +.BR xfs_quota (8), > +.BR xfsctl (3), > +.BR projid (5). > > _______________________________________________ > xfs mailing list > xfs@oss.sgi.com > http://oss.sgi.com/mailman/listinfo/xfs > _______________________________________________ xfs mailing list xfs@oss.sgi.com http://oss.sgi.com/mailman/listinfo/xfs