[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