Search <book_title>...

Veritas NetBackup™ OpsCenter Administrator's Guide

Last Published: 2017-11-30

Product(s): NetBackup (8.1)

Name

nbfindfile — This utility searches for files or folders based on simple search criteria. This utility must be run on the master server and not the OpsCenter Server.

SYNOPSIS

nbfindfile -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] [-I] [-l [-ctime | -atime] | -raw] [-help | -h]

On UNIX and Linux 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.

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

-i

Performs case insensitive matching.

-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 last modification time of objects to be returned. The default is 01/01/1970 00:00:00.

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