doc/man-pages/pod8/backup_deldump.pod

   1 =head1 NAME
   2
   3 backup_deldump - Deletes a dump level from the Backup Database
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<backup deldump> S<<< B<-dump> <I<dump level name>> >>> [B<-localauth>]
  11     S<<< [B<-cell> <I<cell name>>] >>> [B<-help>]
  12
  13 B<backup deld> S<<< B<-d> <I<dump level name>> >>> [B<-l>]
  14     S<<< [B<-c> <I<cell name>>] >>> [B<-h>]
  15
  16 =for html
  17 </div>
  18
  19 =head1 DESCRIPTION
  20
  21 The B<backup deldump> command deletes the indicated dump level and all of
  22 its child dump levels from the dump hierarchy in the Backup Database. Use
  23 the B<backup listdumps> command to display the dump hierarchy.
  24
  25 =head1 OPTIONS
  26
  27 =over 4
  28
  29 =item B<-dump> <I<dump level name>>
  30
  31 Specifies the complete pathname of the dump level to delete.
  32
  33 =item B<-localauth>
  34
  35 Constructs a server ticket using a key from the local
  36 F</usr/afs/etc/KeyFile> file. The B<backup> command interpreter presents
  37 it to the Backup Server, Volume Server and VL Server during mutual
  38 authentication. Do not combine this flag with the B<-cell> argument. For
  39 more details, see L<backup(8)>.
  40
  41 =item B<-cell> <I<cell name>>
  42
  43 Names the cell in which to run the command. Do not combine this argument
  44 with the B<-localauth> flag. For more details, see L<backup(8)>.
  45
  46 =item B<-help>
  47
  48 Prints the online help for this command. All other valid options are
  49 ignored.
  50
  51 =back
  52
  53 =head1 EXAMPLES
  54
  55 The following command deletes the dump level C</sunday1/monday1> from the
  56 dump hierarchy, along with any of its child dump levels.
  57
  58    % backup deldump /sunday1/monday1
  59
  60 =head1 PRIVILEGE REQUIRED
  61
  62 The issuer must be listed in the F</usr/afs/etc/UserList> file on every
  63 machine where the Backup Server is running, or must be logged onto a
  64 server machine as the local superuser C<root> if the B<-localauth> flag is
  65 included.
  66
  67 =head1 SEE ALSO
  68
  69 L<backup(8)>,
  70 L<backup_adddump(8)>,
  71 L<backup_listdumps(8)>
  72
  73 =head1 COPYRIGHT
  74
  75 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  76
  77 This documentation is covered by the IBM Public License Version 1.0.  It was
  78 converted from HTML to POD by software written by Chas Williams and Russ
  79 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.