Index: openafs/doc/man-pages/README diff -c openafs/doc/man-pages/README:1.8.2.23 openafs/doc/man-pages/README:1.8.2.24 *** openafs/doc/man-pages/README:1.8.2.23 Mon Jun 30 16:08:03 2008 --- openafs/doc/man-pages/README Mon Mar 16 22:30:01 2009 *************** *** 247,253 **** restorevol rmtsysd tokens.krb - vos setfields vsys * Add -noresolve to the documentation of all the vos commands. --- 247,252 ---- Index: openafs/doc/man-pages/pod1/vos.pod diff -c openafs/doc/man-pages/pod1/vos.pod:1.3.6.6 openafs/doc/man-pages/pod1/vos.pod:1.3.6.7 *** openafs/doc/man-pages/pod1/vos.pod:1.3.6.6 Sun Jul 13 19:53:50 2008 --- openafs/doc/man-pages/pod1/vos.pod Mon Mar 16 22:30:02 2009 *************** *** 90,95 **** --- 90,99 ---- =item * + A command to change volume fields: B. + + =item * + Commands to obtain help: B and B. =back *************** *** 211,216 **** --- 215,227 ---- The B<-fromserver> and B<-toserver> arguments to the B command also accept these name formats. + =item B<-noresolve> + + Shows all servers as IP addresses instead of the DNS name. This is very + useful when the server address is registered as 127.0.0.1 or when dealing + with multi-homed servers. The B<-noresolve> option is available in OpenAFS + versions 1.4.8 or later and 1.5.35 or later. + =item B<-verbose> Produces on the standard output stream a detailed trace of the command's *************** *** 261,266 **** --- 272,278 ---- L, L, L, + L, L, L, L, Index: openafs/doc/man-pages/pod1/vos_examine.pod diff -c openafs/doc/man-pages/pod1/vos_examine.pod:1.4.2.3 openafs/doc/man-pages/pod1/vos_examine.pod:1.4.2.4 *** openafs/doc/man-pages/pod1/vos_examine.pod:1.4.2.3 Sun Jul 13 19:37:38 2008 --- openafs/doc/man-pages/pod1/vos_examine.pod Sun Feb 1 20:22:34 2009 *************** *** 170,176 **** The date and time the volume was created, in the C field. If the volume has been restored with the B, B, or B command, this is the restore time. =item * --- 170,184 ---- The date and time the volume was created, in the C field. If the volume has been restored with the B, B, or B command, this is the restore time. For a ! read-only volume, this is the last release time. ! ! =item * ! ! The date and time this copy of this volume was created, in the C ! field. This is the time when the volume was created on this server and ! partition. For read-only volumes, it is not updated by a release (unlike ! the Creation date). The copy date is not stored in volume dumps. =item * *************** *** 305,310 **** --- 313,319 ---- RWrite 5360870981 ROnly 536870982 Backup 536870983 MaxQuota 40000 K Creation Mon Jun 12 15:22:06 1989 + Copy Mon Jun 12 15:22:06 1989 Last Update Fri Jun 16 09:34:35 1989 5719 accesses in the past day (i.e., vnode references) RWrite: 5360870981 ROnly: 536870982 Backup: 536870983 *************** *** 323,328 **** --- 332,338 ---- RWrite 354287190 ROnly 0 Backup 354287192 MaxQuota 5000 K Creation Wed Nov 25 17:38:57 1992 + Copy Wed Nov 25 17:38:57 1992 Last Update Tue Dec 15 10:46:20 1992 598 accesses in the past day (i.e., vnode references) Raw Read/Write Stats Index: openafs/doc/man-pages/pod1/vos_setfields.pod diff -c /dev/null openafs/doc/man-pages/pod1/vos_setfields.pod:1.1.2.2 *** /dev/null Sun Mar 29 18:37:10 2009 --- openafs/doc/man-pages/pod1/vos_setfields.pod Mon Mar 16 22:30:02 2009 *************** *** 0 **** --- 1,142 ---- + =head1 NAME + + vos_setfields - Sets the quota or clear the access counter on a volume. + + =head1 SYNOPSIS + + =for html +
+ + B S<<< B<-id> > >>> + S<<< B<-maxquota> > >>> [B<-clearuse>] + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [b<-noresolve>] [B<-help>] + + B S<<< B<-id> > >>> + S<<< B<-maxquota> > >>> [B<-clearuse>] + S<<< [B<-cell> >] >>> [B<-noauth>] [B<-localauth>] + [B<-verbose>] [B<-encrypt>] [b<-noresolve>] [B<-help>] + + =for html +
+ + =head1 DESCRIPTION + + The B command can set the quota on a volume, and it can + clear the access counter on a volume. This command differs from + B because only the volume name is needed to set the quota, + whereas the path to the volume is needed with B. + + If the B<-maxquota> and B<-clearuse> flags are missing, then no action is + taken. + + =head1 CAUTIONS + + This command is not effective on read-only or backup volumes. + + =head1 OPTIONS + + =over 4 + + =item B<-id> > + + Identifies the volume on which to operate, either by its complete name or + volume ID number. + + =item B<-maxquota> > + + Sets the maximum amount of file server disk space the volume can + occupy. Specify the number of one-kilobyte blocks as a positive integer + (C<1024> is one megabyte). A value of C<0> sets an unlimited quota, but + the size of the disk partition that houses the volume places an absolute + limit on the volume's size. + + =item B<-clearuse> + + Clears the access counter on a volumes, which is shown as C in the B output. + + =item B<-cell> > + + Names the cell in which to run the command. Do not combine this argument + with the B<-localauth> flag. For more details, see L. + + =item B<-noauth> + + Assigns the unprivileged identity C to the issuer. Do not + combine this flag with the B<-localauth> flag. For more details, see + L. + + =item B<-localauth> + + Constructs a server ticket using a key from the local + F file. The B command interpreter presents it + to the Volume Server and Volume Location Server during mutual + authentication. Do not combine this flag with the B<-cell> argument or + B<-noauth> flag. For more details, see L. + + =item B<-encrypt> + + Encrypts the command so that the operation's results are not transmitted + across the network in clear text. + + =item B<-noresolve> + + Shows all servers as IP addresses instead of the DNS name. This is very + useful when the server address is registered as 127.0.0.1 or when dealing + with multi-homed servers. The B<-noresolve> option is available in OpenAFS + versions 1.4.8 or later and 1.5.35 or later. + + =item B<-verbose> + + Produces on the standard output stream a detailed trace of the command's + execution. If this argument is omitted, only warnings and error messages + appear. + + =item B<-help> + + Prints the online help for this command. All other valid options are + ignored. + + =back + + =head1 OUTPUT + + This command produces no output other than error messages. + + =head1 EXAMPLES + + To set a 123KB quota on the root.cell volume, the following command may be + used: + + % vos setfields -id root.cell -maxquota 123 + + To clear the access counter on the root.cell volume, use the following + command: + + % vos setfields -id root.cell -clearuse + + The above commands may be combined as follows: + + % vos setfields -id root.cell -maxquota 123 -clearuse + + =head1 PRIVILEGE REQUIRED + + The issuer must be listed in the F file on the + machine specified with the B<-server> argument and on each database server + machine. If the B<-localauth> flag is included, the issuer must instead be + logged on to a server machine as the local superuser C. + + =head1 SEE ALSO + + L, + L, + L + + =head1 COPYRIGHT + + Copyright 2009 Jason Edgecombe + + This documentation is covered by the BSD License as written in the + doc/LICENSE file. This man page was written by Jason Edgecombe for + OpenAFS. Index: openafs/doc/man-pages/pod8/afsd.pod diff -c openafs/doc/man-pages/pod8/afsd.pod:1.6.2.6 openafs/doc/man-pages/pod8/afsd.pod:1.6.2.7 *** openafs/doc/man-pages/pod8/afsd.pod:1.6.2.6 Sun Mar 9 01:08:47 2008 --- openafs/doc/man-pages/pod8/afsd.pod Thu Mar 19 22:31:41 2009 *************** *** 29,34 **** --- 29,35 ---- [B<-settime>] [B<-shutdown>] S<<< [B<-splitcache> >] >>> S<<< [B<-stat> >] >>> [B<-verbose>] + [B<-disable-dynamic-vcaches>] S<<< [B<-volumes> >] >>> [B<-waitclose>] *************** *** 669,674 **** --- 670,682 ---- Specifies the number of memory structures to allocate for storing volume location information. The default value is C<50>. + =item B<-disable-dynamic-vcaches> + + By default, dynamic vcache overrides the B<-stat> option by using the value of + B<-stat> (or the default) as the initial size of the stat (or vcache) pool and + increases the pool dynamically as needed on supported platforms. This flag will + disable this new functionality and honor the '-stat' setting. + =item B<-waitclose> Has no effect on the operation of the Cache Manager. The behavior it Index: openafs/doc/man-pages/pod8/salvager.pod diff -c openafs/doc/man-pages/pod8/salvager.pod:1.4 openafs/doc/man-pages/pod8/salvager.pod:1.4.2.1 *** openafs/doc/man-pages/pod8/salvager.pod:1.4 Wed Mar 1 00:02:32 2006 --- openafs/doc/man-pages/pod8/salvager.pod Sun Feb 1 20:23:06 2009 *************** *** 102,112 **** constantly moving the disk head from one partition to another. However, this strategy is often not ideal if the partitions are configured as logical volumes that span multiple disks. To force the Salvager to salvage ! logical volumes in parallel, provide the string C as the value for ! the B<-parallel> argument. Provide a positive integer to specify the ! number of subprocesses to run in parallel (for example, C<-parallel 5all> ! for five subprocesses), or omit the integer to run up to four ! subprocesses, depending on the number of logical volumes being salvaged. The Salvager creates temporary files as it runs, by default writing them to the partition it is salvaging. The number of files can be quite large, --- 102,114 ---- constantly moving the disk head from one partition to another. However, this strategy is often not ideal if the partitions are configured as logical volumes that span multiple disks. To force the Salvager to salvage ! logical volumes in parallel as if they were on separate disks, provide the ! string C as the value for the B<-parallel> argument. ! ! To set both parameters at the same time, append the number of Salvager ! processes to the string C. For example, C<-parallel all5> treats ! each partition as a separate disk and runs five Salvager processes, thus ! salvaging five partitions at a time. The Salvager creates temporary files as it runs, by default writing them to the partition it is salvaging. The number of files can be quite large, *************** *** 230,236 **** The BOS Server never starts more Salvager subprocesses than there are partitions, and always starts only one process to salvage a single volume. If this argument is omitted, up to four Salvager subprocesses run ! in parallel. =item B<-tmpdir> > --- 232,238 ---- The BOS Server never starts more Salvager subprocesses than there are partitions, and always starts only one process to salvage a single volume. If this argument is omitted, up to four Salvager subprocesses run ! in parallel but partitions on the same device are salvaged serially. =item B<-tmpdir> > Index: openafs/doc/man-pages/pod8/vldb_check.pod diff -c openafs/doc/man-pages/pod8/vldb_check.pod:1.4 openafs/doc/man-pages/pod8/vldb_check.pod:1.4.2.1 *** openafs/doc/man-pages/pod8/vldb_check.pod:1.4 Wed Mar 1 00:02:32 2006 --- openafs/doc/man-pages/pod8/vldb_check.pod Mon Feb 16 23:17:09 2009 *************** *** 8,14 ****
B S<<< B<-database> > >>> [B<-uheader>] [B<-vheader>] ! [B<-servers>] [B<-entries>] [B<-verbose>] [B<-help>] B S<<< B<-d> > >>> [B<-u>] [B<-vh>] [B<-s>] [B<-e>] [B<-ve>] [B<-h>] --- 8,14 ----
B S<<< B<-database> > >>> [B<-uheader>] [B<-vheader>] ! [B<-servers>] [B<-entries>] [B<-quiet> | B<-verbose>] [B<-help>] B S<<< B<-d> > >>> [B<-u>] [B<-vh>] [B<-s>] [B<-e>] [B<-ve>] [B<-h>] *************** *** 60,69 **** Outputs every volume entry in the database. The information includes the volume's name and the volume ID number for each of its versions. =item B<-verbose> Reports additional information about the database, including the number of ! entries for each type of volume. =item B<-help> --- 60,74 ---- Outputs every volume entry in the database. The information includes the volume's name and the volume ID number for each of its versions. + =item B<-quiet> + + Blocks output from going to stdout. Output to stderr is not blocked. Cannot + be used with -verbose, -uheader, -servers or -entries. + =item B<-verbose> Reports additional information about the database, including the number of ! entries for each type of volume. Cannot be used with -quiet. =item B<-help> *************** *** 81,86 **** --- 86,101 ---- output is intended for debugging purposes and is meaningful to someone familiar with the internal structure of the VLDB. + The B<-quiet> option can be used to supress the standard output stream + so that the command can be used more easily inside scripts. + + The command exits with one of the following completion codes: + + 0: No errors or warnings have been encountered. + 1: One or more warnings encountered. + 2: One or more warnings and/or errors encountered. + 4: A fatal or internal error has occurred and the program cannot proceed. + =head1 PRIVILEGE REQUIRED The issuer must be logged in as the local superuser C.