There are examples on the man page for bplist. I suggest trying some of the simpler syntax until you become familiar with bplist.
Here is the correct link for your version of the command manual.
VERITAS NetBackup (tm) 4.5 Feature Pack 3 Commands for UNIX
here is the text but it might not show correctly with this usergroup window.
# man bplist
bplist(1) bplist(1)
21 Jul 2003
NAME
bplist - Lists backed up and archived files on the NetBackup server.
SYNOPSIS
/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]
DESCRIPTION
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 displayed 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 troubleshooting.
The output of bplist goes to standard output.
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
Specifies the name of the NetBackup server. The default is
the first SERVER entry found in the
/usr/openv/netbackup/bp.conf file.
-t policy_type
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
- 1 - Formatted: February 9, 2005
bplist(1) bplist(1)
21 Jul 2003
6 = Informix-On-BAR
7 = Sybase
10 = NetWare
13 = MS-Windows-NT/2000
14 = OS/2
15 = MS-SQL-Server
16 = MS-Exchange-Server
19 = NDMP
Note: 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
-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 trailing *.
-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 -l option:
-b displays the backup date and time of each file.
-c displays the last inode modification date and time for
each file.
- 2 - Formatted: February 9, 2005
bplist(1) bplist(1)
21 Jul 2003
-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 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 as follows:
r means the file is readable
w means the file is writable
x means the file is executable
- means the indicated permission is not granted
-Listseconds
Specifies that seconds granularity be used for the time
stamp when the the -l option is used.
-r Lists raw partitions that were backed up. The default is to
list file systems.
-flops file_options
Allows either Backup Exec files to be listed, or both Backup
Exec and NetBackup files to be listed. 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:
- 3 - Formatted: February 9, 2005
bplist(1) bplist(1)
21 Jul 2003
-flops 1048576
-T Lists directories in true-image backups. The default is to
list non-true-image backups.
Note: TIR information will not appear for synthetic full
backups, even though TIR information is used for sythetic
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
example: C:\\users\\test.
-s date
-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 follows:
mm/dd/yy [hh[:mm[:ss]]]
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 shown below, a search for test
finds all three instances of the file:
- 4 - Formatted: February 9, 2005
bplist(1) bplist(1)
21 Jul 2003
/tmp/junk/test
/abc/123/xxx/test
/abc/123/xxx/yyy/zzz/test
-help Prints a command line usage message when -help is the only
option on the command line.
-keyword "keyword_phrase"
Specifies a keyword phrase for NetBackup to use when
searching 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
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 following 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 characters 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 "/home/user1/*"
Note: If you are using the asterisk meta character "*", you
should use quotation marks around the filename for the
command to work properly.
NOTES
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:
- 5 - Formatted: February 9, 2005
bplist(1) bplist(1)
21 Jul 2003
[-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 system.
EXAMPLES
Example 1
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, the files that were backed up and associated
with all or part of the keyword phrase
"My Home Directory"
in directory /home/kwc, enter the following:
bplist -keyword "*My Home Directory*" -l /home/kwc/
Example 3
To list, with details, the files that were archived and associated
with all or part of the keyword phrase
"My Home Directory"
in directory /home/kwc, enter the following:
bplist -A -keyword "*My Home Directory*" -l /home/kwc/
Example 4
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 phrase
"Win NT"
enter the following:
- 6 - Formatted: February 9, 2005
bplist(1) bplist(1)
21 Jul 2003
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)
COPYRIGHT
Copyright 2002-2003 VERITAS Software Corporation. All rights reserved.
- 7 - Formatted: February 9, 2005
#
and here is the usage:
# bplist -help
USAGE: bplist [-A | -B] [-C client] [-S master_server]
[-t policy_type] [-k policy] [-keyword "keyword phrase"]
[-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-T] [-I] [-PI]
[-unix_files | -nt_files] [-Listseconds] [-flops file_options]
[-s mm/dd/yyyy [HH:MM:SS]] [-e mm/dd/yyyy [HH:MM:SS]] [filename]
Bob Stump
Incorrigible punster -- Do not incorrige