3 vos unlock - Unlocks a single VLDB entry
10 B<vos unlock> S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-cell> <I<cell name>>] >>>
11 [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
13 B<vos unlock> S<<< B<-i> <I<volume name or ID>> >>> S<<< [B<-c> <I<cell name>>] >>> [B<-n>]
14 [B<-l>] [B<-v>] [B<-h>]
21 The B<vos unlock> command releases the lock on the Volume Location
22 Database (VLDB) entry for the indicated volume.
26 Do not user this command under normal circumstances.
28 It is useful if the VLDB entry is locked but there is no reason to suspect
29 inconsistency within the volume or between it and the VLDB. Note that it
30 is possible to list information from locked VLDB entries, even though they
31 cannot be manipulated in other ways.
33 The B<vos unlockvldb> command unlocks several VLDB entries at once, or
34 even the entire VLDB. The B<vos lock> command locks a VLDB entry so that
35 no one else can perform an action that requires writing the VLDB.
41 =item B<-id> <I<volume name or ID>>
43 Specifies either the complete name or volume ID number of a volume of any
46 =item B<-cell> <I<cell name>>
48 Names the cell in which to run the command. Do not combine this argument
49 with the B<-localauth> flag. For more details, see L<vos(1)>.
53 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
54 combine this flag with the B<-localauth> flag. For more details, see
59 Constructs a server ticket using a key from the local
60 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
61 to the Volume Server and Volume Location Server during mutual
62 authentication. Do not combine this flag with the B<-cell> argument or
63 B<-noauth> flag. For more details, see L<vos(1)>.
67 Produces on the standard output stream a detailed trace of the command's
68 execution. If this argument is omitted, only warnings and error messages
73 Prints the online help for this command. All other valid options are
80 The following example unlocks the VLDB entry for the volume C<user.terry>.
82 % vos unlock user.terry
84 =head1 PRIVILEGE REQUIRED
86 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
87 machine specified with the B<-server> argument and on each database server
88 machine. If the B<-localauth> flag is included, the issuer must instead be
89 logged on to a server machine as the local superuser C<root>.
99 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
101 This documentation is covered by the IBM Public License Version 1.0. It was
102 converted from HTML to POD by software written by Chas Williams and Russ
103 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.