Annotation of embedaddon/ntp/README, revision 1.1.1.1

1.1       misho       1: 
                      2: Submit patches, bug reports, and enhancement requests via
                      3: 
                      4:                        http://bugs.ntp.org
                      5: 
                      6:                  The ntp Distribution Base Directory
                      7: 
                      8: This directory and its subdirectories contain the Network Time Protocol
                      9: Version 4 (NTP) distribution for Unix and Windows/NT systems.  This release
                     10: may still work on VxWorks, too.
                     11: 
                     12: The contents of the base directory are given in this file. The contents of
                     13: subdirectories are given in the README files in each subdirectory.
                     14: 
                     15: A complete explanation of the configure, compile and install process, as
                     16: well as setting up an NTP subnet, is in the HTML pages in the ./html/
                     17: directory. For more information on NTP and how to get a working setup,
                     18: read WHERE-TO-START.
                     19: 
                     20: For Windows/NT, visit html/build/hints/winnt.html .
                     21: 
                     22: The base directory ./ contains the autoconfiguration files, source
                     23: directories and related stuff:
                     24: 
                     25: COPYRIGHT      Excerpt from the HTML file ./html/copyright.html. This file
                     26:                specifies copyright conditions, together with a list of
                     27:                major authors and electric addresses.
                     28: 
                     29: INSTALL                Generic installation instructions for autoconf-based programs.
                     30:                Unless you really know what you are doing, you should read the
                     31:                directions in the HTML pages, starting with ./html/index.html.
                     32: 
                     33: NEWS           What's new in this release.
                     34: 
                     35: README         This file.
                     36: 
                     37: README.bk      Instructions for folks who use the BitKeeper-repository
                     38:                version of NTP.
                     39: 
                     40: README.hackers Notes to folks who want to hack on the code.
                     41: 
                     42: TODO            List of items the NTP developers are working on.
                     43: 
                     44: WHERE-TO-START Hints on what to read in order to get a working
                     45:                configuration.
                     46: 
                     47: Makefile.am    Automake file configuration file. Edit only if you have the
                     48:                GNU automake and autoconf utilities installed.
                     49: 
                     50: Makefile.in    Autoconf make file template for Unix.
                     51: 
                     52: adjtimed        Directory containing the sources for the adjtime daemon
                     53:                for HP/UX systems prior to HP-UX 10.0.
                     54: 
                     55: authstuff       Directory containing sources for miscellaneous programs
                     56:                to test, calibrate and certify the cryptographic
                     57:                mechanisms for DES and MD5 based authentication. These
                     58:                programs do not include the cryptographic routines
                     59:                themselves, so are free of U.S. export restrictions.
                     60: 
                     61: build          A script to build the distribution in A.`config.guess`
                     62:                subdirectory (more or less).
                     63: 
                     64: clockstuff     Directory containing sources for miscellaneous programs
                     65:                to test certain auxiliary programs used with some kernel
                     66:                configurations, together with a program to calculate
                     67:                propagation delays for use with radio clocks and
                     68:                national time dissemination services such as WWV/WWVH,
                     69:                WWVB and CHU.
                     70: 
                     71: conf            Directory containing a motley collection of
                     72:                configuration files for various systems. For example only.
                     73: 
                     74: config.guess   Script used to identify the machine architecture and
                     75:                operating system.
                     76: 
                     77: config.h.in    Configuration file generated automatically from
                     78:                configure.in. Do not edit.
                     79: 
                     80: configure      Script used to configure the distribution. See the HTML pages
                     81:                (./html/index.html) for a complete description of the options
                     82:                available.
                     83: 
                     84: configure.in   Master configuration template. Edit only if you have the
                     85:                GNU automake and autoconf utilities installed.
                     86: 
                     87: dot.emacs      C-mode indentation rules for code "Just the way Dave likes it".
                     88: 
                     89: flock_build    (UDel only) Build the distribution on a number of
                     90:                different platforms.
                     91: 
                     92: html            Directory containing a complete set of documentation on
                     93:                building and configuring a NTP server or client. The
                     94:                documentation is in the form of HTML files suitable for
                     95:                browsing and contains links to additional documentation
                     96:                at various web sites. If a browser is unavailable, an
                     97:                ordinary text editor can be used.
                     98: 
                     99: include                Directory containing include header files used by most
                    100:                programs in the distribution.
                    101: 
                    102: install-sh     Script to install a program, script or data file.
                    103: 
                    104: kernel         Directory containing sources for kernel programs such as
                    105:                line disciplines and STREAMS modules used with the CHU
                    106:                decoder and precision PPS signals.
                    107: 
                    108: libntp         Directory containing library source code used by most
                    109:                programs in the distribution.
                    110: 
                    111: ntpdate                Directory containing sources for a program to set the
                    112:                local machine time from one or more remote machines
                    113:                running NTP.  Operates like rdate, but much more accurate.
                    114: 
                    115: ntpq            Directory containing sources for a utility program to
                    116:                query local and remote NTP peers for state variables and
                    117:                related timekeeping information. This program conforms
                    118:                to Appendix A of the NTP Version 3 Specification RFC 1305.
                    119: 
                    120: ntptrace        Directory containing sources for a utility program that
                    121:                can be used to reveal the chain of NTP peers from a
                    122:                designated peer to the primary server at the root of the
                    123:                timekeeping subnet.
                    124: 
                    125: parse          Directory containing files belonging to the generic
                    126:                parse reference clock driver. For reasonably simple
                    127:                clocks it is possible to get away with about 3-4Kb of
                    128:                code. additionally the SunOS 4.x/Solaris 5.3 streams
                    129:                module for parse squats here.
                    130: 
                    131: patches                Directory containing patches already applied to this
                    132:                distribution. These are included for record and to help
                    133:                in possible porting problems.
                    134: 
                    135: scripts                Directory containing scripts to build the configuration
                    136:                files in this directory and then the makefiles used in
                    137:                various dependent directories. the subdirectories
                    138:                monitoring and support hold various perl and shell
                    139:                scripts for visualizing synchronization and daemon startup.
                    140: 
                    141: stamp.h.in     Configuration file generated automatically from configure.in.
                    142:                Do not edit.
                    143: 
                    144: util            Directory containing sources for various utility and
                    145:                testing programs.
                    146: 
                    147: David L. Mills (mills@udel.edu)
                    148: 21 June 1998

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>