3 vos_setfields - Sets the quota or clear the access counter on a volume.
10 B<vos setfields> S<<< B<-id> <I<volume name or ID>> >>>
11 S<<< B<-maxquota> <I<quota (KB)>> >>>
12 [B<-clearuse>] [B<-clearVolUpCounter>]
13 S<<< [B<-cell> <I<cell name>>] >>>
14 [B<-noauth>] [B<-localauth>]
15 [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
17 B<vos se> S<<< B<-id> <I<volume name or ID>> >>>
18 S<<< B<-m> <I<quota (KB)>> >>> [B<-cl>]
19 S<<< [B<-ce> <I<cell name>>] >>>
20 [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
27 The B<vos setfields> command can set the quota on a volume, and it can
28 clear the access counter on a volume. This command differs from
29 B<fs setquota> because only the volume name is needed to set the quota,
30 whereas the path to the volume is needed with B<fs setquota>.
32 If the B<-maxquota> and B<-clearuse> flags are missing, then no action is
37 This command is not effective on read-only or backup volumes.
43 =item B<-id> <I<volume name or id>>
45 Identifies the volume on which to operate, either by its complete name or
48 =item B<-maxquota> <I<quota>>
50 Sets the maximum amount of file server disk space the volume can occupy.
51 The quota should be a positive integer followed by an optional suffix:
52 C<K> for kibibytes (1024 bytes, the default), C<M> for mebibytes (1024
53 kibibytes), C<G> for gibibytes (1024 mebibytes), and C<T> for tebibytes
54 (1024 gibibytes). A value of C<0> sets an unlimited quota, but the size
55 of the disk partition that houses the volume places an absolute limit on
60 Clears the access counter on a volume, which is shown as C<X accesses in
61 the past day (i.e., vnode references)> in the B<vos examine> output.
63 =item B<-clearVolUpCounter>
65 Clears the modification counter on a volume. The modification counter
66 will increment with time and stop updating when it reaches the maximum
67 value. This option will reset it to 0. This option is available in OpenAFS
68 version 1.5.0 or later.
70 =item B<-cell> <I<cell name>>
72 Names the cell in which to run the command. Do not combine this argument
73 with the B<-localauth> flag. For more details, see L<vos(1)>.
77 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
78 combine this flag with the B<-localauth> flag. For more details, see
83 Constructs a server ticket using a key from the local
84 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
85 to the Volume Server and Volume Location Server during mutual
86 authentication. Do not combine this flag with the B<-cell> argument or
87 B<-noauth> flag. For more details, see L<vos(1)>.
91 Produces on the standard output stream a detailed trace of the command's
92 execution. If this argument is omitted, only warnings and error messages
97 Encrypts the command so that the operation's results are not transmitted
98 across the network in clear text. This option is available in OpenAFS
99 versions 1.4.11 or later and 1.5.60 or later.
103 Shows all servers as IP addresses instead of the DNS name. This is very
104 useful when the server address is registered as 127.0.0.1 or when dealing
105 with multi-homed servers. This option is available in OpenAFS
106 versions 1.4.8 or later and 1.5.35 or later.
110 Prints the online help for this command. All other valid options are
117 This command produces no output other than error messages.
121 To set a 123KB quota on the root.cell volume, the following command may be
124 % vos setfields -id root.cell -maxquota 123
126 To clear the access counter on the root.cell volume, use the following
129 % vos setfields -id root.cell -clearuse
131 The above commands may be combined as follows:
133 % vos setfields -id root.cell -maxquota 123 -clearuse
135 =head1 PRIVILEGE REQUIRED
137 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
138 machine specified with the B<-server> argument and on each database server
139 machine. If the B<-localauth> flag is included, the issuer must instead be
140 logged on to a server machine as the local superuser C<root>.
150 Copyright 2009 Jason Edgecombe <jason@rampaginggeek.com>
152 This documentation is covered by the BSD License as written in the
153 doc/LICENSE file. This man page was written by Jason Edgecombe for