3 vos_unlock - Unlocks a single VLDB entry
10 B<vos unlock> S<<< B<-id> <I<volume name or ID>> >>>
11 S<<< [B<-cell> <I<cell name>>] >>>
12 [B<-noauth>] [B<-localauth>]
13 [B<-verbose>] [B<-encrypt>] [B<-noresolve>] [B<-help>]
15 B<vos unlock> S<<< B<-i> <I<volume name or ID>> >>>
16 S<<< [B<-c> <I<cell name>>] >>>
17 [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>] [B<-h>]
24 The B<vos unlock> command releases the lock on the Volume Location
25 Database (VLDB) entry for the indicated volume.
29 Do not user this command under normal circumstances.
31 It is useful if the VLDB entry is locked but there is no reason to suspect
32 inconsistency within the volume or between it and the VLDB. Note that it
33 is possible to list information from locked VLDB entries, even though they
34 cannot be manipulated in other ways.
36 The B<vos unlockvldb> command unlocks several VLDB entries at once, or
37 even the entire VLDB. The B<vos lock> command locks a VLDB entry so that
38 no one else can perform an action that requires writing the VLDB.
44 =item B<-id> <I<volume name or ID>>
46 Specifies either the complete name or volume ID number of a volume of any
49 =item B<-cell> <I<cell name>>
51 Names the cell in which to run the command. Do not combine this argument
52 with the B<-localauth> flag. For more details, see L<vos(1)>.
56 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
57 combine this flag with the B<-localauth> flag. For more details, see
62 Constructs a server ticket using a key from the local
63 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
64 to the Volume Server and Volume Location Server during mutual
65 authentication. Do not combine this flag with the B<-cell> argument or
66 B<-noauth> flag. For more details, see L<vos(1)>.
70 Produces on the standard output stream a detailed trace of the command's
71 execution. If this argument is omitted, only warnings and error messages
76 Encrypts the command so that the operation's results are not transmitted
77 across the network in clear text. This option is available in OpenAFS
78 versions 1.4.11 or later and 1.5.60 or later.
82 Shows all servers as IP addresses instead of the DNS name. This is very
83 useful when the server address is registered as 127.0.0.1 or when dealing
84 with multi-homed servers. This option is available in OpenAFS
85 versions 1.4.8 or later and 1.5.35 or later.
89 Prints the online help for this command. All other valid options are
96 The following example unlocks the VLDB entry for the volume C<user.terry>.
98 % vos unlock user.terry
100 =head1 PRIVILEGE REQUIRED
102 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
103 machine specified with the B<-server> argument and on each database server
104 machine. If the B<-localauth> flag is included, the issuer must instead be
105 logged on to a server machine as the local superuser C<root>.
115 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
117 This documentation is covered by the IBM Public License Version 1.0. It was
118 converted from HTML to POD by software written by Chas Williams and Russ
119 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.