NAME

save − save files to long term storage with NetWorker

SYNOPSIS

save [ −BEiLnqvx ] [ −s server ] [ −N name ] [ −e expiration ] [ −f dirfile ] [ −b pool ] [ −F file ] [ −g group ] [ −I input file ] [ −l level ] [ −t date ] [ −m masquerade ] [ −W width ] [ path ... ]

DESCRIPTION

save saves files, including directories or entire filesystems, to the NetWorker server (see nsr(8)).  The progress of a save can be monitored using the X Window System based networker(8) program or the curses(3X) based nsrwatch(8) program for other terminal types. 

If no path arguments are specified on the command line and the −I option is not used, the current directory will be saved.  save will save a directory by saving all the files and subdirectories it contains, but it will not cross mount points, nor will it follow symbolic links.  If the paths to be saved are mounted from a network file server, save will instruct the user to run the save on the remote machine or use the -L option. 

The directive files (see nsr(5)) encountered in each directory will be read by default, and they contain special instructions directing how particular files are to be saved (i.e. compressed, skipped, etc.).  These files are named ’.nsr’. 

Each file in the subdirectory structures specified by the path arguments or via the −I option will be encapsulated in a NetWorker save stream.  This stream of data is sent to a receiving process (see nsrd(8)) on the NetWorker server, which will process the data, adding entries to the on-line index (see nsrindexd(8)) for each file in the stream, with the data finally ending up on some long term storage media (see nsrmmd(8)). 

Details about handling media are discussed in nsrmm(8) and nsr_device(5). 

OPTIONS

−E Estimate the amount of data which will be generated by the save, then perform the actual save.  Note that the estimate is generated from the inode information, and thus the data is only actually read once. 

−i Ignore any .nsr directive files as they are encountered in the subdirectory structures being saved. 

−I input file
Take the list of files to be saved from input file, in addition to any filenames specified on the command line.  Filenames should be listed one per line; blank lines (lines containing only newlines) are ignored.  Whitespace is significant and should be trimmed if necessary.  Lines may also be of the form −t date, which sets the date after which subsequently-listed files will have to have been modified to be saved.  The date specification may appear either on the same line as the −t, or on the next nonblank line.  The last −t specification given on the command line before any path arguments will set the initial time for files listed in input file, just as an initial −t specification in input file would.  The time specification in effect at the end of input file will be carried over to any path arguments on the command line. 

−L Local.  Saves will be performed from the local NetWorker client, even when files are from a network file server.  To recover these files, run recover(8) with the −c client arguments, where client is the name of the NetWorker client that did the save. 

−m masquerade
Specifies the tag to precede the summary line with.  This option is used by savegroup(8) and savefs(8) to aid in savegroup summary messages. 

−n No save.  Estimate the amount of data which will be generated by the save, but do not perform the actual save. 

−v Verbose.  Cause the save program to tell you in great detail what it is doing as it proceeds. 

−q Quiet.  Display only summary information and error messages. 

−s server
Specify which machine to use as the NetWorker server.  The default is the current machine if it is running a server, otherwise the machine with the logical name “nsrhost” in the host table (see hosts(5)) is used. 

−N name
The symbolic name of this save set.  By default, the most common prefix of the path arguments is used as the save set name. 

−e expiration
Sets the date (in getdate(3) format) when this save set will expire.  By default, no explicit save set expiration date is used. 

−f dirfile
The file from which to read prototype default directives (see nsr(5)).  A dirfile of - causes the default directives to be read from standard input. 

−b pool
Specifies a particular destination pool for the save.

−F file
Only save files whose change time is newer than the file modification date of file.

−g group
This option is used by savegroup(8) and savefs(8) to denote the group of the save (see nsr_client(5) and nsr_group(5)) and is used by the NetWorker server to select the specific media pool. 

−l level
The level of the save. This option is used by savegroup(8) and savefs(8) to specify a particular level for a scheduled save. 

−t date
The date (in getdate(3) format) after which files must have been modified before they will be saved.  This option is used by savegroup(8) and savefs(8) to perform scheduled saves by consulting with the media database to determine the appropriate time value based on the previous saves for the save set and the level of the scheduled save. 

−W width
The width used when formatting summary information output.

−x Cross mount points. 

−B Force save of all connecting directory information from root (“/”) down to the point of invocation. 

SEE ALSO

curses(3X), getdate(3), hosts(5), networker(8), nsr(5), nsr(8), nsr_client(5), nsr_device(5), nsr_group(5), nsr_service(5), nsrd(8), nsrindexd(8), nsrmm(8), nsrmmd(8), nsrwatch(8), recover(8), savefs(8), savegroup(8)

DIAGNOSTICS

Exit Codes

0 Normal exit. 

−1 Abnormal exit. 

NetWorker 4.1.2  —  Last change: May 1995