SYNOPSIS
/usr/openv/netbackup/bin/bplist [-A | -B] [-C client] [-S mas-
ter_server] [-k policy] [-t policy_type] [-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] [-Listpolicy]
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. A non-
administrator or backup operator cannot use bplist.
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 you are validated to do so by the NetBackup
administrator.
If you create the following directory with public-write access, bplist
creates an debug log file in this directory that you can use for trou-
bleshooting:
usr/openv/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 Net-
Backup configuration. The default is the current client name.
-S master_server
Specifies the name of the NetBackup server. The default is
the first SERVER entry found in the /usr/openv/net-
backup/bp.conf file.
-t policy_type
Specifies one of the following numbers that corresponds to
the policy type. The default is 0 for all clients except Win-
dows, where the default is 13.
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
35 = NBU-Catalog Note that 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
-k policy Names the policy to search to produce the list. If not spec-
ified, all policies are searched.
-F Specifies that in the list output, symbolic links (applies
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 and 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 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
Lists in a long format that contain mode, owner, group, size
in bytes, and time of last modification for each file (see
the EXAMPLES section). The list shows the mode of each file
as 10 characters that represent the standard UNIX file per-
missions. The first character is one of the following:
d (specifies a directory)
w = the file is writable
x = the file is executable
- = the indicated permission is not granted
-Listseconds
Specifies that seconds granularity be used for the time stamp
when the -l option is used.
-r
Lists the raw partitions that were backed up. The default is
to list file systems.
-flops file_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 Exe files specify:
-flops 524288
To list Backup Exe 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 syn-
thetic full backups.
-unix_files
Lists the files and directories in UNIX format. For example:
/C/users/test.
-nt_files Lists the files and directories in Windows format. For exam-
ple: C:\users\test.
-s date
-e date Specifies the start date 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 the archives
that occurred at or after the specified date and time.
default is the current date and time.
-I Specifies a case-insensitive search, which means that capi-
talization is not considered when it compares names (for
example, Cat matches cat).
-PI Specifies a path-independent search, which means that Net-
Backup 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:
/tmp/junk/test
/abc/123/xxx/test
/abc/123/xxx/yyy/zzz/test
-help Prints a command line usage message.
-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 combi-
nation with the other restore options to make it easier to
restore backups and archives. Use the following meta charac-
ters 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 charac-
ters that is 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 characters are permitted including space ("") and
period (".").
The phrase must be enclosed in double quotes ("...") or sin-
gle quotes (`...' ) to avoid conflict with the UNIX shell.
The default keyword phrase is the null (empty) string.
Note The keyword phrase is ignored when you use the follow-
ing policy types: DB2, Informix-On-BAR, Oracle, SAP,
MS-SQL-Server, Sybase.
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 "/home/user1/*"
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/yyyy hh:mm:ss] [-e mm/dd/yyyy 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 system.
EXAMPLES
Example 1 - List recursively in long format
To list recursively in long format, the files that were backed up in
/home/user1
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
Example 2 - To list with details
Enter the following command to list the files that were backed up and
associated with all or part of the keyword phrase "My Home Directory"
Bplist -keyword "*My Home Directory*" -l /home/kwc/
Example 3 - To list with details
Enter the following command to list the files that were archived and
associated with all or part of the keyword phrase "My Home Directory"
bplist -A -keyword "*My Home Directory*" -l /home/kwc/
Example 4 - To list recursively and with details
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 -t 13 -R -l /D
FILES
/usr/openv/netbackup/logs/bplist/log.mmddyy
SEE ALSO
bp(1), bparchive(1), bpbackup(1), bprestore(1)