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>>] >>>
12 S<<< [B<-partition> <I<partition name>>] >>>
13 [B<-locked>] [B<-quiet>] [B<-nosort>]
14 S<<< [B<-cell> <I<cell name>>] >>> [B<-noauth>] [B<-localauth>]
15 [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
16 S<<< [B<-config> <I<config directory>>] >>>
19 B<vos listvl> S<<< [B<-na> <I<volume name or ID>>] >>>
20 S<<< [B<-s> <I<machine name>>] >>>
21 S<<< [B<-p> <I<partition name>>] >>>
22 [B<-lock>] [B<-q>] [B<-nos>] S<<< [B<-c> <I<cell name>>] >>>
23 [B<-noa>] [B<-loca>] [B<-v>] [B<-e>] [B<-nor>]
24 S<<< [B<-co> <I<config directory>>] >>>
32 The B<vos listvldb> command formats and displays information from the
33 Volume Location Database (VLDB) entry for each volume specified. The
34 output depends on the combination of options supplied on the command
35 line. Combine options as indicated to display the desired type of VLDB
42 Every entry in the VLDB: provide no options.
46 Every VLDB entry that mentions a certain file server machine as the site
47 for a volume: specify the machine's name as the B<-server> argument.
51 Every VLDB entry that mentions a certain partition on any file server
52 machine as the site for a volume: specify the partition name as the
53 B<-partition> argument.
57 Every VLDB entry that mentions a certain partition on a certain file
58 server machine as the site for a volume: combine the B<-server> and
59 B<-partition> arguments.
63 A single VLDB entry: specify a volume name or ID number with the B<-name>
68 The VLDB entry only for the volumes with locked VLDB entries found at a
69 certain site: combine the B<-locked> flag with any of arguments that
78 =item B<-name> <I<volume name or ID>>
80 Specifies either the complete name or volume ID number of a volume of any
83 =item B<-server> <I<server name>>
85 Identifies the file server machine listed as a site in each VLDB entry to
86 display. Provide the machine's IP address or its host name (either fully
87 qualified or using an unambiguous abbreviation). For details, see
90 This argument can be combined with the B<-partition> argument, the
91 B<-locked> flag, or both.
93 =item B<-partition> <I<partition name>>
95 Identifies the partition (on the file server machine specified by the
96 B<-server> argument) listed as a site in each VLDB entry to
97 display. Provide the partition's complete name with preceding slash (for
98 example, C</vicepa>) or use one of the three acceptable abbreviated
99 forms. For details, see L<vos(1)>.
101 This argument can be combined with the B<-server> argument, the B<-locked>
106 Displays only locked VLDB entries. This flag can be combined with the
107 B<-server> argument, the B<-partition> argument, or both.
111 Suppresses the lines that summarize the number of volumes listed and their
112 status, which otherwise appear at the beginning and end of the output when
113 the output includes more than one volume.
117 Suppresses the default sorting of volume entries alphabetically by volume
120 =include fragments/vos-common.pod
126 If the output includes more than one VLDB entry, by default the first line
127 reports which file server machine, partition, or both, houses the
128 volumes. The final line of output reports the total number of entries
129 displayed. Including the B<-quiet> flag suppresses these lines.
131 By default, volumes are sorted alphabetically by volume name. Including
132 the B<-nosort> flag skips the sorting step, which can speed up the
133 production of output if there are a large number of entries.
135 The VLDB entry for each volume includes the following information:
141 The base (read/write) volume name. The read-only and backup versions have
142 the same name with a C<.readonly> and C<.backup> extension, respectively.
146 The volume ID numbers allocated to the versions of the volume that
147 actually exist, in fields labeled C<RWrite> for the read/write, C<ROnly>
148 for the read-only, C<Backup> for the backup, and C<RClone> for the
149 ReleaseClone. (If a field does not appear, the corresponding version of
150 the volume does not exist.) The appearance of the C<RClone> field normally
151 indicates that a release operation did not complete successfully; the
152 C<Old release> and C<New release> flags often also appear on one or more
153 of the site definition lines described just following.
157 The number of sites that house a read/write or read-only copy of the
158 volume, following the string C<< number of sites -> >>.
162 A line for each site that houses a read/write or read-only copy of the
163 volume, specifying the file server machine, partition, and type of volume
164 (C<RW> for read/write or C<RO> for read-only). If a backup version exists,
165 it is understood to share the read/write site. Several flags can appear
166 with a site definition:
172 Indicates that the vos release command has not been issued since the B<vos
173 addsite> command was used to define the read-only site.
177 Indicates that a vos release command did not complete successfully,
178 leaving the previous, obsolete version of the volume at this site.
182 Indicates that a vos release command did not complete successfully, but
183 that this site did receive the correct new version of the volume.
189 If the VLDB entry is locked, the string C<Volume is currently LOCKED>, as
190 well as (in OpenAFS 1.5.75 and later) one or more of the following strings:
194 =item Volume is locked for a move operation
196 Indicates that the volume was locked due to a B<vos move> or a B<vos
197 convertROtoRW> command.
199 =item Volume is locked for a release operation
201 Indicates that the volume was locked due to a B<vos release> command.
203 =item Volume is locked for a backup operation
205 Indicates that the volume was locked due to a B<vos backup> command.
207 =item Volume is locked for a delete/misc operation
209 Indicates that the volume was locked due to a B<vos delentry>, B<vos
210 addsite>, B<vos remsite>, B<vos changeloc>, B<vos syncvldb>, B<vos
211 syncserv>, B<vos rename>, or B<vos lock> command.
213 =item Volume is locked for a dump/restore operation
215 Indicates that the volume was locked due to a B<vos dump> or B<vos restore>
222 For further discussion of the C<New release> and C<Old release> flags, see
227 The following command displays VLDB information for the Example Corporation
228 volume called C<usr>, which has two read-only replication sites:
230 % vos listvldb -name usr
232 RWrite: 5360870981 ROnly: 536870982 Backup: 536870983
234 server fs1.example.com partition /vicepa RO Site
235 server fs3.example.com partition /vicepa RO Site
236 server fs2.example.com partition /vicepb RW Site
238 The following example shows entries for two of the volumes that reside on
239 the file server machine C<fs4.example.com>. The first VLDB entry is currently
240 locked. There are 508 entries that mention the machine as a volume site.
242 % vos listvldb -server fs4.example.com
243 VLDB entries for server fs4.example.com
247 RWrite: 278541326 ROnly: 278541327 Backup: 278542328
249 server fs4.example.com partition /vicepg RW Site
250 Volume is currently LOCKED
252 RWrite 354287190 ROnly 354287191 Backup 354287192
254 server fs4.example.com partition /vicepc RW Site
259 =head1 PRIVILEGE REQUIRED
274 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
276 This documentation is covered by the IBM Public License Version 1.0. It was
277 converted from HTML to POD by software written by Chas Williams and Russ
278 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.