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 class_type] [-k class] [-F] [-R [n]] [-b | -c |
-u] [-l] [-r] [-Listseconds] [-T] [-unix_files] [-nt_files] [-s
mm/dd/yy [hh:mm:ss]] [-e mm/dd/yy [hh:mm:ss]] [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 activity 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 class_type
Specifies one of the following numbers corresponding to the
class type (the default is 0 on all clients except Apollos,
where it is 3):
0 = Standard
4 = Oracle
6 = Informix-On-BAR
7 = Sybase
10 = NetWare
13 = MS-Windows-NT
14 = OS/2
15 = MS-SQL-Server
16 = MS-Exchange-Server
19 = NDMP
Note: The following class types (Apollo-wbak, DataTools-SQL-
BackTrack, Auspex-FastBackup, SAP, DB2, FlashBackup, Split-
Mirror, and AFS) apply only to NetBackup DataCenter.
3 = Apollo-wbak
11 = DataTools-SQL-BackTrack
12 = Auspex-FastBackup
17 = SAP
18 = DB2
20 = FlashBackup
21 = Split-Mirror
22 = AFS
-k class Names the class to search to produce the list. If not
specified, all classes 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.
-u displays the last access date and time of each file.
The default is to display the time of 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.
-T Lists directories in true-image backups. The default is to
list non-true-image 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 NT/2000 format.
For example: C:\users\test.
-s mm/dd/yy [hh:mm:ss]
-e mm/dd/yy [hh:mm:ss]
Specifies the start and end date range for the listing.
Note: The locale setting for the system affects the way you must
specify dates and times. See the NOTES section later in this
command description.
-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. Use the
following format for the start date and time:
mm/dd/yy [hh[:mm[:ss]]]
The valid range of dates are from 01/01/70 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:
/tmp/junk/test
/abc/123/xxx/test
/abc/123/xxx/yyy/zzz/test
-help Displays a synopsis of command usage when it 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 that you specify must be listed at the end,
following all other options.
NOTES
The format that you must use for date and time values in NetBackup
commands depends on your locale setting. The examples in this command
description are for a locale setting of C.
If you are uncertain of the NetBackup command requirements for your
locale, enter the command with the -help option and check the usage.
For example:
/usr/openv/netbackup/bin/bplist -help
USAGE: bplist [-A | -B] [-C client] [-S master_server]
[-t class_type] [-k class] [-keyword "keyword phrase"]
[-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-T] [-I] [-PI]
[-unix_files | -nt_files]
[-s mm/dd/yy [hh:mm:ss]] [-e mm/dd/yy [hh:mm:ss]] [filename]
Notice the month/day/year and hours:minutes:seconds requirements for
the -s and -e options. These are for a locale setting of C and can 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:
bplist -keyword "*Win NT*" -C slater -t 13 -R -l /D
FILES
/usr/openv/netbackup/logs/bplist/log.mmddyy