SAVE(8)                     Legato NetWorker 3.0                     SAVE(8)


NAME
       save - save files to long term storage with NetWorker

SYNOPSIS
       save [ -BEiLnqvx ] [ -s server ] [ -N name ] [ -f filename ] [ -e
       expiration ] [ -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 moni­
       tored 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, the current directory will be
       saved.  Save will save a directory by saving all the file and subdi­
       rectories 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 by default use a remote shell to run
       itself with the same arguments (but with the path arguments appropri­
       ately translated) on the file server.

       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 (ie: compressed, skipped, etc.).
       These files are named .nsr.

       Each file in the subdirectory structures specified by the path argu­
       ments 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 medium (see nsrmmd(8)).

       Details about handling media are discussed in mm(8) and
       nsrdevice(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 directive files as they are encountered in the subdi­
              rectory structures being saved.

       -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 argu­
              ments, where client is the name of the NetWorker client that
              did the save.

       -m masquerade
              Specifies the tag to precede status messages with.  By
              default, the program name is used.  Error messages are always



Licensed material--property of copyright holder(s)                         1

SAVE(8)                     Legato NetWorker 3.0                     SAVE(8)


              preceded by the program name.

       -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 server of the first directory being saved, if
              it is a network file server and NetWorker server.  Otherwise,
              the current machine if it is running a server, or 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 first
              path argument is used as the name.

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

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

       -t date
              The date (in getdate(3) format) after which files must have
              been modified before they will be saved.  This is used by
              savefs(8) to perform partial saves.

       -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), nsr(5), nsrservice(5),
       nsrdevice(5), mm(8), nsrmmd(8), networker(8), nsrd(8), nsrindexd(8),
       nsrwatch(8), recover(8), savefs(8), savegroup(8)

DIAGNOSTICS
   Exit Codes
       0      Normal exit.
       -1     Abnormal exit.




Licensed material--property of copyright holder(s)                         2