Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
nbfindfile — search files or folders based on simple search criteria
SYNOPSIS
-c client_name[,...] -p search_pattern [-s mm/dd/yyyy [hh:mm:ss] | -s_ut unix_time] [-e mm/dd/yyyy [hh:mm:ss] | -e_ut unix_time] [-backupid backup_id] [-policy policy_name] [-keyword "keyword_phrase"] [-extn file_extn[,...]] [-st sched_type] [-pt policy_type] [-kb_min min_size_kb] [-kb_max max_size_kb] [-mtime_min mm/dd/yyyy [hh:mm:ss]] [-mtime_max mm/dd/yyyy [hh:mm:ss]] [-atime_min mm/dd/yyyy [hh:mm:ss]] [-atime_max mm/dd/yyyy [hh:mm:ss]] [-ctime_min mm/dd/yyyy [hh:mm:ss]] [-ctime_max mm/dd/yyyy [hh:mm:ss]] [-only_dirs | -only_files] [-max_results number] [-case_sen] [-l [-ctime | -atime] | -raw] [-help | -h]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is <install_path>\NetBackup\bin\admincmd\
DESCRIPTION
The nbfindfile command lets you search files or folders based on simple search criteria like file name and path including wildcard and backup date range. Users can specify a set of clients, possibly belonging to different master servers, for which backups are to be searched. You can specify advanced search criteria including policy type, schedule type, policy name, policy associated keywords, file extensions, file modification date range, and file size.
OPTIONS
- -atime
When used with the -l option, -atime displays the last access time in place of the last modification time.
- -atime_max mm/dd/yyyy [hh:mm:ss]
Specifies the maximum last access time of objects to be returned. The default is infinite.
- -atime_min mm/dd/yyyy [hh:mm:ss]
Specifies the minimum last access time of objects to be returned. The default is 01/01/1970 00:00:00.
- -backupid backup_id
The backup ID of the backup image that should be searched.
- -c client_name[,...]
Specifies the names of the NetBackup clients whose backups need to be searched. The client names must be specified as they appear in the NetBackup configuration. Multiple clients can be specified as a list that is separated by commas.
- -case_sen
Performs case sensitive matching.
- -ctime
When used with the -l option, -ctime displays the last change time in place of the last modification time.
- -ctime_max mm/dd/yyyy [hh:mm:ss]
Specifies the maximum last change time of objects to be returned. The default is infinite.
- -ctime_min mm/dd/yyyy [hh:mm:ss]
Specifies the minimum last change time of objects to be returned. The default is 01/01/1970 00:00:00.
- -e mm/dd/yyyy [hh:mm:ss] | -e_ut unix_time
Specifies the end date for the search. Backups that occurred at or before the specified date and time are searched. The default is the current date and time.
- -extn file_extn[,...]
Returns only the files with the specified extensions. For example, -extn txt,do*,jp?.
- -h | -help
Displays usage information.
- -kb_max max_size_kb
Specifies the maximum size in kilobytes (1024 bytes) of files to be returned. The default is infinite.
- -kb_min min_size_kb
Specifies the minimum size in kilobytes (1024 bytes) of files to be returned. The default is 0 (zero).
- -keyword "keyword_phrase"
Searches only the backup images that contain a matching keyword phrase are searched. The keyword phrase can contain wildcards (*, ?) and square bracket expressions. Examples are [Kk]ey*, [a-z]e?, and [!K]ey.
- -l
Displays output in long list format. The default condition is the last modification time of objects.
- -max_results number
Specifies the maximum number of results to be displayed. The default is infinite.
- -mtime_max mm/dd/yyyy [hh:mm:ss]
Specifies the maximum last modification time of objects to be returned. The default is infinite.
- -mtime_min mm/dd/yyyy [hh:mm:ss]
Specifies the minimum last modification time of objects to be returned. The default is 01/01/1970 00:00:00.
- -only_dirs | -only_files
Specifies the type of objects to be returned.
- -p search_pattern
Specifies the search pattern. File and directory entries matching this pattern are displayed.
- -policy policy_name
Searches only the backup images that are created using the specified policy.
- -pt policy_type
Searches only the backups with the specified policy type. Valid values for policy_type: Any, Standard, FlashBackup, MS-Windows, NDMP, FlashBackup-Windows.
- -r
Displays raw output.
- -s mm/dd/yyyy [hh:mm:ss] | -s_ut unix_time
Specifies the start date for the search. Backups that occurred at or after the specified date and time are searched. The default is 30 days before the end date.
- -st sched_type
Specifies a schedule type for the image selection. The default is any schedule type. Valid values, in either uppercase or lowercase, are as follows:
ANY
FULL (full backup)
INCR (differential-incremental backup)
CINC (cumulative-incremental backup)
UBAK (user backup)
UARC (user archive)
SCHED
USER (user backup and user archive)
NOT_ARCHIVE (all backups except user archive)