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

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

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

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

       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


SEE ALSO

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


COPYRIGHT

       Copyright 2002-2003 VERITAS Software Corporation. All rights reserved.






                           21 Jul 2003                  bplist(1)