The options used in the imsasm utility are also known as standard-asm-arguments, which are Legato NetWorker® backup standards.
Either -s (saving), -r (recovering), or -c (comparing) must be specified and must precede any other options. When saving, at least one path argument must be specified. path may be either a directory or filename.
The following options are valid for all modes:
Option |
Description |
---|---|
-n |
Performs a dry run. When saving, walk the file system but don’t attempt to open files and produce the save stream. When recovering or comparing, consume the input save stream and do basic sanity checks, but do not actually create any directories or files when recovering or do the work of comparing the actual file data. |
-v |
Turns on verbose mode. The current ASM, its arguments, and the file it is processing are displayed. When a filtering ASM operating in filtering mode (that is, processing another ASM’s save stream) modifies the stream, its name, arguments, and the current file are displayed within square brackets. |
When saving (-s), the following options may also be used:
Option |
Description |
---|---|
-b |
Produces a byte count. This option is like the -n option, but byte count mode will estimate the amount of data that would be produced instead of actually reading file data so it is faster but less accurate than the -n option. Byte count mode produces three numbers: the number of records, i.e., files and directories; the number of bytes of header information; and the approximate number of bytes of file data. Byte count mode does not produce a save stream so its output cannot be used as input to another asm in recover mode. |
-o |
Produces an “old style” save stream that can be handled by older NetWorker servers. |
-e |
Do not generate the final “end of save stream” Boolean. This flag should only be used when an ASM invokes an external ASM and as an optimization chooses not to consume the generated save stream itself. |
-i |
Ignores all save directives from .nsr directive files found in the directory tree. |
-f proto |
Specifies the location of a .nsr directive file to interpret before processing any files. Within the directive file specified by proto, path directives must resolve to files within the directory tree being processed, otherwise their subsequent directives will be ignored. |
-p ppath |
Prepends this string to each file’s name as it is output. This argument is used internally when one ASM executes another external ASM. ppath must be a properly formatted path which is either the current working directory or a trailing component of the current working directory. |
-t date |
The date after which files must have been modified before they will be saved. |
-x |
Crosses file system boundaries. Normally, file system boundaries are not crossed during walking. |
When recovering (-r), the following options may also be used: