Provided by: openafs-client_1.8.13-1_amd64 
NAME
vos_listvldb - Displays a volume's VLDB entry
SYNOPSIS
vos listvldb [-name <volume name or ID>]
[-server <machine name>]
[-partition <partition name>]
[-locked] [-quiet] [-nosort]
[-cell <cell name>] [-noauth] [-localauth]
[-verbose] [-encrypt] [-noresolve]
[-config <config directory>]
[-help]
vos listvl [-na <volume name or ID>]
[-s <machine name>]
[-p <partition name>]
[-lock] [-q] [-nos] [-c <cell name>]
[-noa] [-loca] [-v] [-e] [-nor]
[-co <config directory>]
[-h]
DESCRIPTION
The vos listvldb command formats and displays information from the Volume Location
Database (VLDB) entry for each volume specified. The output depends on the combination of
options supplied on the command line. Combine options as indicated to display the desired
type of VLDB entries:
• Every entry in the VLDB: provide no options.
• Every VLDB entry that mentions a certain file server machine as the site for a volume:
specify the machine's name as the -server argument.
• Every VLDB entry that mentions a certain partition on any file server machine as the
site for a volume: specify the partition name as the -partition argument.
• Every VLDB entry that mentions a certain partition on a certain file server machine as
the site for a volume: combine the -server and -partition arguments.
• A single VLDB entry: specify a volume name or ID number with the -name argument.
• The VLDB entry only for the volumes with locked VLDB entries found at a certain site:
combine the -locked flag with any of arguments that define sites.
OPTIONS
-name <volume name or ID>
Specifies either the complete name or volume ID number of a volume of any of the three
types.
-server <server name>
Identifies the file server machine listed as a site in each VLDB entry to display.
Provide the machine's IP address or its host name (either fully qualified or using an
unambiguous abbreviation). For details, see vos(1).
This argument can be combined with the -partition argument, the -locked flag, or both.
-partition <partition name>
Identifies the partition (on the file server machine specified by the -server
argument) listed as a site in each VLDB entry to display. Provide the partition's
complete name with preceding slash (for example, "/vicepa") or use one of the three
acceptable abbreviated forms. For details, see vos(1).
This argument can be combined with the -server argument, the -locked flag, or both.
-locked
Displays only locked VLDB entries. This flag can be combined with the -server
argument, the -partition argument, or both.
-quiet
Suppresses the lines that summarize the number of volumes listed and their status,
which otherwise appear at the beginning and end of the output when the output includes
more than one volume.
-nosort
Suppresses the default sorting of volume entries alphabetically by volume name.
-cell <cell name>
Names the cell in which to run the command. Do not combine this argument with the
-localauth flag. For more details, see vos(1).
-noauth
Assigns the unprivileged identity "anonymous" to the issuer. Do not combine this flag
with the -localauth flag. For more details, see vos(1).
-localauth
Constructs a server ticket using a key from the local /etc/openafs/server/KeyFile
file. The vos command interpreter presents it to the Volume Server and Volume Location
Server during mutual authentication. Do not combine this flag with the -cell argument
or -noauth flag. For more details, see vos(1).
-verbose
Produces on the standard output stream a detailed trace of the command's execution. If
this argument is omitted, only warnings and error messages appear.
-encrypt
Encrypts the command so that the operation's results are not transmitted across the
network in clear text. This option is available in OpenAFS versions 1.4.11 or later
and 1.5.60 or later.
-noresolve
Shows all servers as IP addresses instead of the DNS name. This is very useful when
the server address is registered as 127.0.0.1 or when dealing with multi-homed
servers. This option is available in OpenAFS versions 1.4.8 or later and 1.5.35 or
later.
-config <configuration directory>
Set the location of the configuration directory to be used. This defaults to
/etc/openafs, except if -localauth is specified, in which case the default is
/etc/openafs/server. This option allows the use of alternative configuration locations
for testing purposes.
-help
Prints the online help for this command. All other valid options are ignored.
OUTPUT
If the output includes more than one VLDB entry, by default the first line reports which
file server machine, partition, or both, houses the volumes. The final line of output
reports the total number of entries displayed. Including the -quiet flag suppresses these
lines.
By default, volumes are sorted alphabetically by volume name. Including the -nosort flag
skips the sorting step, which can speed up the production of output if there are a large
number of entries.
The VLDB entry for each volume includes the following information:
• The base (read/write) volume name. The read-only and backup versions have the same
name with a ".readonly" and ".backup" extension, respectively.
• The volume ID numbers allocated to the versions of the volume that actually exist, in
fields labeled "RWrite" for the read/write, "ROnly" for the read-only, "Backup" for
the backup, and "RClone" for the ReleaseClone. (If a field does not appear, the
corresponding version of the volume does not exist.) The appearance of the "RClone"
field normally indicates that a release operation did not complete successfully; the
"Old release" and "New release" flags often also appear on one or more of the site
definition lines described just following.
• The number of sites that house a read/write or read-only copy of the volume, following
the string "number of sites ->".
• A line for each site that houses a read/write or read-only copy of the volume,
specifying the file server machine, partition, and type of volume ("RW" for read/write
or "RO" for read-only). If a backup version exists, it is understood to share the
read/write site. Several flags can appear with a site definition:
Not released
Indicates that the vos release command has not been issued since the vos addsite
command was used to define the read-only site.
Old release
Indicates that a vos release command did not complete successfully, leaving the
previous, obsolete version of the volume at this site.
New release
Indicates that a vos release command did not complete successfully, but that this
site did receive the correct new version of the volume.
• If the VLDB entry is locked, the string "Volume is currently LOCKED", as well as (in
OpenAFS 1.5.75 and later) one or more of the following strings:
Volume is locked for a move operation
Indicates that the volume was locked due to a vos move or a vos convertROtoRW
command.
Volume is locked for a release operation
Indicates that the volume was locked due to a vos release command.
Volume is locked for a backup operation
Indicates that the volume was locked due to a vos backup command.
Volume is locked for a delete/misc operation
Indicates that the volume was locked due to a vos delentry, vos addsite, vos
remsite, vos changeloc, vos syncvldb, vos syncserv, vos rename, or vos lock
command.
Volume is locked for a dump/restore operation
Indicates that the volume was locked due to a vos dump or vos restore command.
For further discussion of the "New release" and "Old release" flags, see vos_release(1).
EXAMPLES
The following command displays VLDB information for the Example Corporation volume called
"usr", which has two read-only replication sites:
% vos listvldb -name usr
usr
RWrite: 5360870981 ROnly: 536870982 Backup: 536870983
number of sites -> 3
server fs1.example.com partition /vicepa RO Site
server fs3.example.com partition /vicepa RO Site
server fs2.example.com partition /vicepb RW Site
The following example shows entries for two of the volumes that reside on the file server
machine "fs4.example.com". The first VLDB entry is currently locked. There are 508 entries
that mention the machine as a volume site.
% vos listvldb -server fs4.example.com
VLDB entries for server fs4.example.com
. . . .
. . . .
user.smith
RWrite: 278541326 ROnly: 278541327 Backup: 278542328
number of sites -> 1
server fs4.example.com partition /vicepg RW Site
Volume is currently LOCKED
user.terry
RWrite 354287190 ROnly 354287191 Backup 354287192
number of sites -> 1
server fs4.example.com partition /vicepc RW Site
. . . .
. . . .
Total entries: 508
PRIVILEGE REQUIRED
None
SEE ALSO
vos(1), vos_examine(1), vos_listvol(1), vos_lock(1), vos_unlock(1), vos_unlockvldb(1)
COPYRIGHT
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted
from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by
Alf Wachsmann and Elizabeth Cassell.