[src/trunk]: src/external/bsd/ntp add installation of manual pages, html file...

[kardel <kardel%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9b08558b996f
branches:  trunk
changeset: 757420:9b08558b996f
user:      kardel <kardel%NetBSD.org@localhost>
date:      Sat Aug 28 15:42:45 2010 +0000

description:
add installation of manual pages, html files and up to now missing commands (sntp, ntptrace)

diffstat:

 external/bsd/ntp/Makefile                  |    4 +-
 external/bsd/ntp/bin/Makefile              |    4 +-
 external/bsd/ntp/bin/Makefile.inc          |    2 +-
 external/bsd/ntp/bin/ntp-keygen/Makefile   |    7 +-
 external/bsd/ntp/bin/ntpd/Makefile         |    8 +-
 external/bsd/ntp/bin/ntpdate/Makefile      |    4 +-
 external/bsd/ntp/bin/ntpdate/ntpdate.8     |  203 +++++++++++++++++++++++++++++
 external/bsd/ntp/bin/ntpdc/Makefile        |    7 +-
 external/bsd/ntp/bin/ntpq/Makefile         |    7 +-
 external/bsd/ntp/bin/ntptime/Makefile      |    4 +-
 external/bsd/ntp/bin/ntptime/ntptime.8     |   59 ++++++++
 external/bsd/ntp/bin/ntptrace/Makefile     |    7 +
 external/bsd/ntp/bin/ntptrace/ntptrace.8   |   61 ++++++++
 external/bsd/ntp/bin/ntptrace/ntptrace.awk |  131 ++++++++++++++++++
 external/bsd/ntp/bin/sntp/Makefile         |   27 +++
 external/bsd/ntp/html/Makefile             |  139 +++++++++++++++++++
 16 files changed, 656 insertions(+), 18 deletions(-)

diffs (truncated from 821 to 300 lines):

diff -r b0ac80b378f6 -r 9b08558b996f external/bsd/ntp/Makefile
--- a/external/bsd/ntp/Makefile Sat Aug 28 15:40:24 2010 +0000
+++ b/external/bsd/ntp/Makefile Sat Aug 28 15:42:45 2010 +0000
@@ -1,5 +1,5 @@
-#      $NetBSD: Makefile,v 1.1 2009/12/13 17:13:49 kardel Exp $
+#      $NetBSD: Makefile,v 1.2 2010/08/28 15:42:46 kardel Exp $
 
-SUBDIR+= lib .WAIT bin
+SUBDIR+= lib .WAIT bin html
 
 .include <bsd.subdir.mk>
diff -r b0ac80b378f6 -r 9b08558b996f external/bsd/ntp/bin/Makefile
--- a/external/bsd/ntp/bin/Makefile     Sat Aug 28 15:40:24 2010 +0000
+++ b/external/bsd/ntp/bin/Makefile     Sat Aug 28 15:42:45 2010 +0000
@@ -1,6 +1,6 @@
-#      $NetBSD: Makefile,v 1.1 2009/12/13 17:13:48 kardel Exp $
+#      $NetBSD: Makefile,v 1.2 2010/08/28 15:42:46 kardel Exp $
 
-SUBDIR= ntp-keygen ntpd ntpdate ntpdc ntpq ntptime
+SUBDIR= ntp-keygen ntpd ntpdate ntpdc ntpq ntptime ntptrace sntp 
 
 .if ("${MKCRYPTO}" != "no")
 SUBDIR+= ntp-keygen
diff -r b0ac80b378f6 -r 9b08558b996f external/bsd/ntp/bin/Makefile.inc
--- a/external/bsd/ntp/bin/Makefile.inc Sat Aug 28 15:40:24 2010 +0000
+++ b/external/bsd/ntp/bin/Makefile.inc Sat Aug 28 15:42:45 2010 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile.inc,v 1.1 2009/12/13 17:13:48 kardel Exp $
+#      $NetBSD: Makefile.inc,v 1.2 2010/08/28 15:42:46 kardel Exp $
 
 .include "../Makefile.inc"
 
diff -r b0ac80b378f6 -r 9b08558b996f external/bsd/ntp/bin/ntp-keygen/Makefile
--- a/external/bsd/ntp/bin/ntp-keygen/Makefile  Sat Aug 28 15:40:24 2010 +0000
+++ b/external/bsd/ntp/bin/ntp-keygen/Makefile  Sat Aug 28 15:42:45 2010 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.1 2009/12/13 17:13:48 kardel Exp $
+#      $NetBSD: Makefile,v 1.2 2010/08/28 15:42:46 kardel Exp $
 
 NOGCCERROR=yes
 
@@ -6,7 +6,7 @@
 
 
 PROG=  ntp-keygen
-MAN=
+MAN=   ntp-keygen.8
 BINDIR=        /usr/sbin
 
 SRCS=  ntp-keygen-opts.c       \
@@ -23,4 +23,7 @@
 
 .PATH: ${DIST}
 
+ntp-keygen.8:  ntp-keygen.1
+       @cp $? $@
+
 .include <bsd.prog.mk>
diff -r b0ac80b378f6 -r 9b08558b996f external/bsd/ntp/bin/ntpd/Makefile
--- a/external/bsd/ntp/bin/ntpd/Makefile        Sat Aug 28 15:40:24 2010 +0000
+++ b/external/bsd/ntp/bin/ntpd/Makefile        Sat Aug 28 15:42:45 2010 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.1 2009/12/13 17:13:48 kardel Exp $
+#      $NetBSD: Makefile,v 1.2 2010/08/28 15:42:46 kardel Exp $
 
 NOGCCERROR=yes
 
@@ -6,8 +6,7 @@
 
 
 PROG=  ntpd
-MAN=
-#MAN=  named.8 lwresd.8 named.conf.5
+MAN=   ntpd.8
 BINDIR=        /usr/sbin
 
 SRCS=  cmd_args.c                              \
@@ -86,4 +85,7 @@
 
 .PATH: ${DIST}
 
+ntpd.8: ntpd.1
+       @cp $? $@
+
 .include <bsd.prog.mk>
diff -r b0ac80b378f6 -r 9b08558b996f external/bsd/ntp/bin/ntpdate/Makefile
--- a/external/bsd/ntp/bin/ntpdate/Makefile     Sat Aug 28 15:40:24 2010 +0000
+++ b/external/bsd/ntp/bin/ntpdate/Makefile     Sat Aug 28 15:42:45 2010 +0000
@@ -1,9 +1,9 @@
-#      $NetBSD: Makefile,v 1.1 2009/12/13 17:13:48 kardel Exp $
+#      $NetBSD: Makefile,v 1.2 2010/08/28 15:42:46 kardel Exp $
 
 .include <bsd.own.mk>
 
 PROG=  ntpdate
-MAN=
+MAN=   ntpdate.8
 BINDIR=        /usr/sbin
 
 SRCS=  ntpdate.c
diff -r b0ac80b378f6 -r 9b08558b996f external/bsd/ntp/bin/ntpdate/ntpdate.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/external/bsd/ntp/bin/ntpdate/ntpdate.8    Sat Aug 28 15:42:45 2010 +0000
@@ -0,0 +1,203 @@
+.\"    $NetBSD: ntpdate.8,v 1.1 2010/08/28 15:42:46 kardel Exp $
+.\" Converted from HTML to mandoc by ntp-html2mdoc.pl
+.\"
+.Dd January 28, 2010
+.Dt NTPDATE 8
+.Os
+.Sh NAME
+.Nm ntpdate
+.Nd set the date and time via NTP
+.Sh SYNOPSIS
+.Nm
+.Op Fl bBdoqsuv
+.Op Fl a Ar key
+.Op Fl e Ar authdelay
+.Op Fl k Ar keyfile
+.Op Fl o Ar version
+.Op Fl p Ar samples
+.Op Fl t Ar timeout
+.Op Ar server ...
+.Sh DESCRIPTION
+.Nm
+sets the local date and time by polling the Network Time
+Protocol (NTP) server(s) given as the
+.Ar server
+arguments to determine
+the correct time. It must be run as root on the local host. A number of
+samples are obtained from each of the servers specified and a subset of
+the NTP clock filter and selection algorithms are applied to select the
+best of these. Note that the accuracy and reliability of
+.Nm
+depends on the number of servers, the number of polls each time it is run
+and the interval between runs.
+.Pp
+.Nm
+can be run manually as necessary to set the host clock,
+or it can be run from the host startup script to set the clock at boot
+time. This is useful in some cases to set the clock initially before starting
+the NTP daemon
+.Pa ntpd .
+It is also possible to run
+.Nm
+from a
+.Pa cron
+script. However, it is important to note that
+.Nm
+with contrived
+.Pa cron
+scripts is no substitute for the NTP daemon,
+which uses sophisticated algorithms to maximize accuracy and reliability
+while minimizing resource use. Finally, since
+.Nm
+does not
+discipline the host clock frequency as does
+.Pa ntpd ,
+the accuracy
+using
+.Nm
+is limited.
+.Pp
+Time adjustments are made by
+.Nm
+in one of two ways. If
+.Nm
+determines the clock is in error more than 0.5 second
+it will simply step the time by calling the system
+.Xr settimeofday 2
+routine. If the error is less than 0.5 seconds, it will slew the time by
+calling the system
+.Xr adjtime 2
+routine. The latter technique is
+less disruptive and more accurate when the error is small, and works quite
+well when
+.Nm
+is run by
+.Pa cron
+every hour or two.
+.Pp
+.Nm
+will decline to set the date if an NTP server daemon
+(e.g.,
+.Pa ntpd
+) is running on the same host. When running
+.Nm
+on a regular basis from
+.Pa cron
+as an alternative to running a daemon,
+doing so once every hour or two will result in precise enough timekeeping
+to avoid stepping the clock.
+.Pp
+If NetInfo support is compiled into
+.Nm ,
+then the
+.Pa server
+argument is optional if
+.Nm
+can find a time
+server in the NetInfo configuration for
+.Pa ntpd
+.
+.Sh COMMAND LINE OPTIONS
+.Bl -tag -width indent
+.It Fl a Ar key
+Enable the authentication function and specify the key identifier to be
+used for authentication as the argument
+.Ar key
+.Nm .
+The
+keys and key identifiers must match in both the client and server key files.
+The default is to disable the authentication function.
+.It Fl B
+Force the time to always be slewed using the adjtime() system call, even
+if the measured offset is greater than +-128 ms. The default is to step
+the time using settimeofday() if the offset is greater than +-128 ms. Note
+that, if the offset is much greater than +-128 ms in this case, that it
+can take a long time (hours) to slew the clock to the correct value. During
+this time. the host should not be used to synchronize clients.
+.It Fl b
+Force the time to be stepped using the settimeofday() system call, rather
+than slewed (default) using the adjtime() system call. This option should
+be used when called from a startup file at boot time.
+.It Fl d
+Enable the debugging mode, in which
+.Nm
+will go through all
+the steps, but not adjust the local clock. Information useful for general
+debugging will also be printed.
+.It Fl e Ar authdelay
+Specify the processing delay to perform an authentication function as the
+value
+.Ar authdelay
+, in seconds and fraction (see
+.Pa ntpd
+for
+details). This number is usually small enough to be negligible for most
+purposes, though specifying a value may improve timekeeping on very slow
+CPU's.
+.It Fl k Ar keyfile
+Specify the path for the authentication key file as the string
+.Ar keyfile
+.
+The default is
+.Pa /etc/ntp.keys .
+This file should be in the format
+described in
+.Pa ntpd
+.
+.It Fl o Ar version
+Specify the NTP version for outgoing packets as the integer
+.Ar version
+,
+which can be 1 or 2. The default is 3. This allows
+.Nm
+to
+be used with older NTP versions.
+.It Fl p Ar samples
+Specify the number of samples to be acquired from each server as the integer
+.Ar samples
+, with values from 1 to 8 inclusive. The default is 4.
+.It Fl q
+Query only - don't set the clock.
+.It Fl s
+Divert logging output from the standard output (default) to the system
+.Pa syslog
+facility. This is designed primarily for convenience of
+.Pa cron
+scripts.
+.It Fl t Ar timeout
+Specify the maximum time waiting for a server response as the value
+.Ar timeout
+,
+in seconds and fraction. The value is rounded to a multiple of 0.2 seconds.
+The default is 1 second, a value suitable for polling across a LAN.
+.It Fl u
+Direct
+.Nm
+to use an unprivileged port for outgoing packets.
+This is most useful when behind a firewall that blocks incoming traffic
+to privileged ports, and you want to synchronise with hosts beyond the
+firewall. Note that the
+.Fl d
+option always uses unprivileged ports.
+.It Fl v
+Be verbose. This option will cause
+.Nm
+'s version identification
+string to be logged.
+.El
+.Sh FILES
+.Bl -tag -width /etc/ntp.keys -compact
+.It Pa /etc/ntp.keys
+encryption keys used by
+.Nm .
+.El
+.Sh AUTHORS
+David L. Mills (mills%udel.edu@localhost)
+.Sh BUGS