cd

Purpose

Use the cd command to change the directory that you are browsing in the Oracle Secure Backup catalog. Options to the cd command affect subsequent ls and restore commands.

Browsing the catalog is equivalent to browsing the contents of backup images. The obtool utility displays the contents of the images in a directory structure much like a live file system. You can only browse directories whose contents have been backed up.

Prerequisites

The rights needed to run the cd command depend on the browse backup catalogs with this access setting for the class.

Syntax

cd::=

cd [ --host/-h hostname ] [ --viewmode/-v viewmode ]
[ --select/-s data-selector[,data-selector]... ] 
[ pathname ]

Semantics

--host/-h hostname

Defines the name of the host machine assigned with the mkhost or renhost commands. You must set the host before you can browse its file system in the Oracle Secure Backup catalog. You can also use the set host command to set the host.

--viewmode/-v viewmode

Specifies the mode in which to view directory contents in the Oracle Secure Backup catalog. The cd command remains in viewmode until you change it to a new setting.

Valid values for viewmode are as follows:

• exact makes visible only those directory entries that match the data selector.

• inclusive makes visible all entries regardless of the current data selector (default).

--select/-s data-selector ...

Specifies the Oracle Secure Backup catalog data that applies to an operation. Refer to "data-selector" for the data-selector placeholder.

Note that the data selector values specified by cd do not have an effect on the lsbu command, which lists all backups unless a data-selector is specified by lsbu.

pathname

Specifies the path name to browse in the Oracle Secure Backup catalog.

Example

Example 2-14 sets the host to brhost2, changes into the root directory of the Oracle Secure Backup catalog, and displays its contents.

ob> cd --host brhost2
ob> cd /
ob> ls
/home