Purpose
Displays information from a volume header
Synopsis
vos listvol -server <machine name> [-partition <partition name>]
[-fast] [-long] [-quiet] [-extended] [-cell <cell name>]
[-noauth] [-localauth] [-verbose] [-help]
vos listvo -s <machine name> [-p <partition name>] [-f] [-lon]
[-q] [-e] [-c <cell name>] [-n] [-loc] [-v] [-h]
Description
The vos listvol command formats and displays the following information from the volume header of each specified volume: volume name, volume ID, volume type, size, and status at the server. The actual information displayed depends on the combination of arguments supplied when the command is issued. To display volume header information for various numbers of volumes, combine the command's arguments as indicated:
To display the Volume Location Database (VLDB) entry for one or more volumes, use the vos listvldb command. To display both the VLDB entry and the volume header for a single volume, use the vos examine command.
Options
This argument can be combined with the -partition argument, as well as the -fast, -long, or -extended flag.
Output
The output is ordered alphabetically by volume name and by default provides the following information on a single line for each volume:
If the following message appears instead of the previously listed information, it indicates that a volume is not accessible to Cache Managers or the vos command interpreter, for example because a clone is being created.
**** Volume volume_ID is busy ****
If the following message appears instead of the previously listed information, it indicates that the File Server is unable to attach the volume, perhaps because it is seriously corrupted. The FileLog and VolserLog log files in the /usr/afs/logs directory on the file server machine possibly provide additional information; use the bos getlog command to display them.
**** Could not attach volume volume_ID ****
The information about individual volumes is bracketed by summary lines. The first line of output specifies the number of volumes in the listing. The last line of output summarizes the number of volumes that are online, offline, and busy. These lines do not appear if the -quiet flag is used.
If the -fast flag is added, the output displays only the volume ID number of each volume, arranged in increasing numerical order. The final line (which summarizes the number of online, offline, and busy volumes) is omitted.
If the -long flag is included, the output for each volume includes all of the information in the default listing plus the following. Each item in this list corresponds to a separate line of output:
If the -extended flag is included, the output for each volume includes all of the information reported with the -long flag, plus two tables of statistics:
Examples
The following example shows the output for the /vicepb partition on the file server machine fs2.abc.com when no flags are provided:
% vos listvol -server fs2.abc.com -partition b
Total number of volumes on server fs2.abc.com \
partition /vicepb : 66
sys 1969534847 RW 1582 K On-line
sys.backup 1969535105 BK 1582 K On-line
. . . . . .
. . . . . .
user.pat 1969534536 RW 17518 K On-line
user.pat.backup 1969534538 BK 17537 K On-line
Total volumes onLine 66 ; Total volumes offLine 0 ; Total busy 0
The following example shows the output when the -fast flag is added:
% vos listvol -server fs2.abc.com -partition b -fast
Total number of volumes on server fs2.abc.com \
partition /vicepb : 66
1969516782
1969516784
.
.
1969535796
The following example shows two volumes from the output that appears when the -long flag is added:
% vos listvol -server fs2.abc.com -partition b -long
Total number of volumes on server fs2.abc.com \
partition /vicepb: 66
. . . . . .
. . . . . .
user.pat 1969534536 RW 17518 K On-line
fs2.abc.com /vicepb
RWrite 1969534536 ROnly 0 Backup 1969534538
MaxQuota 20000 K
Creation Mon Jun 12 09:02:25 1989
Last Update Thu May 20 17:39:34 1999
1573 accesses in the past day (i.e., vnode references)
user.pat.backup 1969534538 BK 17537 K On-line
fs2.abc.com /vicepb
RWrite 1969534536 ROnly 0 Backup 1969534538
MaxQuota 20000 K
Creation Tue Jun 13 04:37:59 1989
Last Update Wed May 19 06:37:59 1999
0 accesses in the past day (i.e., vnode references)
. . . . . .
. . . . . .
Total volumes onLine 66 ; Total volumes offLine 0 ; \
Total busy 0
Privilege Required
None
Related Information