[Git][NTPsec/ntpsec][master] Clean up the devel directory.

Eric S. Raymond gitlab at mg.gitlab.com
Mon Sep 26 09:54:51 UTC 2016


Eric S. Raymond pushed to branch master at NTPsec / ntpsec


Commits:
25dc63f2 by Eric S. Raymond at 2016-09-26T05:51:14-04:00
Clean up the devel directory.

- - - - -


6 changed files:

- − devel/HISTORIC-README
- − devel/HISTORIC-VERSIONS
- − devel/HOWTO-test
- devel/README
- devel/hacking.txt
- + devel/testing.txt


Changes:

=====================================
devel/HISTORIC-README deleted
=====================================
--- a/devel/HISTORIC-README
+++ /dev/null
@@ -1,42 +0,0 @@
-The Network Time Protocol (NTP) Version 4 Distribution
-
-This is a distribution of the Network Time Protocol (NTP) Version 4
-sources and documentation. NTP can be used by Unix, DEC VMS and
-Microsoft Windows NT platforms to synchronize the computer clock to
-external sources of time, such as other NTP time servers or a local
-radio clock. The daemon included in this distribution can operate as a
-server, a client, or a relay from a set of servers to a dependent client
-population on a local net. This distribution includes the daemon itself,
-plus utility programs and supporting documentation.
-
-You are welcome to the lot, with due consideration of the copyright
-information in the COPYRIGHT file. You are also invited to contribute
-bugfixes and drivers for new and exotic radios, telephones and sundials.
-This distribution is normally available by anonymous ftp as the
-compressed tar archive ntp-<version>.tar.gz in the pub/ntp directory on
-huey.udel.edu and <version> is the version number. The current stable
-and development version numbers can be found at <http://www.ntp.org>.
-
-A considerable amount of documentation, including build instructions,
-configuration advice, program usage and miscellaneous information is
-included in the ./html directory of this distribution. The intended
-access method is using a web browser such as netscape; however, the
-pages have been formatted so that viewing with an ordinary text editor
-is practical. Start the browser on the ./html/index.html page, which
-contains additional instructions and hotlinks to the remaining pages.
-Some hotlinks for the larger documents, such as related technical
-memoranda, reports and papers, lead to other web sites where this
-information is stashed. We apologize for the inconvenience this may
-cause for users without Internet and World Wide Web access.
-
-If you are an old hand and just want to build the distribution, you
-might find the INSTALL file a useful shortcut. A descriptive list of all
-files in the base directory of this distribution is in the README file.
-A list of "significant" changes for the release is in the NEWS file.
-
-If you're interested in helping us test pre-release versions of ntpd,
-please visit http://support.ntp.org/downloads and look for RC and/or
-Development tarballs.
-
-David L. Mills (mills at udel.edu)
-21 June 1998


=====================================
devel/HISTORIC-VERSIONS deleted
=====================================
--- a/devel/HISTORIC-VERSIONS
+++ /dev/null
@@ -1,27 +0,0 @@
-
-NTP uses A.B.C - style release numbers.
-
-At the moment:
-
- A is 4, for ntp V4.
- B is the major release number.
- C is the minor release number.  Even numbers are 'stable' releases and
- odd numbers are "development" releases.
-
-Following the release number may be the letter 'p' followed by a number.
-This indicates a point (or patch) release.
-
-Release candidates have -RC in the release number.
-
-Here are some recent versions numbers as an example:
-
- 4.2.2		A production release (from the ntp-stable repository)
- 4.2.2p2	A production release (from the ntp-stable repository)
- 4.2.3p12	A development release
- 4.2.3p15-rc1	A release candidate for 4.2.4
-
-Note that after the ntp-dev repo produces a production release it will
-be copied into the ntp-stable and the cycle will repeat.
-
-Feel free to suggest improvements...
-


=====================================
devel/HOWTO-test deleted
=====================================
--- a/devel/HOWTO-test
+++ /dev/null
@@ -1,86 +0,0 @@
-This assumes you have downloaded the source and built a system
-and now you want to test your new ntpd.
-
-For help on getting that far, see ../INSTALL
-
-
-For a one off test:
-  Do "ps ax | grep ntpd" or equivalent to find out what the command line is.
-  Use whatever you do on your system to stop the normal ntpd.
-  Run ./build/ntpd/ntpd plus the command line parameters from above.
-  It will daemonize itself and give you back your terminal.
-
-Your current /etc/ntp.conf should work correctly.
-
-Check your log files to see if there is anything strange.
-Check ntpq to see if things look normal.
-
---------
-
-For a longer test, including over reboots...
-
-Install your new code using "./waf install" (as root).
-That will install your new ntpd into /usr/local/sbin/ntpd
-
-Now you have to patch your (re)start scripts to look there
-and restart ntpd.  The details vary by OS/distro.
-
-Fedora and CentOS using systemd:
-  Edit /usr/lib/systemd/system/ntpd.service
-  Change ExecStart=/usr/sbin/ntpd -u ntp:ntp $OPTIONS
-  to     ExecStart=/usr/local/sbin/ntpd -u ntp:ntp $OPTIONS
-  then   service ntpd restart
-    systemctl will barf about an out of date file and tell you
-    how to fix it.  Follow its directions and try again.
-
-dnf update may undo that edit and revert to running the system version.
-
-
-Older versions used /etc/rc.d/init.d/ntpd.
-  I put a patch in /etc/sysconfig/ntpd
-  It gets sourced so you can put real code in there.
-  systemd doesn't do that.
-  I inserted:
-    PATH="/usr/local/sbin:$PATH"
-
-
-Debian, Ubuntu, Raspbian:
-  Edit /etc/init.d/ntp
-  Change DAEMON=/usr/sbin/ntpd
-  to     DAEMON=/usr/local/sbin/ntpd
-I duplicate that line, commend out the first one and fixup the second
-one so it looks like this:
-    # DAEMON=/usr/sbin/ntpd
-    DAEMON=/usr/local/sbin/ntpd
-
-If you are using DHCP and your DHCP servers provide NTP servers,
-Debian makes a dummy ntp.conf using those servers and not the
-ones you put into the normal /etc/ntp.conf.  To use your ntp.conf
-rather than the one it wants you to:
-  Edit /etc/init.d/ntp
-  Comment out the clump of 3 lines that references dhcp:
-# if [ -e /var/lib/ntp/ntp.conf.dhcp ]; then
-#       NTPD_OPTS="$NTPD_OPTS -c /var/lib/ntp/ntp.conf.dhcp"
-# fi
-
-apt-get upgrade may undo those edits and revert to running the system version.
-
-
-FreeBSD:
-  Edit /etc/rc.conf
-  It needs to contain
-    ntpd_enable="YES"
-    ntpd_program="/usr/local/sbin/ntpd"
-If you are running ntpd, the first line will be there
-already.  The default is NO.
-
-
-NetBSD:
-  Edit /etc/rc.d/ntpd:
-  Change: command="/usr/sbin/${name}"
-  To:     command="/usr/local/sbin/${name}"
-I duplicate the line, comment out the first one and edit the second one.
-It looks like this:
-  # command="/usr/sbin/${name}"
-  command="/usr/local/sbin/${name}"
-


=====================================
devel/README
=====================================
--- a/devel/README
+++ b/devel/README
@@ -10,36 +10,36 @@ ChangeLog::
 	Changes from 2001 to mid-2015.  More recently, consult the version-
 	control comment log.
 
-hacking.txt::
-	Notes to folks who want to hack on the code.
-
 dot.emacs::
 	C-mode indentation rules for code "Just the way Dave likes it".
 
+hacking.txt::
+	Notes to folks who want to hack on the code.
+
 ifdex-ignores::
 	Lists and explains a large number of internal configuration symbols.	
 
 TODO::
 	List of items the NTPsec developers are working on.
 
+testing.txt::
+	How to qualify NTPsec for production use.
+
 tour.txt:
 	A tour of the NTP internals.
 
 HISTORIC-NEWS::
 	NTP Classic news file up to 4.2.8p3 (May 2015).
 
-HISTORIC-README::
-	Dave Mills's original README; the ftp location and some other
-	things are wrong but it maintains some historical interest.
-	Long in the source tree as WHERE-TO-START.
-
-HISTORIC-VERSIONS::
-	How to read NTP Classic version numbers.
-
 y2k.txt::
 	Notes on Y2K conformance.
 
 release.nix::
 	NixOS build recipe.
 
+trace/::
+	Configuration files for the RTEMS trace utility.  These
+	are for an experimental cross-port that is not yet
+	officially supported.
+
 //end


=====================================
devel/hacking.txt
=====================================
--- a/devel/hacking.txt
+++ b/devel/hacking.txt
@@ -343,6 +343,10 @@ for the schedule of releases, and no formal policies for how far back
 bugfixes will be backported into stable releases.  Feel free to
 discuss it with project management.
 
+Note that this is a different numbering system from NTP Classic. In
+their A.B.C numbers, A was the protocol version, B was the major, and
+C was the minor.  They also use release-candidate suffixes.
+
 == Contribution workflow and conventions ==
 
 === GitLab.com ===


=====================================
devel/testing.txt
=====================================
--- /dev/null
+++ b/devel/testing.txt
@@ -0,0 +1,138 @@
+= How To Test NTPsec =
+
+This assumes you have downloaded the source and built a system
+and now you want to test your new ntpd.
+
+For help on getting that far, see ../INSTALL
+
+== Preliminary one-off test ==
+
+For a one-off test:
+
+1. Do "ps ax | grep ntpd" or equivalent to find out what the command line is.
+
+2. Use whatever you do on your system to stop the normal ntpd.  This
+ is likely to be either something resembling "/etc/init.d/ntp stop" or
+ "systemctl stop timeservice".
+
+3. Run ./build/ntpd/ntpd plus the command line parameters from above. 
+
+4. It will daemonize itself and give you back your terminal.
+
+Your current /etc/ntp.conf should work correctly.
+
+Check your log files to see if there is anything strange.
+Run "ntpq -p" to see if things look normal.
+
+== Full qualification test ==
+
+For a longer test, including over reboots...
+
+Install your new code using "./waf install" (as root).
+That will install your new ntpd into /usr/local/sbin/ntpd
+
+Now you have to patch your (re)start scripts to look there
+and restart ntpd.  The details vary by OS/distro.
+
+=== Distributions using systemd ===
+
+1. Edit /usr/lib/systemd/system/ntpd.service
+
+2. Change ExecStart=/usr/sbin/ntpd -u ntp:ntp $OPTIONS
+   to   ExecStart=/usr/local/sbin/ntpd -u ntp:ntp $OPTIONS
+   then do "service ntpd restart"
+
+3. systemctl may barf about an out of date file and tell you
+   how to fix it.  If so, follow its directions and try again.
+
+Note that underr Fedora and CentOS, "dnf update" may undo that edit
+and revert to running the system version.
+
+Older versions used /etc/rc.d/init.d/ntpd. The file /etc/sysconfig/ntpd
+gets sourced into the init script so you can put real code in there
+(systemd doesn't do that)/  You can insert this:
+
+--------------------------------------------------
+    PATH="/usr/local/sbin:$PATH"
+--------------------------------------------------
+
+=== Debian, Ubuntu, Raspbian ===
+
+Many newer versions use systemd; follow those directions. The
+rest of this section the older set of conventions used with
+a traditional System V init sequence.
+
+Edit /etc/init.d/ntp. Change
+
+--------------------------------------------------
+DAEMON=/usr/sbin/ntpd
+--------------------------------------------------
+
+to
+
+--------------------------------------------------
+DAEMON=/usr/local/sbin/ntpd
+--------------------------------------------------
+
+A good safety measure in case you want to revert later is to duplicate
+the line, comment out the first one and edit the second one. That
+looks like this:
+
+--------------------------------------------------
+# DAEMON=/usr/sbin/ntpd
+DAEMON=/usr/local/sbin/ntpd
+--------------------------------------------------
+
+If you are using DHCP and your DHCP servers provide NTP servers,
+Debian makes a dummy ntp.conf using those servers and not the
+ones you put into the normal /etc/ntp.conf.  To use your ntp.conf
+rather than the one it wants you to:
+
+1. Edit /etc/init.d/ntp
+
+2. Comment out the clump of 3 lines that references dhcp:
+
+--------------------------------------------------
+# if [ -e /var/lib/ntp/ntp.conf.dhcp ]; then
+#       NTPD_OPTS="$NTPD_OPTS -c /var/lib/ntp/ntp.conf.dhcp"
+# fi
+--------------------------------------------------
+
+apt-get upgrade may undo those edits and revert to running the system version.
+
+=== FreeBSD ===
+
+Edit /etc/rc.conf It needs to contain this:
+
+--------------------------------------------------
+ntpd_enable="YES"
+ntpd_program="/usr/local/sbin/ntpd"
+--------------------------------------------------
+
+If you are running ntpd, the first line will be there
+already.  The default is NO.
+
+=== NetBSD ===
+
+Edit /etc/rc.d/ntpd. Change
+
+--------------------------------------------------
+command="/usr/sbin/${name}"
+--------------------------------------------------
+
+to
+
+--------------------------------------------------
+command="/usr/local/sbin/${name}"
+--------------------------------------------------
+
+A good safety measure in case you want to revert later is to duplicate
+the line, comment out the first one and edit the second one. That
+looks like this:
+
+--------------------------------------------------
+# command="/usr/sbin/${name}"
+command="/usr/local/sbin/${name}"
+--------------------------------------------------
+
+// end



View it on GitLab: https://gitlab.com/NTPsec/ntpsec/commit/25dc63f2c400f6d5e6ee1fc4c56e527a92a9cd8d
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ntpsec.org/pipermail/vc/attachments/20160926/3d78a059/attachment.html>


More information about the vc mailing list