3 vos_online - Brings a volume online
10 B<vos online> S<<< B<-server> <I<machine name>> >>>
11 S<<< B<-partition> <I<partition name>> >>>
12 S<<< B<-id> <I<volume name or ID>> >>>
13 S<<< [B<-cell> <I<cell name>>] >>>
14 [B<-noauth>] B<-localauth>]
15 [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
16 S<<< [B<-config> <I<config directory>>] >>>
19 B<vos on> S<<< B<-s> <I<machine name>> >>>
20 S<<< B<-p> <I<partition name>> >>>
21 S<<< B<-i> <I<volume name or ID>> >>>
22 S<<< [B<-c> <I<cell name>>] >>>
23 [B<-noa>] B<-l>] [B<-v>] [B<-e>] [B<-nor>]
24 S<<< [B<-co> <I<config directory>>] >>>
32 The B<vos online> command brings an offline volume on line with the
43 =item B<-server> <I<machine name>>
45 Identifies the file server machine where the volume resides.
46 Provide the machine's IP address or its host name (either fully
47 qualified or using an unambiguous abbreviation). For details, see
50 =item B<-partition> <I<partition name>>
52 Identifies the partition where the volume resides, on the
53 file server machine named by the B<-server> argument. Provide the
54 partition's complete name with preceding slash (for example, C</vicepa>)
55 or use one of the three acceptable abbreviated forms. For details, see
58 =item B<-id> <I<volume name or ID>>
60 Specifies either the complete name or volume ID number of the volume.
62 =item B<-cell> <I<cell name>>
64 Names the cell in which to run the command. Do not combine this argument
65 with the B<-localauth> flag. For more details, see L<vos(1)>.
69 Assigns the unprivileged identity anonymous to the issuer. Do not combine
70 this flag with the B<-localauth> flag. For more details, see L<vos(1)>.
74 Constructs a server ticket using a key from the local
75 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
76 to the Volume Server and Volume Location Server during mutual
77 authentication. Do not combine this flag with the B<-cell> argument or
78 B<-noauth> flag. For more details, see L<vos(1)>.
82 Produces on the standard output stream a detailed trace of the command's
83 execution. If this argument is omitted, only warnings and error messages
88 Encrypts the command so that the operation's results are not transmitted
89 across the network in clear text. This option is available in OpenAFS
90 versions 1.4.11 or later and 1.5.60 or later.
94 Shows all servers as IP addresses instead of the DNS name. This is very
95 useful when the server address is registered as 127.0.0.1 or when dealing
96 with multi-homed servers. This option is available in OpenAFS
97 versions 1.4.8 or later and 1.5.35 or later.
101 Prints the online help for this command. All other valid options are
108 The following example brings an offline volume online:
110 % vos online -server sv7.example.org -partition /vicepb -id root.afs
112 =head1 PRIVILEGE REQUIRED
114 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
115 machine specified with the B<-server> argument and on each database server
116 machine. If the B<-localauth> flag is included, the issuer must instead be
117 logged on to a server machine as the local superuser C<root>.
127 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
129 This man page was created by Steven Jenkins.