nsrinfo

The nsrinfo program generates reports about the contents of a client's file index. The Backup client name is required; if you provide no further options, the nsrinfo program produces a report of all the names of the files and objects, one per line, found in the backup namespace for the specified client. The nsrinfo program can also generate reports for a specific client file index namespace, either for all the namespaces at once, or for a particular XBSA (X-Open Backup Services) application. The report can be restricted to a single time period, called the savetime, which is the time the entry was entered into the client file index.

If you do not specify the -L option, you must be listed on the Backup server's Administrators list to use the nsrinfo program. If you do specify the -L option, you must be the system administrator (for example, root on a UNIX system).

The following example describes the format and options available for the nsrinfo program:

nsrinfo [-vV] [-s server | -L] [-n namespace]

[- N filename] [-t time] [-X application] client 

• The required client specification determines the client that the nsrinfo program is reporting on.

• Use the -L option to open the client file index directly without using the Backup server. This option is useful for debugging or to query the client file index when Backup is not running.

• Use the -n namespace option to specify a client file index namespace to query. By default, the backup namespace is queried. The other values recognized by the nsrinfo program are migrated, archive (reserved for future use), nsr, informix, and all.

• Use the -N filename option to specify an exact filename to search for in the client file index. Only index entries that are an exact match to the specified filename are printed. For some client systems (for example, NetWare), the filename stored in the client file index is often not made up of printable ASCII characters, which limits the use of this option.

• Use the -t time option to restrict the nsrinfo query to a single, exact save time. The value of time may be expressed in any of the Backup Backup formats. Every save set created by Backup is assigned a unique save time. You can determine the save time by using the mminfo program (see "mminfo " for information).

• Use the -v option to instruct nsrinfo to run in verbose mode. In addition to the filename, this option displays the type of the file, any internal file index identifier designated, its size (UNIX files only), and its save time. You can combine this option with the -V option.

• Use the -V option to instruct nsrinfo to run in alternate verbose mode. In addition to the file name, this option displays the offset within the save set that contains the file, its size within the save set, the application namespace, and its save time. You can combine this option with the -v option.

• Use the -s server option to define the name of the Backup server that nsrinfo should query. By default, the server on the local system is queried.

• Use the -X application-type option to restrict the query to a list of information for a specific X/Open Backup Services (XBSA) application. Valid application types are All, Informix, and None. The expected value for application-type is not case-sensitive.

  Refer to the nsrinfo(1m) man page for a full description of the valid values for namespace, the file types encountered in the client file indexes, an example of how nsrinfo is used, and a listing of common error messages encountered.