xfs
[Top] [All Lists]

[PATCH] [MAN]: Document new project quota options (-d and -p).

To: xfs@xxxxxxxxxxx
Subject: [PATCH] [MAN]: Document new project quota options (-d and -p).
From: Arkadiusz Miśkiewicz <arekm@xxxxxxxx>
Date: Thu, 29 Jan 2009 08:51:56 +0100
Cc: ddouwsma@xxxxxxxxxxxxxx, Arkadiusz Miśkiewicz <arekm@xxxxxxxx>
In-reply-to: <49814B19.2000907@xxxxxxxxxxxxxx>
References: <49814B19.2000907@xxxxxxxxxxxxxx>
Document -d <depth> and -p <path> project quota options.

Signed-off-by: Arkadiusz Miśkiewicz <arekm@xxxxxxxx>
---
 man/man8/xfs_quota.8 |   41 +++++++++++++++++++++++++++++++++++++++--
 1 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/man/man8/xfs_quota.8 b/man/man8/xfs_quota.8
index 6d1ea85..e9afa2e 100644
--- a/man/man8/xfs_quota.8
+++ b/man/man8/xfs_quota.8
@@ -547,6 +547,14 @@ instead of stdout.
 .B project
 [
 .B \-cCs
+[
+.B \-d
+.I depth
+]
+[
+.B \-p
+.I path
+]
 .I id
 |
 .I name
@@ -562,8 +570,14 @@ files). The
 .BR \-C ,
 and
 .B \-s
-options allow the directory
-tree quota mechanism, discussed in detail below, to be maintained.
+options allow the directory tree quota mechanism to be maintained.
+.BR \-d
+allows to limit recursion level when processing project directories
+and
+.BR \-p
+allows to specify project paths at command line ( instead of
+.I /etc/projects
+). All options are discussed in detail below.
 .SH DIRECTORY TREE QUOTA
 The project quota mechanism in XFS can be used to implement a form of
 directory tree quota, where a specified directory and all of the files
@@ -602,6 +616,18 @@ option can be used to check whether a
 tree is setup, it reports nothing if the tree is correct, otherwise it
 reports the paths of inodes which do not have the project ID of the rest
 of the tree, or if the inode flag is not set.
+.PP
+Option
+.B \-d
+can be used to limit recursion level (-1 is infinite, 0 is top level only,
+1 is first level ... ).
+Option
+.B \-p
+adds posibility to specify project paths in command line without a need
+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
@@ -666,6 +692,17 @@ log file directories to only using 1 gigabyte of space).
 # xfs_quota \-x \-c 'limit \-p bhard=1g logfiles' /var
 .in -5
 .fi
+.PP
+Same as above without a need for configuration files.
+.nf
+.sp
+.in +5
+# rm \-f /etc/projects /etc/projid
+# mount \-o prjquota /dev/xvm/var /var
+# xfs_quota \-x \-c 'project \-s \-p /var/log 42' /var
+# xfs_quota \-x \-c 'limit \-p bhard=1g 42' /var
+.in -5
+.fi
 .SH CAVEATS
 XFS implements delayed allocation (aka. allocate-on-flush) and this
 has implications for the quota subsystem.
-- 
1.6.1.1

<Prev in Thread] Current Thread [Next in Thread>