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