add-afs-man-pages-20010716
[openafs.git] / src / man / fs_quota.1
1 fs quota                   AFS Commands                fs quota
2
3
4 NAME
5
6    fs   quota -- show   percent   of  quota  used  for  volume
7
8                        containing directory/file.
9
10
11                                    +
12    fs quota  [-path <dir/file path> ]  [-help]
13
14 ACCEPTABLE ABBREVIATIONS/ALIASES
15
16                             +
17    fs q  [-p <dir/file path> ]  [-h]
18
19 DESCRIPTION
20
21    Displays the percent of maximum quota currently used by  the
22    volume that contains each specified directory or file.  This
23    is the  least  informative  but  quickest  fs  command  that
24    provides  quota  information about a volume.  The fs examine
25    and fs listquota commands provide more complete information.
26
27    The system administrator may set quota with the fs  setquota
28    or fs setvol command.
29
30 ARGUMENTS
31
32    -path specifies  each  file and/or directory for which quota
33          information about the host volume is desired.  If  the
34          issuer  omits  this argument, the current directory is
35          assumed.
36
37    -help prints the online help entry for this command.  Do not
38          provide  any  other  arguments or flags with this one.
39          See section 3.1  in  the  Reference  Manual  for  more
40          details.
41
42 OUTPUT
43
44    The  output  reports the percent of quota used.  It does not
45    name the host volume.
46
47 EXAMPLES
48
49    The following lists the percent quota  used  of  the  volume
50    housing the current working directory:
51
52        % fs quota
53        17% of quota used.
54
55
56
57    The  following  lists  the  percent  quota  used of both the
58    volume  housing  the  current  working  directory's   parent
59    directory   and  the  volume  housing  the  directory  named
60    /afs/transarc.com/usr/smith:
61
62        % fs quota .. /afs/transarc.com/usr/smith
63        43% of quota used.
64        92% of quota used.
65
66 PRIVILEGE REQUIRED
67
68    None.
69
70 MORE INFORMATION
71
72    fs examine
73
74    fs listquota
75
76    fs setquota
77
78    fs setvol