3 vos listvldb - Displays a volume's VLDB entry
10 B<vos listvldb> S<<< [B<-name> <I<volume name or ID>>] >>>
11 S<<< [B<-server> <I<machine name>>] >>> S<<< [B<-partition> <I<partition name>>] >>>
12 [B<-locked>] [B<-quiet>] [B<-nosort>] S<<< [B<-cell> <I<cell name>>] >>>
13 [B<-noauth>] [B<-localauth>] [B<-verbose>] [B<-help>]
15 B<vos listvl> S<<< [B<-na> <I<volume name or ID>>] >>> S<<< [B<-s> <I<machine name>>] >>>
16 S<<< [B<-p> <I<partition name>>] >>> [B<-lock>] [B<-q>] [B<-nos>]
17 S<<< [B<-c> <I<cell name>>] >>> [B<-noa>] [B<-loca>] [B<-v>] [B<-h>]
24 The B<vos listvldb> command formats and displays information from the
25 Volume Location Database (VLDB) entry for each volume specified. The
26 output depends on the combination of options supplied on the command
27 line. Combine options as indicated to display the desired type of VLDB
34 Every entry in the VLDB: provide no options.
38 Every VLDB entry that mentions a certain file server machine as the site
39 for a volume: specify the machine's name as the B<-server> argument.
43 Every VLDB entry that mentions a certain partition on any file server
44 machine as the site for a volume: specify the partition name as the
45 B<-partition> argument.
49 Every VLDB entry that mentions a certain partition on a certain file
50 server machine as the site for a volume: combine the B<-server> and
51 B<-partition> arguments.
55 A single VLDB entry: specify a volume name or ID number with the B<-name>
60 The VLDB entry only for the volumes with locked VLDB entries found at a
61 certain site: combine the B<-locked> flag with any of arguments that
70 =item B<-name> <I<volume name or ID>>
72 Specifies either the complete name or volume ID number of a volume of any
75 =item B<-server> <I<server name>>
77 Identifies the file server machine listed as a site in each VLDB entry to
78 display. Provide the machine's IP address or its host name (either fully
79 qualified or using an unambiguous abbreviation). For details, see
82 This argument can be combined with the B<-partition> argument, the
83 B<-locked> flag, or both.
85 =item B<-partition> <I<partition name>>
87 Identifies the partition (on the file server machine specified by the
88 B<-server> argument) listed as a site in each VLDB entry to
89 display. Provide the partition's complete name with preceding slash (for
90 example, C</vicepa>) or use one of the three acceptable abbreviated
91 forms. For details, see L<vos(1)>.
93 This argument can be combined with the B<-server> argument, the B<-locked>
98 Displays only locked VLDB entries. This flag can be combined with the
99 B<-server> argument, the B<-partition> argument, or both.
103 Suppresses the lines that summarize the number of volumes listed and their
104 status, which otherwise appear at the beginning and end of the output when
105 the output includes more than one volume.
109 Suppresses the default sorting of volume entries alphabetically by volume
112 =item B<-cell> <I<cell name>>
114 Names the cell in which to run the command. Do not combine this argument
115 with the B<-localauth> flag. For more details, see L<vos(1)>.
119 Assigns the unprivileged identity C<anonymous> to the issuer. Do not
120 combine this flag with the B<-localauth> flag. For more details, see
125 Constructs a server ticket using a key from the local
126 F</usr/afs/etc/KeyFile> file. The B<vos> command interpreter presents it
127 to the Volume Server and Volume Location Server during mutual
128 authentication. Do not combine this flag with the B<-cell> argument or
129 B<-noauth> flag. For more details, see L<vos(1)>.
133 Produces on the standard output stream a detailed trace of the command's
134 execution. If this argument is omitted, only warnings and error messages
139 Prints the online help for this command. All other valid options are
146 If the output includes more than one VLDB entry, by default the first line
147 reports which file server machine, partition, or both, houses the
148 volumes. The final line of output reports the total number of entries
149 displayed. Including the B<-quiet> flag suppresses these lines.
151 By default, volumes are sorted alphabetically by volume name. Including
152 the B<-nosort> flag skips the sorting step, which can speed up the
153 production of output if there are a large number of entries.
155 The VLDB entry for each volume includes the following information:
161 The base (read/write) volume name. The read-only and backup versions have
162 the same name with a C<.readonly> and C<.backup> extension, respectively.
166 The volume ID numbers allocated to the versions of the volume that
167 actually exist, in fields labeled C<RWrite> for the read/write, C<ROnly>
168 for the read-only, C<Backup> for the backup, and C<RClone> for the
169 ReleaseClone. (If a field does not appear, the corresponding version of
170 the volume does not exist.) The appearance of the C<RClone> field normally
171 indicates that a release operation did not complete successfully; the
172 C<Old release> and C<New release> flags often also appear on one or more
173 of the site definition lines described just following.
177 The number of sites that house a read/write or read-only copy of the
178 volume, following the string C<< number of sites -> >>.
182 A line for each site that houses a read/write or read-only copy of the
183 volume, specifying the file server machine, partition, and type of volume
184 (C<RW> for read/write or C<RO> for read-only). If a backup version exists,
185 it is understood to share the read/write site. Several flags can appear
186 with a site definition:
192 Indicates that the vos release command has not been issued since the B<vos
193 addsite> command was used to define the read-only site.
197 Indicates that a vos release command did not complete successfully,
198 leaving the previous, obsolete version of the volume at this site.
202 Indicates that a vos release command did not complete successfully, but
203 that this site did receive the correct new version of the volume.
209 If the VLDB entry is locked, the string C<Volume is currently LOCKED>.
213 For further discussion of the C<New release> and C<Old release> flags, see
218 The following command displays VLDB information for the ABC Corporation
219 volume called C<usr>, which has two read-only replication sites:
221 % vos listvldb -name usr
223 RWrite: 5360870981 ROnly: 536870982 Backup: 536870983
225 server fs1.abc.com partition /vicepa RO Site
226 server fs3.abc.com partition /vicepa RO Site
227 server fs2.abc.com partition /vicepb RW Site
229 The following example shows entries for two of the volumes that reside on
230 the file server machine C<fs4.abc.com>. The first VLDB entry is currently
231 locked. There are 508 entries that mention the machine as a volume site.
233 % vos listvldb -server fs4.abc.com
234 VLDB entries for server fs4.abc.com
238 RWrite: 278541326 ROnly: 278541327 Backup: 278542328
240 server fs4.abc.com partition /vicepg RW Site
241 Volume is currently LOCKED
243 RWrite 354287190 ROnly 354287191 Backup 354287192
245 server fs4.abc.com partition /vicepc RW Site
250 =head1 PRIVILEGE REQUIRED
265 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
267 This documentation is covered by the IBM Public License Version 1.0. It was
268 converted from HTML to POD by software written by Chas Williams and Russ
269 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.