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]  [-List-
              policy]


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,  where  the
                 default is 13.

                 0 = Standard

                 4 = Oracle

                 6 = Informix-On-BAR

                 7 = Sybase

                 10 = NetWare

                 13 = MS-Windows

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

                 m (specifies a file migrated by VERITAS Storage Migrator for  UNIX  or
                 VERITAS Data Lifecycle Manager)

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

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

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

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

       -Listpolicy
                 Includes the schedule type and policy name in the command output.


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

       To  list  recursively,  in  long  format,  the  files  that  were  backed  up in
              "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 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 (c) 2002-2005 VERITAS Software Corporation. All rights reserved.






                           10 Feb 2005                  bplist(1)