RMAN LIST

List the backups and copies recorded in the repository. Some options below require the Data Recovery Advisor introduced in 11g (List Failure, List Restore Point.)

Syntax:

 LIST DB_UNIQUE_NAME ALL

 LIST DB_UNIQUE_NAME OF DATABASE [['] database_name [']]

 LIST [EXPIRED]
     {archivelogRecordSpecifier
       [ { {maintQualifier | RECOVERABLE [untilClause} }…] [forDbUniqueNameOption]

 LIST [EXPIRED]
     {BACKUP [OF listObjectList] [BY BACKUP] [VERBOSE] 
       [ { {maintQualifier | RECOVERABLE [untilClause} }…] [forDbUniqueNameOption]

 LIST [EXPIRED]
     {BACKUP [OF listObjectList] SUMMARY
       [ { {maintQualifier | RECOVERABLE [untilClause} }…] [forDbUniqueNameOption]

 LIST [EXPIRED]
     {BACKUP [OF listObjectList] BY { BACKUP SUMMARY | FILE }
       [ { {maintQualifier | RECOVERABLE [untilClause} }…] [forDbUniqueNameOption]

 LIST [EXPIRED]
     {COPY [OF listObjectList] 
       [ { {maintQualifier | RECOVERABLE [untilClause} }…] [forDbUniqueNameOption]

 LIST [EXPIRED] recordSpec [forDbUniqueNameOption];

 LIST FAILURE [ {ALL | CRITICAL | HIGH | LOW | failureNumber [, failureNumber]…}
    [EXCLUDE FAILURE failureNumber [, failureNumber]…] [DETAIL]

 LIST FAILURE [CLOSED] [ {ALL | CRITICAL | HIGH | LOW | failureNumber} ]
    [EXCLUDE FAILURE failureNumber [, failureNumber]…] [DETAIL]

 LIST INCARNATION [OF DATABASE [['] database_name [']]]

 LIST RESTORE POINT restore_point_name [forDbUniqueNameOption]

 LIST RESTORE POINT ALL [forDbUniqueNameOption]

 LIST ALL SCRIPT NAMES
 LIST GLOBAL SCRIPT NAMES


forDbUniqueNameOption::=
  FOR DB_UNIQUE_NAME ALL
  FOR DB_UNIQUE_NAME 'db_unique_name'

 listObjectList::=
   [ DATAFILE datafileSpec [, datafileSpec]… 
   | TABLESPACE ['] tablespace_name ['] [, ['] tablespace_name [']]…
   | archivelogRecordSpecifier 
   | DATABASE [SKIP TABLESPACE ['] tablespace_name ['] 
     [, ['] tablespace_name [']]…] 
   | CONTROLFILE
   | SPFILE
   ]…

 listBackupOption::=
   [ [BY BACKUP] [VERBOSE]
   | SUMMARY
   | BY { BACKUP SUMMARY | FILE }
   ] 

Examples

RMAN> LIST ARCHIVELOG ALL;
RMAN> LIST BACKUP OF ARCHIVELOG ALL;
RMAN> LIST BACKUP;
RMAN> LIST BACKUP OF DATABASE;
RMAN> LIST BACKUP OF DATAFILE 1;
RMAN> LIST BACKUP SUMMARY;
RMAN> LIST INCARNATION;
RMAN> LIST BACKUP BY FILE;
RMAN> LIST COPY OF DATABASE ARCHIVELOG ALL;
RMAN> LIST COPY OF DATAFILE 1, 2, 3;
RMAN> LIST BACKUP OF DATAFILE 11 SUMMARY;
RMAN> LIST BACKUP OF ARCHIVELOG FROM SEQUENCE 1437;
RMAN> LIST CONTROLFILECOPY "/tmp/cntrlfile.copy";
RMAN> LIST BACKUPSET OF DATAFILE 1;
RMAN> LIST FAILURE;
RMAN> LIST FAILURE 641231 detail;

“I see no reason for recording the obvious” ~ Edward Weston

Related Oracle Commands:

BACKUP - Back up database files, archive logs, backups, or copies.
CHANGE - Update the status of a backup in the RMAN repository.
CROSSCHECK - Check whether backup items still exist.
DELETE - Delete backups from disk or tape
REPORT - Report backup status: database, files, backups
RESTORE - Restore RMAN backups and copies.
ADVISE FAILURE - Display repair options (11g Data Recovery Advisor)
REPAIR FAILURE - Repair database failures (11g Data Recovery Advisor)

Related Views:

 RC_BACKUP_SET    V$BACKUP_SET    Backup sets
 RC_BACKUP_SPFILE V$BACKUP_SPFILE Server parameter files in backup sets
 RC_BACKUP_FILES  V$BACKUP_FILES  RMAN backups and copies in the repository.
 RC_BACKUP_PIECE  V$BACKUP_PIECE  Backup pieces

Datafiles:
 RC_TABLESPACE      V$TABLESPACE      All tablespaces registered in the recovery catalog.
 RC_DATAFILE        V$DATAFILE        All datafiles registered in the recovery catalog
 RC_BACKUP_DATAFILE V$BACKUP_DATAFILE Datafiles in backup sets
 RC_DATAFILE_COPY   V$DATAFILE_COPY   Datafile image copies
 RC_PROXY_DATAFILE  V$PROXY_DATAFILE  Datafile backups created by proxy copy

Control Files:
 RC_BACKUP_CONTROLFILE V$BACKUP_DATAFILE Control files in backup sets
 RC_PROXY_CONTROLFILE  V$PROXY_DATAFILE  Control file backups created by proxy copy
 RC_CONTROLFILE_COPY   V$DATAFILE_COPY   Control file copies on disk