3 vos online - Brings a volume online
10 B<vos online> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>>
11 S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-bless>] >>> S<<< [B<-cell> <I<cell name>>] >>>
12 S<<< [B<-noauth>] | B<-localauth>] >>> S<<< [B<-verbose>] >>> S<<< [B<-encrypt>] >>> S<<< [B<-help>] >>>
19 The B<vos online> command brings an offline volume on line with the
30 =item B<-server> <I<machine name>>
32 Identifies the file server machine where the volume resides.
33 Provide the machine's IP address or its host name (either fully
34 qualified or using an unambiguous abbreviation). For details, see
37 =item B<-partition> <I<partition name>>
39 Identifies the partition where the volume resides, on the
40 file server machine named by the B<-server> argument. Provide the
41 partition's complete name with preceding slash (for example, C</vicepa>)
42 or use one of the three acceptable abbreviated forms. For details, see
45 =item B<-id> <I<volume name or ID>>
47 Specifies either the complete name or volume ID number of the volume.
51 If the volume resides on a fileserver running as a I<dafs> (Demand
52 Attach File Server), then the volume may be marked as I<blessed> or
53 I<unblessed>. A I<dafs> server will not bring I<unblessed> volumes
54 online unless the B<-bless> option to L<vos_online> is specified.
55 See L<vos_offline(1)> for setting a volume to be I<unblessed>.
57 =item B<-cell> <I<cell name>>
59 Names the cell in which to run the command. Do not combine this argument
60 with the B<-localauth> flag. For more details, see L<vos(1)>.
64 Assigns the unprivileged identity anonymous to the issuer. Do not combine
65 this flag with the B<-localauth> flag. For more details, see L<vos(1)>.
69 Constructs a server ticket using a key from the local
70 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
71 to the Volume Server and Volume Location Server during mutual
72 authentication. Do not combine this flag with the B<-cell> argument or
73 B<-noauth> flag. For more details, see L<vos(1)>.
77 Produces on the standard output stream a detailed trace of the command's
78 execution. If this argument is omitted, only warnings and error messages
83 Encrypts the command so that the operation's results are
84 not transmitted across the network in clear text.
88 Prints the online help for this command. All other valid options are
95 The following example brings an offline volume online:
97 % vos online -server sv7.stateu.edu -partition /vicepb -id root.afs
99 The following example brings an offline, unblessed volume online:
101 % vos online -server sv7.stateu.edu -partition /vicepb -id root.afs -bless
103 =head1 PRIVILEGE REQUIRED
105 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
106 machine specified with the B<-server> argument and on each database server
107 machine. If the B<-localauth> flag is included, the issuer must instead be
108 logged on to a server machine as the local superuser C<root>.
118 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
120 This man page was created by Steven Jenkins.