restwparfiles Command
Purpose
Restores files from a workload partition backup source.
Syntax
restwparfiles [ -b blocks ] [ -f device ] [ -a ] [ -m ] [ -n ] [ -d path ] [ -D ] [-V] [ file_list ]
Description
The restwparfiles command restores files from tape, file, CD-ROM, or other workload partition backup source. The restwparfiles command also works for multivolume backups such as multiple CDs, DVDs, USB disks, or tapes.
Flags
| Item | Description |
|---|---|
| -a | Verifies the physical block size of the tape backup, as specified by the -b blocks flag. You might need to alter the block size to read the backup. The -a flag is valid only when you specify the device in the -f flag as tape. |
| -b blocks | Specifies the number of 512-byte blocks to read in a single input operation, as defined by the blocks parameter. If you do not specify the blocks parameter, the default number of blocks to read is 100. |
| -d path | Specifies the directory path where the files
are restored, as defined by the path parameter. If you do not
specify the -d flag, the current working directory is used.
Restriction: The directory path where
the files are restored must not be root (/) in the global environment,
either through the use of -d / or if the current working directory
is / and the -d flag is not specified.
|
| -D | Produces debug output. |
| -f device | Specifies the device containing the backup (file, tape, CD-ROM, or other source) as defined by the device parameter. When you do not specify the -f flag, the default device is /dev/rmt0. |
| -m | Restores only informational and control files from the image. Use the flag to restore the image.data and wpar.spec files from the backup image. Files are restored under the ./.savewpar_dir/ directory. |
| -n | Specifies that ACLs, PCLs, or extended attributes are not to be restored. |
| -V | Verifies a tape backup. The -V flag requires the -f device flag and can be used to specify only tape devices. The -V flag causes the restwparfiles command to verify the readability of each file header on the volume group backup and print any errors that occur to the standard error log (stderr) file. |
Parameters
| Item | Description |
|---|---|
| file_list | Identifies the list of files to be restored. Specify the full path of the files relative to the current directory in the space-separated list. All files in the specified directory are restored unless directed. If you are restoring all files in a directory, write to a temporary folder instead of the root directory. |
Examples
- To read the backup stored on the /dev/cd1 device and restore
all files to the /data/myfiles directory, enter the following
command:
restwparfiles -f /dev/cd1 -d /data/myfiles - To read the backup from the default device at twenty 512-byte
blocks at a time and restore the /myapp/app.c file to the current
directory, enter the following command:
restwparfiles -b 20 ./myapp/app.h - To read the backup stored on the /dev/cd1 device and restore
the /myapp/app.c file to the /data/testcode directory,
enter the following command:
restwparfiles -f /dev/cd1 -d /data/testcode ./myapp/app.c - To read the backup stored at /dev/usbms0 and restore all
files to the /data/myfiles directory, enter the following command:
restwparfiles –f /dev/usbms0 –d /data/myfiles