/usr/openv/netbackup/bin/bplist [-A | -B] [-C client] [-S master_server] [-t
policy_type] [-k policy] [-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-flops
file_options] [-Listseconds] [-T] [-unix_files] [-nt_files] [-s date] [-e
date] [-I] [-PI] [-help] [-keyword "keyword_phrase"] [filename]
bplist 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 dis-
played to a specified depth.
The list shows only the files that you have read access to. You also must own or
have read access to all directories in the file paths. You can list files that
were backed up or archived by another client only if you are validated to do so
by the NetBackup administrator.
If you create directory /usr/openv/netbackup/logs/bplist/ with public-write
access, bplist creates an debug log file in this directory that you can use for
The output of bplist goes to standard output.
-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.
Specifies the name of the NetBackup server. The default is the first
SERVER entry found in the /usr/openv/netbackup/bp.conf file.
Specifies one of the following numbers corresponding to the policy
type. The default is 0 for all clients except Windows NT/2000, where
the default is 13.
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
10 = NetWare
13 = MS-Windows-NT/2000
18 = DB2
20 = FlashBackup
21 = Split-Mirror
22 = AFS
-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 (applies only to
UNIX clients) will end with a trailing @ and executable files with a
-R [n] Recursively lists subdirectories encountered to a depth of n. The
default for n is 999.
-b | -c | -u
Specifies an alternate date and time to be used for printing with the
-b displays the backup date and time of each file.
-c displays the last inode modification date and time 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
-l Lists in long format, giving mode, owner, group, size in bytes, and
time of last modification for each file (see the EXAMPLES section of
this man page). The list shows the mode of each file as 10 characters
that represent the standard UNIX file permissions. The first character
is one of the following:
d (specifies a directory)
l (specifies a link)
- (specifies a file)
The next nine characters show the three sets of permissions. The first
set shows the owner's permissions, the next set shows the user-group
permissions, and the last set shows permissions for all other users.
Each set of three specifies the read, write, and execute permissions
r means the file is readable
w means the file is writable
NetBackup files to be listed. The default (-flops not specified) is to
list only NetBackup files.
To list only Backup Exe files specify:
To list Backup Exe and NetBackup files specify:
-T Lists directories in true-image backups. The default is to list non-
Note: TIR information will not appear for synthetic full backups, even
though TIR information is used for sythetic full backups.
Lists the files and directories in UNIX format. For example:
-nt_files Lists the files and directories in Windows format. For example:
-e date Specifies the start and end date range for the listing.
-s specifies a start date and time for the listing. The resulting list
shows only files in backups or archives that occurred at or after the
specified date and time.
The format of date depends on the user's locale setting. See the NOTES
section for more information. For the C locale, the date syntax is as
The valid range of dates are 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 backups or archives that occurred at or before
the specified date and time. Use the same format as explained above
for start date and time. The default is the current date and time.
-I Specifies a case-insensitive search. This means that capitalization is
not considered when comparing 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, if a file named test exists in the three directories
the one that was previously associated with the backup or archive by
the -k option of the bpbackup or bparchive command. You can use this
option in place of or in combination with the other restore options in
order to make it easier to restore your backups and archives. The fol-
lowing meta characters can be used to simplify the task of matching
keywords or parts of keywords in the phrase: * matches any string of
characters. ? matches any single character. [ ] matches one of the
sequence of characters specified within the brackets. [ - ] matches
one of the range of characters separated by the "-". The keyword
phrase can be up to 128 characters in length. All printable charac-
ters are permitted including space (" " ) and period ("."). The phrase
must be enclosed in double quotes ("...") or single quotes (`...' ) to
avoid conflict with the UNIX shell. The default keyword phrase is the
null (empty) string.
filename Names the file or directory to list. If you do not specify a path, the
default is the current working directory. Any files or directories
that you specify must be listed at the end, following all other
options. For directories, if you do not use the -R option, include
the trailing path separator (/) as in the following: bplist -l
Note: If you are using the asterisk meta character "*", you should use
quotation marks around the filename for the command to work properly.
The format that you must use for date and time values in NetBackup commands
varies according to the locale setting.
If you are uncertain of the NetBackup command requirements for your locale,
enter the command with the -help option and check the usage. The following is
part of the bplist usage output that shows the -s and -e options:
[-s mm/dd/yy hh:mm:ss] [-e mm/dd/yy hh:mm:ss]
These formats are for a locale setting of C and may be different for other
locales. For more information on locale, see the locale(1) man page for your
To list recursively, in long format, the files that were backed up in
bplist -l -R /home/user1
lrwxrwxrwx user1 eng 0 Apr 5 12:25 /home/user1/dirlink
drwxr-xr-x user1 eng 0 Apr 4 07:48 /home/user1/testdir
drwxr-x--- user1 eng 0 Apr 4 07:49 /home/user1/dir
-rwxr----- user1 eng 1002 Apr 2 09:59 /home/user1/dir/file
lrwxrwxrwx user1 eng 0 Apr 4 07:49 /home/user1/dir/link
part of the keyword phrase
"My Home Directory"
in directory /home/kwc, enter the following:
bplist -A -keyword "*My Home Directory*" -l /home/kwc/
To list, recursively and with details, the files that were backed up on drive D
of Windows NT client slater and associated with all or part of the keyword
enter the following:
bplist -keyword "*Win NT*" -C slater -t 13 -R -l /D
bp(1), bparchive(1), bpbackup(1), bprestore(1)
Copyright 2002-2003 VERITAS Software Corporation. All rights reserved.
21 Jul 2003 bplist(1)