3 vos offline - Takes a volume offline
10 B<vos offline> S<<< B<-server> <I<machine name>> >>> S<<< B<-partition> <I<partition name>> >>>
11 S<<< B<-id> <I<volume name or ID>> >>> S<<< [B<-unbless>] >>> 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 offline> command takes a volume offline on the
24 Taking a volume offline that has existing
25 callbacks will result in those callbacks being broken
26 and clients not being able to access the volume.
32 =item B<-server> <I<machine name>>
34 Identifies the file server machine where the volume resides.
35 Provide the machine's IP address or its host name (either fully
36 qualified or using an unambiguous abbreviation). For details, see
39 =item B<-partition> <I<partition name>>
41 Identifies the partition where the volume resides, on the
42 file server machine named by the B<-server> argument. Provide the
43 partition's complete name with preceding slash (for example, C</vicepa>)
44 or use one of the three acceptable abbreviated forms. For details, see
47 =item B<-id> <I<volume name or ID>>
49 Specifies either the complete name or volume ID number of the volume.
53 If the volume resides on a fileserver running as a I<dafs> (Demand
54 Attach File Server), then the volume may be marked as I<blessed> or
55 I<unblessed>. A I<dafs> server will not bring I<unblessed> volumes
56 online unless the B<-bless> option to L<vos_online> is specified.
57 See L<vos_online(1)> for setting a volume to be I<blessed>.
59 =item B<-cell> <I<cell name>>
61 Names the cell in which to run the command. Do not combine this argument
62 with the B<-localauth> flag. For more details, see L<vos(1)>.
66 Assigns the unprivileged identity anonymous to the issuer. Do not combine
67 this flag with the B<-localauth> flag. For more details, see L<vos(1)>.
71 Constructs a server ticket using a key from the local
72 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
73 to the Volume Server and Volume Location Server during mutual
74 authentication. Do not combine this flag with the B<-cell> argument or
75 B<-noauth> flag. For more details, see L<vos(1)>.
79 Produces on the standard output stream a detailed trace of the command's
80 execution. If this argument is omitted, only warnings and error messages
85 Encrypts the command so that the operation's results are
86 not transmitted across the network in clear text.
90 Prints the online help for this command. All other valid options are
97 The following example takes an online volume offline:
99 % vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs
101 The following example takes an online volume offline and marks it
102 so that a B<vos online> without B<-bless> will not bring it online:
104 % vos offline -server sv7.stateu.edu -partition /vicepb -id root.afs \
107 =head1 PRIVILEGE REQUIRED
109 The issuer must be listed in the F</usr/afs/etc/UserList> file on the
110 machine specified with the B<-server> argument and on each database server
111 machine. If the B<-localauth> flag is included, the issuer must instead be
112 logged on to a server machine as the local superuser C<root>.
122 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
124 This man page was created by Steven Jenkins.