summaryrefslogtreecommitdiff
path: root/external/bsd/ntp/dist/scripts/summary.1summarymdoc
blob: 9ca2a8164e1c2c6f0bc27b2a3240bb3985fd8b38 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
.Dd December 24 2013
.Dt SUMMARY 1summarymdoc User Commands
.Os SunOS 5.10
.\"  EDIT THIS FILE WITH CAUTION  (summary-opts.mdoc)
.\"
.\"  It has been AutoGen-ed  December 24, 2013 at 11:36:07 AM by AutoGen 5.18.3pre5
.\"  From the definitions    summary-opts.def
.\"  and the template file   agmdoc-cmd.tpl
.Sh NAME
.Nm summary
.Nd compute various stastics from NTP stat files
.Sh SYNOPSIS
.Nm
.Op Fl \-option\-name
.Op Fl \-option\-name Ar value
.Pp
All arguments must be options.
.Pp
.Sh DESCRIPTION
.sp
.Sh "OPTIONS"
.Bl -tag
.It  Fl \-directory  Ns = Ns Ar string 
Directory containing stat files.
The default
.Ar string
for this option is:
.ti +4
 /var/log/ntp
.sp
        The directory where \fBntpd\fP will search for .stat files generated
        by \fBntpd\fP.
.It  Fl \-end\-date  Ns = Ns Ar number 
End date.
This option takes an integer number as its argument.
.sp
        Process all files with the date suffix less or equal to value of this
        option.  Defaults to today minus one day (Use \fBdate \-u +%Y%m%d\fP)
        to get the timestamp.
.It  Fl \-output\-directory  Ns = Ns Ar str 
Output directory.
The default
.Ar str
for this option is:
.ti +4
 /tmp
.sp
        The output directory \fBsummary\fP will write all output files to.
.It  Fl \-peer\-dist\-limit  Ns = Ns Ar float 
Peer dist limit.
The default
.Ar float
for this option is:
.ti +4
 400
.sp
.It  Fl \-skip\-time\-steps  Ns = Ns Ar float 
Ignore time offsets larger that this.
The default
.Ar float
for this option is:
.ti +4
 3600
.sp
.It  Fl \-start\-date  Ns = Ns Ar num 
Start date.
This option takes an integer number as its argument.
The default
.Ar num
for this option is:
.ti +4
 19700101
.sp
        Process all files with the date suffix more or equal to value of
        this option.  Defaults to 197000101.
.It Fl \-help
Display usage information and exit.
.It Fl \-more\-help
Pass the extended usage information through a pager.
.El
cvt_prog='/usr/local/gnu/share/autogen/texi2mdoc'
cvt_prog=`cd \`dirname "$cvt_prog"\` >/dev/null && pwd
         `/`basename "$cvt_prog"`
cd $tmp_dir
test \-x "$cvt_prog" || die "'$cvt_prog' is not executable"
{
    list='synopsis description options option\-presets'
    for f in $list ; do cat $f ; echo ; done
    rm \-f $list name
    list='implementation\-notes environment files examples exit\-status errors
        compatibility see\-also conforming\-to history authors copyright bugs
        notes'
    for f in $list ; do cat $f ; echo ; done > .end\-doc
    rm \-f $list
    list=`ls \-1 *`' .end\-doc'
    for f in $list ; do cat $f ; echo ; done
    rm \-f $list
} 1>.doc 2>/dev/null
/usr/local/gnu/bin/grep \-E \-v '^[ 	]*$' .doc | $cvt_prog
.Sh "EXIT STATUS"
One of the following exit values will be returned:
.Bl -tag
.It 0 " (EXIT_SUCCESS)"
Successful program execution.
.It 1 " (EXIT_FAILURE)"
The operation failed or the command syntax was not valid.
.It 70 " (EX_SOFTWARE)"
libopts had an internal operational error.  Please report
it to autogen\-users@lists.sourceforge.net.  Thank you.
.El
.Sh "NOTES"
This manual page was \fIAutoGen\fP\-erated from the \fBsummary\fP
option definitions.