backup_volinfo man page on Scientific

Man page or keyword search:  
man Server   26626 pages
apropos Keyword Search (all sections)
Output format
Scientific logo
[printable version]

BACKUP_VOLINFO(8)	     AFS Command Reference	     BACKUP_VOLINFO(8)

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

SYNOPSIS
       backup volinfo -volume <volume name> [-localauth]
	   [-cell <cell name>] [-help]

       backup voli -v <volume name>
	   [-l] [-c <cell name>] [-h]

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
	   /usr/afs/etc/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 backup(8).

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

OpenAFS				  2013-10-09		     BACKUP_VOLINFO(8)
[top]

List of man pages available for Scientific

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net