Update NEWS for 1.8.0pre3
[pkg-k5-afs_openafs.git] / doc / man-pages / pod8 / fssync-debug_vgcdel.pod
bloba522e7b98e936a480564283297fe9ad0de0478ad
1 =head1 NAME
3 fssync-debug_vgcdel - Delete an entry from the VG cache (FSYNC_VG_UPDATE opcode)
5 =head1 SYNOPSIS
7 =for html
8 <div class="synopsis">
10 B<fssync-debug vgcdel>
11     S<<< B<-partition> <I<exact partition name>> >>>
12     S<<< B<-parent> <I<volume ID>> >>>
13     S<<< B<-child> <I<volume ID>> >>>
14     S<<< [B<-reason> <I<sync protocol reason code>>] >>>
15     S<<< [B<-programtype> <I<program type code>>] >>>
16     [B<-help>]
18 B<fssync-debug vgcd>
19     S<<< B<-part> <I<exact partition name>> >>>
20     S<<< B<-pare> <I<volume ID>> >>>
21     S<<< B<-c> <I<volume ID>> >>>
22     S<<< [B<-r> <I<sync protocol reason code>>] >>>
23     S<<< [B<-pr> <I<program type code>>] >>>
24     [B<-h>]
26 =for html
27 </div>
29 =head1 DESCRIPTION
31 The B<fssync-debug vgcdel> command deletes an entry from the volume
32 group cache (VGC).
34 =head1 OPTIONS
36 =over 4
38 =item B<-partition> <I<exact partition name>>
40 Specifies the exact partition name (e.g. I</vicepa>). Abbreviations
41 are not permitted.
43 =item B<-parent> <I<volume ID>>
45 Specifies the numeric volume ID for the parent volume of the VGC entry.
47 =item B<-child> <I<volume ID>>
49 Specifies the numeric volume ID for the child volume in the VGC entry
50 to delete.
52 =item B<-reason> <I<sync protocol reason code>>
54 Specifies numeric sync protocol reason code.
55 Available codes are listed in OpenAFS source file
56 F<src/vol/fssync_inline.h>. For SYNC_REASON_NONE,
57 use B<-reason I<0>>.
59 =item B<-programtype> <I<program type code>>
61 Specifies program type code. Permitted values are
62 I<fileServer>,
63 I<volumeUtility>,
64 I<salvager>,
65 I<salvageServer>,
66 I<volumeServer> and
67 I<volumeSalvager>.
69 =item B<-help>
71 Prints the online help for this command. All other valid options are
72 ignored.
74 =back
76 =head1 PRIVILEGE REQUIRED
78 The issuer must have write access to the file server.
79 Usually, this means that the issuer must be the
80 local superuser C<root> on the file server machine.
82 =head1 SEE ALSO
84 L<fssync-debug_vgcadd(8)>,
85 L<fssync-debug_vgcquery(8)>,
86 L<fssync-debug_vgcscan(8)>,
87 L<fssync-debug_vgcscanall(8)>,
89 =head1 COPYRIGHT
91 Copyright 2010 Sine Nomine Associates
93 This documentation is covered by the IBM Public License Version 1.0. This
94 man page was written by Andrew Deason and Davor Ocelic for OpenAFS.