NAME

backup_volinfo - Displays a volume's dump history from the Backup Database

SYNOPSIS

backup volinfo -volume <volume name> [-localauth] [-cell <cell name>] [-config <configuration file>] [-help]

DESCRIPTION

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.

OPTIONS

-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.

-localauth

Constructs a server ticket using a key from the local /etc/yfs/server/KeyFileExt 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 backup(8).

-config <configuration file>

Sets the location of the configuration file to be used. The default file is /etc/yfs/yfs-client.conf.

-help

Prints the online help for this command. All other valid options are ignored.

OUTPUT

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:

dumpID

The dump ID of the dump that includes the volume.

lvl

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 dump hierarchy.

parentid

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.

EXAMPLES

The following example shows part of the dump history of the Backup volume user.smith.backup:

   % 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
       .     .      .         .       .       .      .         .
       .     .      .         .       .       .      .         .

PRIVILEGE REQUIRED

None

SEE ALSO

backup(8), backup_dumpinfo(8), backup_volrestore(8)

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.

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.