Commands Reference, Volume 3

listvgbackup Command

Purpose

Lists or restores the contents of a volume group backup on a specified media.

Syntax

listvgbackup [ -b blocks ] [ -f device ] [ -r ] [ -a ] [ -s ] [ -d path ] [ -D ] [ file_list ]

The listvgbackup command lists the contents of a volume group backup from tape, file, CD-ROM, or other source and can be used to restore files from a valid backup source. The listvgbackup command also works for multi-volume backups such as multiple CDs, DVDs, or tapes.

The listvgbackup -r and restorevgfiles commands perform identical operations and should be considered interchangeable.

Flags

-b blocks	Specifies the number of 512-byte blocks to read in a single input operation, as defined by the blocks parameter. If the blocks parameter is not specified, the number of blocks read will default to 100.
-f device	Specifies the type of device containing the backup (file, tape, CD-ROM, or other source) as defined by the device parameter. When -f is not specified, device will default to /dev/rmt0.
-r	Specifies to restore the backup files, as defined by the file-list parameter. If the file-list parameter is not specified, then all files in the backup will be restored. If the -r flag is not used, then executing the listvgbackup command only lists the files in the specified backup.
-a	Verifies the physical block size of the tape backup, as specified by the -b block flag. You may need to alter the block size if necessary to read the backup. The -a flag is valid only when a tape backup is used.
-s	Specifies that the backup source is a user volume group and not rootvg.
-d path	Specifies the directory path to which the files will be restored, as defined by the path parameter. If the -d parameter is not used, the current working directory is used. This can be a problem if the current working directory is root. We recommend writing to a temporary folder instead of to root.
-D	Produces debug output.

Parameters

file_list

Identifies the list of files to be restored. This parameter is used only when the -r flag is specified. The full path of the files relative to the current directory should be specified in the space-separated list. All files in the specified directory will be restored unless otherwise directed. If you are restoring all files in a directory, we recommend writing to a temporary folder instead of to root.

Examples

To list the contents of the system backup located on the default device /dev/rmt0, enter:
```
listvgbackup
```
To list the contents of the system backup located on device /dev/cd1, enter:
```
listvgbackup -f /dev/cd1
```
To list the contents of the system backup located on device /dev/cd1, which is a user volume group that is not rootvg, enter:
```
listvgbackup -f /dev/cd1 -s
```
To restore /etc/filesystems from the system backup located on device /dev/cd1, enter:
```
listvgbackup -f /dev/cd1 -r ./etc/filesystems
```
To restore all files in the /myfs/test directory of the non-rootvg backup, which is located on device /dev/cd1, and write the restored files to /data/myfiles, enter:
```
listvgbackup -f /dev/cd1 -r -s -d /data/myfiles ./myfs/test
```

Files

/usr/bin/listvgbackup

Contains the listvgbackup command

Related Information

The restorevgfiles command.