B<backup volsetrestore> S<<< [B<-name> <I<volume set name>>] >>>
S<<< [B<-file> <I<file name>>] >>>
S<<< [B<-portoffset> <I<TC port offset>>+] >>>
- S<<< [B<-extension> <I<new volume name extension>>] >>> [B<-n>]
+ S<<< [B<-extension> <I<new volume name extension>>] >>> [B<-dryrun>]
[B<-localauth>] S<<< [B<-cell> <I<cell name>>] >>> [B<-help>]
B<backup vols> S<<< [B<-na> <I<volume set name>>] >>>
S<<< [B<-f> <I<file name>>] >>>
S<<< [B<-p> <I<TC port offset>>+] >>>
S<<< [B<-e> <I<new volume name extension>>] >>>
- [B<-n>] [B<-l>] S<<< [B<-c> <I<cell name>>] >>> [B<-h>]
+ [B<-dryrun>] [B<-l>] S<<< [B<-c> <I<cell name>>] >>> [B<-h>]
=for html
</div>
not affect the existing volume in any way. However, if a volume with the
specified extension also already exists, the command overwrites it.
-The B<-n> flag produces a list of the volumes to be restored if the B<-n>
-flag were not included, without actually restoring any volumes. See
-L<OUTPUT> for a detailed description of the output, and suggestions on how
-to combine it most effectively with the B<-file> and B<-name> arguments.
+The B<-dryrun> flag produces a list of the volumes to be restored if the
+B<-dryrun> flag were not included, without actually restoring any volumes.
+See L</OUTPUT> for a detailed description of the output, and suggestions
+on how to combine it most effectively with the B<-file> and B<-name>
+arguments.
The execution time for a B<backup volsetrestore> command depends on the
number of volumes to be restored and the amount of data in them, but it
for all dumps. If C<0> is just one of the values in the list, provide it
explicitly in the appropriate order.
-=item B<-n>
+=item B<-dryrun>
Displays a list of the volumes to be restored if the flag were not
-included, without actually restoring them. L<OUTPUT> details the format of
+included, without actually restoring them. L</OUTPUT> details the format of
the output. When combined with the B<-name> argument, its output is easily
edited for use as input to the B<-file> argument on a subsequent B<backup
volsetrestore> command.
=head1 OUTPUT
-If the B<-n> flag is not provided, the command displays a unique task ID
-number for the operation, in two places:
+If the B<-dryrun> flag is not provided, the command displays a unique
+task ID number for the operation, in two places:
=over 4
in interactive mode. The Backup System does not assign either type of ID
number until the restoration process actually begins.
-When the B<-n> flag is included, no task ID or job ID numbers are reported
-because none are assigned. Instead, the output begins with a count of the
-number of volumes to be restored, followed by a line for each dump of a
-volume. For each volume, the line representing the most recent full dump
-appears first, and lines for any subsequent incremental dumps follow,
-ordered by dump level. The lines for a given volume do not necessarily
-appear all together, however.
+When the B<-dryrun> flag is included, no task ID or job ID numbers are
+reported because none are assigned. Instead, the output begins with a
+count of the number of volumes to be restored, followed by a line for
+each dump of a volume. For each volume, the line representing the most
+recent full dump appears first, and lines for any subsequent incremental
+dumps follow, ordered by dump level. The lines for a given volume do not
+necessarily appear all together, however.
The format of each line is as follows (the output is shown here on two
lines only for legibility reasons):
=back
One way to generate a file for use as input to the B<-file> argument is to
-combine the B<-name> and B<-n> options, directing the output to a
+combine the B<-name> and B<-dryrun> options, directing the output to a
file. The I<OpenAFS Administration Guide> section on using the Backup
System to restore data explains how to edit the file as necessary before
using it as input to the B<-file> argument.