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