Import Upstream version 1.8.5
[hcoop/debian/openafs.git] / doc / man-pages / pod8 / fssync-debug_stats.pod
CommitLineData
805e021f
CE
1=head1 NAME
2
3fssync-debug_stats - Displays various statistics
4
5=head1 SYNOPSIS
6
7=for html
8<div class="synopsis">
9
10B<fssync-debug stats> S<<< B<-cmd> <I<subcommand>> >>>
11 S<<< [B<-arg1> <I<arg1>>] >>>
12 S<<< [B<-arg2> <I<arg2>>] >>>
13 S<<< [B<-reason> <I<sync protocol reason code>>] >>>
14 S<<< [B<-programtype> <I<program type code>>] >>>
15 [B<-help>]
16
17B<fssync-debug s> S<<< B<-c> <I<subcommand>> >>>
18 S<<< [B<-arg1> <I<arg1>>] >>>
19 S<<< [B<-arg2> <I<arg2>>] >>>
20 S<<< [B<-r> <I<sync protocol reason code>>] >>>
21 S<<< [B<-p> <I<program type code>>] >>>
22 [B<-h>]
23
24=for html
25</div>
26
27=head1 DESCRIPTION
28
29The B<fssync-debug stats> command displays statistics
30according to the value of the option B<-cmd>.
31
32=head1 OPTIONS
33
34=over 4
35
36=item B<-cmd> <I<subcommand>>
37
38Specifies statistics subcommand. Available subcommands are:
39
40=over 4
41
42=item *
43
44B<pkg> -- general volume package statistics
45
46=item *
47
48B<vicep> -- vice partition statistics
49
50=item *
51
52B<hash> -- volume hash chain statistics
53
54=item *
55
56B<hdr> -- volume header cache statistics
57
58=item *
59
60B<vlru> -- vlru generation statistics
61
62=item *
63
64B<help> -- display list of available subcommands
65
66=back
67
68=item B<-arg1> <I<arg1>>
69
70Specifies first optional argument, in the context of the
71chosen subcommand. For I<vicep> statistics, it specifies
72partition name; for I<hash> statistics, it specifies
73hash bucket number; for I<vlru> statistics it specifies
74vlru generation number.
75
76=item B<-arg2> <I<arg2>>
77
78Specifies second optional argument, in the context of
79the chose subcommand. Currently, none of the subcommands
80use it.
81
82=item B<-reason> <I<sync protocol reason code>>
83
84Specifies numeric sync protocol reason code.
85Available codes are listed in OpenAFS source file
86F<src/vol/fssync_inline.h>. For SYNC_REASON_NONE,
87use B<-reason I<0>>.
88
89=item B<-programtype> <I<program type code>>
90
91Specifies program type code. Permitted values are
92I<fileServer>,
93I<volumeUtility>,
94I<salvager>,
95I<salvageServer>,
96I<volumeServer> and
97I<volumeSalvager>.
98
99=item B<-help>
100
101Prints the online help for this command. All other valid options are
102ignored.
103
104=back
105
106=head1 PRIVILEGE REQUIRED
107
108The issuer must have write access to the file server.
109Usually, this means that the issuer must be the
110local superuser C<root> on the file server machine.
111
112=head1 SEE ALSO
113
114L<fssync-debug_header(8)>,
115L<fssync-debug_query(8)>
116
117=head1 COPYRIGHT
118
119Copyright 2010 Davor Ocelic <docelic@spinlocksolutions.com>
120
121This documentation is covered by the IBM Public License Version 1.0. This
122man page was written by Davor Ocelic for OpenAFS, based on documentation
123from Steven Jenkins, Tom Keiser and Simon Wilkinson.