lsbu

Purpose

Use the lsbu command to list cataloged backups. A catalogued backup is a backup that has completed, either successfully or with errors, and that has been logged in the Oracle Secure Backup catalog.

The lsbu command lists backup date and time, volume ID, and so forth. The ls command lists the contents of cataloged backups.

See Also:

"Browser Commands" for related commands

Prerequisites

You must have the display administrative domain's configuration right to use the lsbu command.

Syntax

lsbu::=

lsbu [ --long/-l | --short/-s ] [ --noheader/-H ]  [ --reverse/-r ]
[ --level/-L backup-level | --maxlevel/-M backup-level ]
[ --inclusions/-i [ --dependencies/-d ] ] [ --host/-h hostname ]...
[ --path/-p pathname ]... [ data-selector ]...

Semantics

--long/-l: Displays data in long form. The command displays all attributes of the backups and labels them. By default the command displays a subset of attributes in tabular format.
--short/-s: Displays data in short form. The command displays only backup IDs.
--noheader/-H: Does not display headers for columns.
--reverse/-r: Reverses the listing order.
--level/-L backup-level: Displays backups based on backup level. Refer to "backup-level" for a description of the backup-level placeholder.
--maxlevel/-M backup-level: Specifies the maximum backup level that you want to display. Refer to "backup-level" for a description of the backup-level placeholder.
-inclusions/-i: Displays the paths that were backed up.
--dependencies/-d: For each incremental backup listed, display the dependencies on predicate backups.
--host/-h hostname ...: Displays backups of client hostname.
--path/-p pathname ...: Displays backups based on file system objects.
data-selector ...: Specifies the Oracle Secure Backup catalog data that applies to an operation. Refer to "data-selector" for the data-selector placeholder.

Output

Table 2-4 describes the output for the lsbu command.

Table 2-4 lsbu Output

Label	Indicates
Backup ID	Unique identification number for a backup job; assigned by Oracle Secure Backup
Backup date & time	Starting date and time for a backup job; assigned by the scheduler
Volume ID	Unique volume name with a sequentially numbered suffix; assigned by Oracle Secure Backup
File number	The file number the backup job occupies on a tape containing multiple backups
File section	The number of times a tape is changed during a backup job that spans multiple tapes
Requested level	Defaults to `0` if no previous backup job exists for this directory; assigned by the user when the backup job is scheduled
Client	Name of the backed up client machine
Device	Name of the drive to which the backup is made
Program version	Version of Oracle Secure Backup
Volume creation	Date and time at which Oracle Secure Backup wrote backup image file number 1 to a volume.

Examples

Example 2-47 lists all cataloged backups for host brhost2.

Example 2-47 Listing Cataloged Backups for a Host

ob> lsbu --host brhost2
      Backup       Backup  Volume            Volume                             File Sect Backup
   Date and Time       ID  ID                Tag                                   #    #  Level
2005/03/18.19:36:56     1  VOL000001                                               2    1      0
2005/03/18.19:39:40     2  VOL000001                                               3    1      0
2005/03/30.17:59:38     3  VOL000002                                               1    1      0
2005/04/08.02:45:23     4  VOL000003         00000122                              2    1      0
2005/04/08.06:48:03     5  VOL000004                                               7    1      0
2005/04/08.06:48:41     6  VOL000004                                               8    1      0
2005/04/16.14:15:14     8  default-000001    00012012                              1    1      0
2005/04/16.18:33:23     9  VOL000009         00123403                              2    1      0
2005/04/29.00:25:29    10  VOL000001                                               0    0      0
2005/04/29.00:52:04    11  VOL000002                                               0    0      0

Example 2-48 lists the cataloged backups made on August 29, 2005 in long format.

Example 2-48 Listing Catalog Backups on a Specific Date

ob> lsbu --long 2005/08/29
Backup ID:          1
    Backup date & time: 2005/08/29.13:21:18
    Volume ID:          VOL000003
    Volume tag:         ADE203
    File number:        1
    File section:       1
    Requested level:    0
    Client:             brhost2
    Device:             tape1
    Program version:    10.1
    Volume creation:    2005/08/29.13:21:18