[PATCH] adjtimex.2: Add details about ADJ_FREQUENCY

From: Laurent Georget
Date: Tue Dec 30 2014 - 12:30:34 EST


Hi,

this is another patch for adjtimex(2) man page which fixes a FIXME by
giving the scaling unit of timex.freq and adds a detail about the value
expected by ADJ_FREQUENCY.

Laurent

diff --git a/man2/adjtimex.2 b/man2/adjtimex.2
index 18823c8..2652fc6 100644
--- a/man2/adjtimex.2
+++ b/man2/adjtimex.2
@@ -55,8 +55,8 @@ struct timex {
status flag is set, otherwise
microseconds */
long freq; /* Frequency offset, as scaled PPM
- (parts per million) */
-.\" FIXME What is the scaling unit of timex.freq? 2^16 ?
+ (parts per million) :
+ the scaling unit of timex.freq is 2^16 usec =
1000*2^16 nsec.
long maxerror; /* Maximum error (microseconds) */
long esterror; /* Estimated error (microseconds) */
int status; /* Clock command/status */
@@ -106,6 +106,10 @@ Set time offset from
.BR ADJ_FREQUENCY
Set frequency offset from
.IR buf.freq .
+The clock frequency must be comprised between -500000 and 500000 scaled
ns/s.
+If the given value is outside those bounds, it is silently truncated. This
+corresponds to values between -32768000 and 32768000 for
+.IR buf.freq .
.TP
.BR ADJ_MAXERROR
Set maximum time error from

Attachment: signature.asc
Description: OpenPGP digital signature