From: Harlan Stenn Date: Thu, 26 Nov 2009 06:33:57 +0000 (-0500) Subject: Prepare for the generation of sntp.html X-Git-Tag: NTP_4_2_5P248_RC~5 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=bce6ea2483232468e8d379e9ea7dd5981456879e;p=thirdparty%2Fntp.git Prepare for the generation of sntp.html bk: 4b0e2155gnECR1nsQcaOSZRXGPzWkQ --- diff --git a/ChangeLog b/ChangeLog index 23a279be5..48f72d324 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,4 @@ +* Prepare for the generation of sntp.html. (4.2.5p247-RC) 2009/11/20 Released by Harlan Stenn * [Bug 1142] nodebug builds shed no light on -d, -D option failure. * [Bug 1179] point out the problem with -i/--jaildir and -u/--user when diff --git a/include/version.texi b/include/version.texi new file mode 100644 index 000000000..18a3f3bc3 --- /dev/null +++ b/include/version.texi @@ -0,0 +1,3 @@ +@set UPDATED 23 November 2009 +@set EDITION 4.2.5p247-RC +@set VERSION 4.2.5p247-RC diff --git a/sntp/Makefile.am b/sntp/Makefile.am index dd551be0b..d7a64463b 100644 --- a/sntp/Makefile.am +++ b/sntp/Makefile.am @@ -76,7 +76,6 @@ man_MANS= sntp.1 FRC: check-autogen-version.def: FRC -foo1: @cd $(srcdir) \ && test -r ../include/autogen-version.def \ && ( if cmp -s ../include/autogen-version.def autogen-version.def; \ @@ -86,7 +85,6 @@ foo1: fi ) check-version.def: FRC -foo2: @cd $(srcdir) \ && test -r ../include/version.def \ && ( if cmp -s ../include/version.def version.def; \ @@ -96,7 +94,6 @@ foo2: fi ) check-version.m4: FRC -foo3: @cd $(srcdir) \ && test -r ../version.m4 \ && ( if cmp -s ../version.m4 version.m4; \ @@ -106,7 +103,6 @@ foo3: fi ) check-version.texi: FRC -foo4: @cd $(srcdir) \ && test -r ../include/version.texi \ && ( if cmp -s ../include/version.texi version.texi; \ @@ -131,7 +127,7 @@ $(srcdir)/sntp.1: $(srcdir)/sntp-opts.def $(srcdir)/../include/version.def $(srcdir)/sntp-opts.texi $(srcdir)/sntp-opts.menu: $(srcdir)/sntp-opts.def $(srcdir)/../include/version.def $(run_ag) -Taginfo.tpl -DLEVEL=section sntp-opts.def -$(srcdir)/sntp.html: $(srcdir)/sntp-opts.menu $(srcdir)/sntp-opts.texi $(srcdir)/sntp.texi +$(srcdir)/sntp.html: $(srcdir)/sntp-opts.menu $(srcdir)/sntp-opts.texi $(srcdir)/sntp.texi $(srcdir)/version.texi cd $(srcdir) && makeinfo --force --html --no-split -o sntp.html sntp.texi ../libntp/libntp.a: diff --git a/sntp/depsver.mf b/sntp/depsver.mf new file mode 100644 index 000000000..3e4a6185a --- /dev/null +++ b/sntp/depsver.mf @@ -0,0 +1,67 @@ +$(DEPDIR)/deps-ver: $(top_srcdir)/deps-ver + @[ -f $@ ] || \ + cp $(top_srcdir)/deps-ver $@ + @[ -w $@ ] || \ + chmod ug+w $@ + @cmp $(top_srcdir)/deps-ver $@ > /dev/null || ( \ + $(MAKE) clean && \ + echo -n "Prior $(subdir)/$(DEPDIR) version " && \ + cat $@ && \ + rm -rf $(DEPDIR) && \ + mkdir $(DEPDIR) && \ + case "$(top_builddir)" in \ + .) \ + ./config.status Makefile depfiles \ + ;; \ + ..) \ + cd .. && \ + ./config.status $(subdir)/Makefile depfiles && \ + cd $(subdir) \ + ;; \ + *) \ + echo 'Fatal: depsver.mf Automake fragment limited' \ + 'to immediate subdirectories.' && \ + echo "top_builddir: $(top_builddir)" && \ + echo "subdir: $(subdir)" && \ + exit 1 \ + ;; \ + esac && \ + echo -n "Cleaned $(subdir)/$(DEPDIR) version " && \ + cat $(top_srcdir)/deps-ver \ + ) + cp $(top_srcdir)/deps-ver $@ + +.deps-ver: $(top_srcdir)/deps-ver + @[ ! -d $(DEPDIR) ] || $(MAKE) $(DEPDIR)/deps-ver + @touch $@ + +BUILT_SOURCES += .deps-ver +CLEANFILES += .deps-ver + +# +# depsver.mf included in Makefile.am for directories with .deps +# +# When building in the same directory with sources that change over +# time, such as when tracking using bk, the .deps files can become +# stale with respect to moved, deleted, or superceded headers. Most +# commonly, this would exhibit as make reporting a failure to make a +# header file which is no longer in the location given. To address +# this issue, we use a deps-ver file which is updated with each change +# that breaks old .deps files. A copy of deps-ver is made into +# $(DEPDIR) if not already present. If $(DEPDIR)/deps-ver is present +# with different contents than deps-ver, we make clean to ensure all +# .o files built before the incompatible change are rebuilt along with +# their updated .deps files, then remove $(DEPDIR) and recreate it as +# empty stubs. +# +# It is normal when configured with --disable-dependency-tracking for +# the DEPDIR to not have been created. For this reason, we use the +# intermediate target .deps-ver, which invokes make recursively if +# DEPDIR exists. +# +# If you modify depsver.mf, please make the changes to the master +# copy, the one in sntp is copied by the bootstrap script from it. +# +# This comment block follows rather than leads the related code so that +# it stays with it in the generated Makefile.in and Makefile. +# diff --git a/sntp/sntp.html b/sntp/sntp.html new file mode 100644 index 000000000..dcc7e9d63 --- /dev/null +++ b/sntp/sntp.html @@ -0,0 +1,105 @@ + + +Sntp User's Manual + + + + + + + + + +

Sntp User's Manual

+
+

+ +Next: , +Previous: (dir), +Up: (dir) + +
+ +

Simple Network Time Protocol User Manual

+ +

This document describes the use of the NTP Project's sntp, a program +that can be used to query a Network Time Protocol (NTP) server and +display the time offset of the system clock relative to the server +clock. Run as root, it can correct the system clock to this offset as +well. It can be run as an interactive command or from a cron job. + +

This document applies to version 4.2.5p247-RC of sntp. + +

The program implements the SNTP protocol as defined by the draft NTPv4 +IETF specification. + +

+

Short Contents

+ +
+ + + +
+

+ +Next: , +Previous: Top, +Up: Top + +
+ + +

Description

+ +

By default, sntp writes the local data and time (i.e., not UTC) to the +standard output in the format: + +

     1996 Oct 15 20:17:25.123 + 4.567 +/- 0.089 secs
+
+

where the + 4.567 +/- 0.089 secs indicates the time offset and +error bound of the system clock relative to the server clock. + + +

+

+ +Previous: sntp Description, +Up: Top + +
+ + +

Usage

+ +

The simplest use of this program is as an unprivileged command to +check the current time, offset, and error in the local clock. +For example: + +

     sntp ntpserver.somewhere
+
+

With suitable privilege, it can be run as a command or in a +crom job to reset the local clock from a reliable server, like +the ntpdate and rdate commands. +For example: + +

     sntp -a ntpserver.somewhere
+
+ + diff --git a/sntp/version.texi b/sntp/version.texi new file mode 100644 index 000000000..18a3f3bc3 --- /dev/null +++ b/sntp/version.texi @@ -0,0 +1,3 @@ +@set UPDATED 23 November 2009 +@set EDITION 4.2.5p247-RC +@set VERSION 4.2.5p247-RC