Use obtar -t
to list the names of files and directories contained in a backup image. You can list the entire contents of a backup image or just part of the backup image. You can catalog a backup image by specifying -Gt
. Note that obtar -t
does not list or import NDMP backups.
obtar -t [ -f device ] [ -F { cur | file-number } ] [ -Gvz ] [ pathname ]...
You can specify a number of options with obtar -t
; this section describes those options that you are most likely to use. Refer to "obtar Options" to learn about additional obtar -t
options.
device
Specifies the name of a device. If you do not specify -f
, then obtar
reads from the device specified by the TAPE
environment variable, if it is defined.
cur
| file-number
}Specifies the number of the backup image on the volume set. If the file is on a volume different from the one currently loaded, then obtar
prompts you to make any required volume changes. If you do not specify -F
, then obtar
reads the backup image at the current position of the volume.
If you specify cur
, then obtar
reads the backup image at the volume's current position. This is the default.
If you specify file-number, then obtar
reads the backup image at the specified file position.
Displays additional information about the contents of the backup image. The output is similar to that of the UNIX ls -l
command. The additional information includes file and directory permissions, owner, size, and date of last modification.
pathname
Specifies one or more path names of files or directories you want listed. If you specify a directory, then obtar
recursively lists the contents of the directory. If you do not specify any path name arguments, then obtar
lists the entire contents of the backup image at the volume's current location or at the location you specify with the -F
option.
Displaying the Contents of a Backup Image
Example 4-21 displays the contents of the backup image located at the current position of the volume loaded on device tape1
.
Example 4-21 Displaying the Contents of a Backup Image
# obtar -t -f tape1 project/ project/file1 project/file2 project/file3
Displaying the Contents of an Image on a Volume Set
To display the contents of a particular backup image on a volume set, use the -F
option. Example 4-22 displays the contents of backup image 4.
Example 4-22 Displaying the Contents of a Backup Image on a Volume Set
# obtar -t -f tape1 -F 4 doc/ doc/chap1 doc/chap2 test/ test/file1 test/file2
Displaying Additional Information About a Backup Image
To display additional information about a backup image, use the -v
option. Example 4-23 uses the -v
option to display additional information about backup image 4.
Example 4-23 Displaying Additional Information About a Backup Image
# obtar -t -v -f tape1 -F 4 drwxrwxr-x jane/rd 0 Feb 24 16:53 2000 doc/ -rw-r--r-- jane/rd 225 Feb 24 15:17 2000 doc/chap1 -rwxrwxr-x jane/rd 779 Feb 24 15:17 2000 doc/chap2 drwxrwxr-x jane/rd 0 Feb 24 16:55 2000 test/ -rwxrwxr-x jane/rd 779 Feb 24 16:54 2000 test/file1 -rw-r--r-- jane/rd 225 Feb 24 16:54 2000 test/file2
Displaying Information About a File in an Image
To display information about a particular file or directory that is contained in the backup image, include the file or directory name as the last argument on the command line. Example 4-24 displays information about the directory test
, which is contained in backup image 4.
Example 4-24 Displaying Information About a File in an Image
# obtar -t -f tape1 -F 4 test test/ test/file1 test/file2
Displaying Information About Multiple Directories
You can specify more than one path name from the backup image. Example 4-25 displays information about the directories test
and doc
. obtar
lists the directories in the order they appear in the backup image.
Example 4-25 Displaying Information About Multiple Directories
# obtar -t -f tape1 -F 4 test doc doc/ doc/chap1 doc/chap2 test/ test/file1 test/file2
Use the -z
option to display the volume label along with the contents of the backup image. Example 4-26 illustrates this technique.
Example 4-26 Displaying the Volume Label
# obtar -t -z -f tape1 -F 5 Volume label: Volume ID: VOL000003 Volume sequence: 1 Volume set owner: jane Volume set created: Mon Mar 1 19:44:05 2000 Archive label: File number: 5 File section: 1 Owner: jane Client host: campy Backup level: 0 S/w compression: no Archive created: Mon Mar 1 19:44:05 2000 test1/ test1/file1 test1/file2
Use the -G
option to catalog the contents of a backup image. Example 4-27 catalogs backup image 1 on the volume loaded into tape drive tape1
(only partial output is shown). In Example 4-27, the image contains a file system backup. Note that you can only catalog one backup image at a time.
Example 4-27 Cataloging a File System Backup Image
# obtar -f tape1 -tG -F 1 Volume label: Volume tag: DEV100 Volume ID: VOL000001 Volume sequence: 1 Volume set owner: root Volume set created: Tue Nov 22 15:57:36 2005 Archive label: File number: 1 File section: 1 Owner: root Client host: stadf56 Backup level: 0 S/w compression: no Archive created: Tue Nov 22 15:57:36 2005 /home/someuser/ /home/someuser/.ICEauthority /home/someuser/.Xauthority /home/someuser/.aliases /home/someuser/.bash_history /home/someuser/.bash_logout /home/someuser/.bash_profile /home/someuser/.bashrc . . .
Example 4-28 also catalogs backup image 1 on the volume loaded into tape drive tape1
. In this example, the image contains an RMAN backup of archived redo logs.
Example 4-28 Cataloging an RMAN Backup Image
# obtar -f tape1 -tG -F 1 Volume label: Volume tag: ADE202 Volume ID: RMAN-DEFAULT-000002 Volume sequence: 1 Volume set owner: root Volume set created: Mon Feb 13 10:36:13 2006 Media family: RMAN-DEFAULT Volume set expires: never; content manages reuse Archive label: File number: 1 File section: 1 Owner: root Client host: stadv07 Backup level: 0 S/w compression: no Archive created: Mon Feb 13 10:36:13 2006 Backup piece name: 05hba0cd_1_1 Backup db name: ob Backup db id: 1585728012 Backup copy number: non-multiplexed backup Backup content: archivelog