public inbox for linux-xfs@vger.kernel.org
 help / color / mirror / Atom feed
* [PATCH] xfsprogs: add projects(5) and projid(5) manpages
@ 2009-02-24 13:27 Christoph Hellwig
  2009-03-04 17:32 ` Christoph Hellwig
  0 siblings, 1 reply; 4+ messages in thread
From: Christoph Hellwig @ 2009-02-24 13:27 UTC (permalink / raw)
  To: xfs

Document the /etc/projects and /etc/projid files in their own manpages
instead of in xfs_quota(8).


Signed-off-by: Christoph Hellwig <hch@lst.de>

Index: xfsprogs-dev/man/man5/projid.5
===================================================================
--- /dev/null	1970-01-01 00:00:00.000000000 +0000
+++ xfsprogs-dev/man/man5/projid.5	2009-02-23 21:33:15.289051004 +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-02-23 21:35:34.889050486 +0100
+++ xfsprogs-dev/man/man8/xfs_quota.8	2009-02-23 21:36:25.138929778 +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).

_______________________________________________
xfs mailing list
xfs@oss.sgi.com
http://oss.sgi.com/mailman/listinfo/xfs

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] xfsprogs: add projects(5) and projid(5) manpages
  2009-02-24 13:27 [PATCH] xfsprogs: add projects(5) and projid(5) manpages Christoph Hellwig
@ 2009-03-04 17:32 ` Christoph Hellwig
  2009-03-16  6:34   ` Christoph Hellwig
  2009-03-21  4:16   ` Eric Sandeen
  0 siblings, 2 replies; 4+ messages in thread
From: Christoph Hellwig @ 2009-03-04 17:32 UTC (permalink / raw)
  To: xfs

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:

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

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] xfsprogs: add projects(5) and projid(5) manpages
  2009-03-04 17:32 ` Christoph Hellwig
@ 2009-03-16  6:34   ` Christoph Hellwig
  2009-03-21  4:16   ` Eric Sandeen
  1 sibling, 0 replies; 4+ messages in thread
From: Christoph Hellwig @ 2009-03-16  6:34 UTC (permalink / raw)
  To: xfs

ping?

On Wed, Mar 04, 2009 at 12:32:24PM -0500, 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:
> 
> 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
---end quoted text---

_______________________________________________
xfs mailing list
xfs@oss.sgi.com
http://oss.sgi.com/mailman/listinfo/xfs

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] xfsprogs: add projects(5) and projid(5) manpages
  2009-03-04 17:32 ` Christoph Hellwig
  2009-03-16  6:34   ` Christoph Hellwig
@ 2009-03-21  4:16   ` Eric Sandeen
  1 sibling, 0 replies; 4+ messages in thread
From: Eric Sandeen @ 2009-03-21  4:16 UTC (permalink / raw)
  To: Christoph Hellwig; +Cc: xfs

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 <sandeen@sandeen.net>

> 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

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2009-03-21  4:17 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2009-02-24 13:27 [PATCH] xfsprogs: add projects(5) and projid(5) manpages Christoph Hellwig
2009-03-04 17:32 ` Christoph Hellwig
2009-03-16  6:34   ` Christoph Hellwig
2009-03-21  4:16   ` Eric Sandeen

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox