/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]


       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

       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-



       -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.


                 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


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


                 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.

                  Lists the files and directories in UNIX format. For example:

       -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:




                 -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.


       Example 1 - List recursively in long format

       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

       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




       bp(1), bparchive(1), bpbackup(1), bprestore(1)