X-Git-Url: https://git.openafs.org/?p=openafs.git;a=blobdiff_plain;f=doc%2Fman-pages%2Fpod8%2Fbackup_volsetrestore.pod;h=4001038caa8565031a75a10ce5615d73037edd1c;hp=77711376dc09978515edffc547cf49ba58c8796c;hb=131cbaa0cf74a7b3ca24ec971a9495c8dbd73e6a;hpb=6770c6c411f2766471b4dc07bd7c66794f95ba63 diff --git a/doc/man-pages/pod8/backup_volsetrestore.pod b/doc/man-pages/pod8/backup_volsetrestore.pod index 7771137..4001038 100644 --- a/doc/man-pages/pod8/backup_volsetrestore.pod +++ b/doc/man-pages/pod8/backup_volsetrestore.pod @@ -10,14 +10,14 @@ backup_volsetrestore - Restores all volumes in a volume set B S<<< [B<-name> >] >>> S<<< [B<-file> >] >>> S<<< [B<-portoffset> >+] >>> - S<<< [B<-extension> >] >>> [B<-n>] + S<<< [B<-extension> >] >>> [B<-dryrun>] [B<-localauth>] S<<< [B<-cell> >] >>> [B<-help>] B S<<< [B<-na> >] >>> S<<< [B<-f> >] >>> S<<< [B<-p> >+] >>> S<<< [B<-e> >] >>> - [B<-n>] [B<-l>] S<<< [B<-c> >] >>> [B<-h>] + [B<-dryrun>] [B<-l>] S<<< [B<-c> >] >>> [B<-h>] =for html @@ -112,10 +112,11 @@ the read/write base name, and creates a new VLDB entry. The command does 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 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 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 command depends on the number of volumes to be restored and the amount of data in them, but it @@ -224,7 +225,7 @@ Provide this argument unless the default value of 0 (zero) is appropriate 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 details the format of @@ -254,8 +255,8 @@ ignored. =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 @@ -275,13 +276,13 @@ B command when the B command is issued 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): @@ -340,7 +341,7 @@ The date and time when the volume was dumped. =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 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.