bplist

bplist — list the backed up and archived files on the NetBackup server

SYNOPSIS

<nbu_dir_path>bplist [-A | -B] [-C client] [-S master_server] [-k policy] [-t policy_type] [-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-flops options] [-Listseconds] [-T] [-unix_files] [-nt_files] [-s date] [-e date] [-I] [-PI] [-keyword keyword_phrase] [filename] [-Listpolicy]

On Windows systems, <nbu_dir_path> is <install_path>\NetBackup\bin\

DESCRIPTION

The bplist command shows a list of previously archived or backed up files according to the options that you specify. You can choose the file or directory and the time period that you want the listing to cover. Directories can be recursively displayed to a specified depth. bplist shows only the files that you have read access to. It lists the files only if an administrator account performs the user backup.

You also must own or have read access to all directories in the file paths. You can list the files that were backed up or archived by another client only if the NetBackup administrator has validated you to do so.

If you create the following directory with public-write access, bplist creates a debug log file in this directory that you can use for troubleshooting:

Windows systems: install_path\NetBackup\logs\bplist\

OPTIONS

-A | -B

Specifies whether to produce the listing from archives (-A) or backups (-B). The default is -B.

-C client

Specifies a client name to use for finding backups or archives to list. This name must be as it appears in the NetBackup configuration. The default is the current client name.

-S master_server

Windows systems: -s specifies the name of the NetBackup server. The default is the server designated as current on the Servers tab of the Specify NetBackup Machines dialog box. To display this dialog box, start the Backup, Archive, and Restore user interface on the client. Then click Specify NetBackup Machines on the File menu.

-t policy_type

Specifies one of the following numbers that correspond to the policy type. The default is 0 for all clients except Windows, where the default is 13.

0 = Standard

4 = Oracle

6 = Informix-On-BAR

7 = Sybase

8 = MS-SharePoint

10 = NetWare

13 = MS-Windows

14 = OS/2

15 = MS-SQL-Server

16 = MS-Exchange-Server

19 = NDMP

35 = NBU-Catalog

The following policy types apply only to NetBackup Enterprise Server.

11 = DataTools-SQL-BackTrack

17 = SAP

18 = DB2

20 = FlashBackup

21 = Split-Mirror

22 = AFS

25 = Lotus Notes

39 = Enterprise-Vault

-k policy

Names the policy to search to produce the list. If not specified, all policies are searched.

-F

Specifies that in the list output, symbolic links (which apply only to UNIX clients) end with a trailing @ and executable files with a trailing *.

-R [n]

Recursively lists the subdirectories that are encountered to a depth of n. The default for n is 999.

-b | -c | -u

Specifies an alternate date-time to be used for printing with the -l option:

-b displays the backup date and time of each file.

-c displays the last inode modification date and time (UNIX and Linux systems) or creation date and time (Windows systems) for each file.

-u displays the last access date and time of each file.

The default is to display the time of the last modification of each file.

-l

On Windows systems, -l shows the file details.

-Listseconds

Specifies that seconds granularity be used for the timestamp when the -l option is used.

-r

On Windows systems, -r lists the disk images that were backed up. The default is to list file systems.

-flops options

Lists Backup Exec files or both Backup Exec and NetBackup files. The default (-flops not specified) is to list only NetBackup files.

To list only Backup Exec files specify:

-flops 524288

To list Backup Exec and NetBackup files specify:

-flops 1048576
-T

Lists the directories in true-image backups. The default is to list non-true-image backups.

Note:

TIR information does not appear for synthetic full backups, even though TIR information is used for synthetic full backups.

-unix_files

Lists the files and directories in UNIX format. This option applies only to UNIX and Linux. For example: /C/users/test

-nt_files

Lists the files and directories in Windows format. This option applies only to Windows. For example: C:\users\test

-s date, -e date

Specifies the start date (-s) and end date (-e) for the listing.

-s specifies a start date and time for the listing. The resulting list shows only files in backups or the archives that occurred at or after the specified date and time.

The required date and time values format in NetBackup commands varies according to your locale. The /user/openv/msg/.conf file (UNIX and Linux) and the install_path\VERITAS\msg\LC.CONF file (Windows) contain information such as the date-time formats for each supported locale. The files contain specific instructions on how to add or modify the list of supported locales and formats.

More information is available about the locale of your system.

See the "Specifying the locale of the NetBackup installation" topic in the NetBackup Administrator's Guide, Volume II.

The valid range of dates is from 01/01/1970 00:00:00 to 01/19/2038 03:14:07. The default is the current date minus six months.

-e specifies an end date and time for the listing. The resulting list shows only files from the backups or the archives that occurred at or before the specified date and time. Use the same format for start date and time. The default is the current date and time.

-I

Specifies a search that is case insensitive. The capitalization is not considered when it compares names (for example, Cat matches cat).

-PI

Specifies a path-independent search, which means that NetBackup searches for a specified file or directory without regard to the path. For example, a file with the name test exists in the three following directories. A search for test finds all three instances of the file:

Windows systems:

\tmp\junk\test
\abc\123\xxx\test
\abc\123\xxx\yyy\zzz\test
-keyword keyword_phrase

Specifies a keyword phrase for NetBackup to use when it searches for backups or archives from which to restore files. The phrase must match the one that was previously associated with the backup or archive by the -k option of bpbackup or bparchive.

You can use this option in place of or in combination with the other restore options to make it easier to restore backups and archives. Use the following meta-characters to help match keywords or parts of keywords in the phrase:

* matches any string of characters.

? matches any single character.

[ ] matches one of the sequence of characters that is specified within the brackets.

[ - ] matches one of the range of characters, that is separated by the "-".

The keyword phrase can be up to 128 characters in length. All printable characters are permitted including space ("") and period (".").

The phrase must be enclosed in double quotes ("...") or single quotes ('...' ).

The default keyword phrase is the null (empty) string.

Note:

The keyword phrase is ignored when you use the following policy types: DB2, Informix-On-BAR, Oracle, SAP, MS-SQL-Server, Sybase.

filename

Names the file or directory to list. Any files or directories that you specify must be listed at the end, following all other options. If you do not specify a path, the default is the current working directory.

For Windows systems, use uppercase for the drive letter. For example:

C:\NetBackup\log1

For directories, if you do not use the -R option, include the trailing path separator as in the following:

Windows systems: bplist -l "D:\WS_FTP.LOG\*"

If you use the asterisk meta-character (*), use quotation marks around the file name for the command to work properly.

-Listpolicy

Includes the schedule type and policy name in the command output.

EXAMPLES

EXAMPLE 1

Lists recursively in long format, the files that were backed up in /home/usr1 (UNIX and Linux) or D:\WS_RTP.LOG (Windows).

On Windows systems:

# bplist -l -R D:\WS_FTP.LOG 
	-rwx------  bjm;usr@	bjm;None  64  Oct 10  2009 D:\WS_FTP.LOG
	-rwx------  bjm;usr@	bjm;None  64  Oct 10  2009 D:\WS_FTP.LOG
	-rwx------  bjm;usr@	bjm;None  64  Oct 10  2009 D:\WS_FTP.LOG

EXAMPLE 2

Lists the files that were backed up and associated with all or part of the keyword phrase "MyHomeDirectory".

Windows: # bplist -keyword "*MyHomeDirectory*" -l C:\home\kwc\

EXAMPLE 3

Lists the files that were archived and associated with all or part of the keyword phrase "MyHomeDirectory"

Windows: # bplist -A -keyword "*MyHomeDirectory*" -l C:\home\kwc\

EXAMPLE 4

Lists recursively and with details the output from bplist on a Windows master server from a Windows client. Enter the following command to list the files that were backed up on drive D of Windows client slater and associated with all or part of the keyword phrase "Win NT":

# bplist -keyword "*Win NT*" -C slater -R -l C:\client_data_2

drwx------ root;usr@ root;None  0 Aug 28 17 C:\client_data_2\
-rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt
drwx------ root;usr@ root;None  0 Aug 28 17 C:\client_data_2\
-rwx------ root;usr@ root;None 40 Aug 05 24 C:\client_data_2\ewr.txt

The user column (root;usr@) for the Windows images displays the user that backed up the file and the owner@domain separated by a semicolon. The group column (root;None) for the Windows images is the group that backed up the file and the group@domain separated by a semicolon.

FILES

Windows systems: install_path\NetBackup\logs\bplist\*.log

SEE ALSO

bp, bparchive, bpbackup, bprestore