=head1 NAME

backup delvolentry - Deletes a volume entry from a volume set

=head1 SYNOPSIS

backup delvolentry B<-name> I<volume set name>  B<-entry> I<volume set index>
[B<-localauth>]  [B<-cell> I<cell name>]  [B<-help>]

backup delvole  B<-n> I<volume set name>  B<-e> I<volume set index>
[B<-l>]  [B<-c> I<cell name>]  [B<-h>]

=head1 DESCRIPTION

The C<backup delvolentry> command deletes the indicated volume entry from
the volume set specified with the B<-name> argument. Use the B<-entry>
argument to identify the volume entry by its index number. To display
the index numbers, use the C<backup listvolsets> command.

If there are any remaining volume entries with index numbers higher
than the deleted entry, their indexes are automatically decremented to
eliminate any gaps in the indexing sequence.

=head1 OPTIONS

=over 4

=item B<-name> I<volume set name>

Names the volume set from which to delete a volume entry.

=item B<-entry> I<volume set index>

Specifies the index number of the volume entry to delete. Use
the C<backup listvolsets> command to display the index numbers for
a volume set's volume entries.

=item B<-localauth>

Constructs a server ticket using a key from the local
B</usr/afs/etc/KeyFile> file. The C<backup> command interpreter
presents it to the Backup Server, Volume Server and VL Server
during mutual authentication. Do not combine this flag with the
B<-cell> argument. For more details, see the introductory L<backup(1)> reference page.

=item B<-cell> I<cell name>

Names the cell in which to run the command. Do not combine this
argument with the B<-localauth> flag. For more details, see the
introductory L<backup(1)> reference page.

=item B<-help>

Prints the online help for this command. All other valid
options are ignored.

=back

=head1 EXAMPLES

The following command deletes the fourth volume entry from the volume
set called B<sys>:

   backup delvolentry -name sys -entry 4

=head1 PRIVILEGE REQUIRED

The issuer must be listed in the B</usr/afs/etc/UserList> file on every
machine where the Backup Server is running, or must be logged onto a
server machine as the local superuser B<root> if the B<-localauth> flag is
included.

=head1 CAVEATS

Deleting volume entries from a temporary volume set is possible only
within the interactive session in which the volume set was created.

=head1 COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

Converted from html to pod by Alf Wachsmann <alfw@slac.stanford.edu>, 2003,
Stanford Linear Accelerator Center, a department of Stanford University.

=head1 SEE ALSO

L<backup(1)>,
L<backup_addvolentry(1)>,
L<backup_addvolset(1)>,
L<backup_delvolset(1)>,
L<backup_listvolsets(1)>

=cut
