obtar -t

Purpose

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.

Syntax

obtar -t::=

obtar -t [ -f device ]
[ -F { cur | file-number } ]
[ -Gvz ]
[ pathname ]...

Semantics

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.

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

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

-v

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.

-z

Displays the volume label of the backup image.

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.

Examples

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

Displaying the Volume Label

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

Cataloging a Backup Image

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