backup_volinfo - Displays a volume's dump history from the Backup Database
backup volinfo -volume
backup voli -v
The backup volinfo
command displays a dump history of the specified
volume, reporting information such as the date on which the volume was dumped
and the tapes that contain it. Include the ".backup" extension on
the volume name if the backup version of the volume was dumped.
- -volume <volume name>
- Names the volume for which to display the dump history.
Include the ".backup" or ".readonly" extension if the
backup or read-only version of the volume was dumped.
- Constructs a server ticket using a key from the local
/etc/openafs/server/KeyFile file. The backup command
interpreter presents it to the Backup Server, Volume Server and VL Server
during mutual authentication. Do not combine this flag with the
-cell argument. For more details, see backup(8).
- -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
- Prints the online help for this command. All other valid
options are ignored.
The output includes a line for each Backup Database dump record that mentions
the specified volume, order from most to least recent. The output for each
record appears in a table with six columns:
- The dump ID of the dump that includes the volume.
- The depth in the dump hierarchy of the dump level at which
the volume was dumped. A value of 0 indicates a full dump. A value of 1 or
greater indicates an incremental dump made at the specified depth in the
- The dump ID of the dump's parent dump. A value of 0
indicates a full dump, which has no parent; in this case, the value in the
"lvl" column is also 0.
- creation date
- The date and time at which the Backup System started the
dump operation that created the dump.
- clone date
- For a backup or read-only volume, the time at which it was
cloned from its read/write source. For a read/write volume, the same as
the value in the "creation date" field.
- tape name
- The name of the tape containing the dump: either the
permanent tape name, or an AFS tape name in the format
volume_set_name. dump_level_name.tape_index where
volume_set_name is the name of the volume set associated with the
initial dump in the dump set of which this tape is a part;
dump_level_name is the name of the dump level at which the initial
dump was backed up; tape_index is the ordinal of the tape in the
dump set. Either type of name can be followed by a dump ID in parentheses;
if it appears, it is the dump ID of the initial dump in the dump set to
which this appended dump belongs.
The following example shows part of the dump history of the Backup volume
% backup volinfo -volume user.smith.backup
DumpID lvl parentID creation date clone date tape name
924600000 1 924427600 04/20/1999 05:20 04/20/1999 05:01 user_incr_2 (924514392)
924514392 1 924427600 04/19/1999 05:33 04/19/1999 05:08 user_incr_2
924427600 0 0 04/18/1999 05:26 04/18/1999 04:58 user_full_6
. . . . . . . .
. . . . . . . .
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.