Commit 205926d2 authored by Sanjeev Gupta's avatar Sanjeev Gupta Committed by Eric S. Raymond

Work through FIXME in docs, updating markup and links

parent b2100ffc
......@@ -164,7 +164,7 @@ selects the key used as the password for the {ntpqman} utility.
//strong security against replay with or without modification, spoofing,
//masquerade and most forms of clogging attacks.
//
////FIXME: page reference may be invalid
//FIXME: page reference may be invalid
//The Autokey protocol has several modes of operation corresponding to
//the various NTP modes supported. Most modes use a special cookie which
//can be computed independently by the client and server, but encrypted
......
......@@ -49,7 +49,6 @@ The various GPS sentences that this driver recognises look like this:
|$GPZDG,GPSTIME,DD,MM,YYYY,AA.BB,V*CS<cr><lf>|Accord
|=============================================================================
//FIXME: 'GPS sync status' in table not indented properly
.NMEA data items
[cols="15%,85%",options="header"]
[options="header"]
......@@ -185,7 +184,6 @@ example:
Sentences like $GPGSV that don't contain the time will get counted in
the total but otherwise ignored.
//FIXME: ntp.org reference
http://support.ntp.org/bin/view/Support/ConfiguringNMEARefclocks[Configuring
NMEA Refclocks] might give further useful hints for specific hardware
devices that exhibit strange or curious behaviour.
......
......@@ -11,7 +11,7 @@ PPS Port: /dev/oncore.pps._u_
== Description ==
This driver supports most models of the
http://www.mot.com/AECS/PNSB/products[Motorola Oncore GPS receivers]
https://web.archive.org/web/19990427102123/http://www.mot.com/AECS/PNSB/products/produt.html[Motorola Oncore GPS receivers]
(Basic, PVT6, VP, UT, UT+, GT, GT+, SL, M12, M12+T), as long as they
support the _Motorola Binary Protocol_.
......@@ -21,7 +21,7 @@ available new, and the UT, GT, and SL are at end-of-life. The Motorola
evaluation kit can be recommended. It interfaces to a PC straightaway,
using the serial (DCD) or parallel port for PPS input and packs the
receiver in a nice and sturdy box. Less expensive interface kits are
available from http://www.tapr.org[TAPR] and
available from http://www.tapr.org[TAPR].
[width="100%",cols="<34%,<33%,<33%",align="center",frame="none",grid="none"]
|==========================================================================
......@@ -84,10 +84,9 @@ on Linux, SunOS and Solaris.
=== Configuration ===
//FIXME: Ignored backticks around ntp.oncore
There is a driver specific configuration file +ntp.oncore+ (or
+ntp.oncore.+_u_ or +ntp.oncore+_u_ if you must distinguish between more
than one Oncore receiver) that contains information on the startup mode,
+ntp.oncore.+'u' or +ntp.oncore+'u' if you must distinguish between more
than one Oncore receiver _unit_) that contains information on the startup mode,
the location of the GPS receiver, an offset of the PPS signal from zero,
and the cable delay. The offset shifts the PPS signal to avoid interrupt
pileups +on' the second, and adjusts the timestamp accordingly. See the
......@@ -109,8 +108,8 @@ factor will be the timebase of the computer and the precision with which
you can timestamp the rising flank of the PPS signal. Using FreeBSD, a
FPGA based Timecounter/PPS interface, and an ovenized quartz oscillator,
that performance has been reproduced. For more details on this aspect:
http://phk.freebsd.dk/rover.html[Sub-Microsecond timekeeping under
FreeBSD].
https://web.archive.org/web/19990221121441/http://phk.freebsd.dk/rover.html[Sub-Microsecond
timekeeping under FreeBSD].
'''''
......
......@@ -21,11 +21,11 @@ precision timing applications. This driver supports all compatible
receivers such as the 6-channel MX4200, MX4200D, and the 12-channel
MX9212, MX9012R, MX9112.
//FIXME: caption and float attributes not showing up correctly
image:pic/9400n.jpg["MX9400N",float="left",link="http://www.leica-gps.com/", caption="Leica MX9400N Navigator"] http://www.leica-gps.com/[Leica Geosystems] acquired the
Magnavox commercial GPS technology business in February of 1994. They
now market and support former Magnavox GPS products such as the MX4200
and its successors.
image:pic/9400n.jpg["MX9400N",float="left",caption="Leica MX9400N Navigator"]
https://web.archive.org/web/19971014210945/http://www.leica-gps.com/[Leica
Geosystems] acquired the Magnavox commercial GPS technology business in
February of 1994. They marketed and supported former Magnavox GPS
products such as the MX4200 and its successors.
== Operating Modes ==
......
......@@ -72,8 +72,7 @@ process inserts a dummy infinity sample in the shift register for each
poll sent. After eight polls, the register returns to its original
state.
//FIXME: Image pair not centered
image:pic/flt1.gif[] image:pic/flt2.gif[]
image:pic/flt1.gif["Raw",align="left"] image:pic/flt2.gif["Filtered",align="right"]
Figure 2. Raw (left) and Filtered (right) Offsets
......
......@@ -36,10 +36,17 @@ that can clog the server and network infrastructure. On the other hand,
friendly clients need to avoid configurations that can result in
unfriendly behavior.
//FIXME: add footnote ref.
A review of past client abuse incidence shows the most frequent scenario
is a broken client that attempts to send packets at rates of one per
second or more. On one occasion due to a defective client design [1],
second or more. On one occasion due to a defective client design
footnote:[1. Mills, D.L., J. Levine, R. Schmidt and D. Plonka. Coping with
overload on the Network Time Protocol public servers. _Proc. Precision
Time and Time Interval (PTTI) Applications and Planning Meeting_
(Washington DC, December 2004), 5-16. Paper:
{millshome}database/papers/ptti/ptti04a.pdf[PDF],
Slides:{millshome}database/brief/ptti/ptti04.pdf[PDF]
|
{millshome}database/brief/ptti/ptti04.ppt[PowerPoint]]
over 750,000 clients demonstrated this abuse. There have been occasions
where this abuse has persisted for days at a time. These scenarios are
the most damaging, as they can threaten not only the victim server but
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment