GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NTPSHMMON (1)

.ds Aq ’

NAME

ntpshmmon - capture samples from GPS or other ntpd refclock sources

CONTENTS

SYNOPSIS

ntpshmmon [-h] [-n nsamples] [-s] [-t seconds] [-v] [-V]

DESCRIPTION

This program monitors the shared-memory segments updated by gpsd(8) (and possibly other refclock sources) as a way of communicating with ntpd, the Network Time Protocol daemon. It reads these in exactly the way an ntpd instance does. It can be run concurrently with ntpd without interfering with ntpds normal operation.

This program runs forever, or until a termination option is matched, or until interrupted, generating sample reports to standard output. Each line consists of whitespace-separated textual fields.

Here is an example of the beginning of a report file:

ntpshmmon version 1
sample NTP2 1424926256.443030206 1424926256.115869233 1424926256.000000000 0  -1
sample NTP3 1424926256.443060517 1424926255.995430821 1424926256.000000000 0 -20
sample NTP3 1424926256.995747347 1424926256.995422728 1424926257.000000000 0 -20
sample NTP2 1424926257.112433572 1424926257.111936726 1424926257.000000000 0  -1
sample NTP3 1424926257.996221153 1424926257.995410232 1424926258.000000000 0 -20
sample NTP2 1424926258.107769409 1424926258.107451006 1424926258.000000000 0  -1
sample NTP3 1424926258.995647636 1424926258.995406476 1424926259.000000000 0 -20

The output always begins with a header line expressing the version of the output format; the version line begins with "ntpshmmon version" and is followed by a numeric version field.

The remainder of the file is sample lines. The fields of a sample line are as follows:

1.

1. The keyword "sample"

2.

2. The NTP unit from which it was collected.

3.

3. Collection time of day, seconds.

4.

4. Receiver time of day, seconds.

5.

5. Clock time of day, seconds.

6.

6. Leap-second notification status.

7.

7. Source precision (log(2) of source jitter).

In these fields, "clock time" is the high-precision time measured by the source and "receiver time" is Unix UTC time at the receiver. It is normal for the seconds part of receiver time to coincide with the seconds part of collection time and for the nanoseconds part of receiver time to be zero.

-v

Enable verbose status messages.

-n

Set maximum number of samples to collect.

-s

Remove all segments specified by the units argument. This option will normally only be of interest to GPSD developers.

-t

Set maximum time to collect samples in seconds.

-h

Display program usage and exit.

-V

Display program version and exit.

SEE ALSO

gpsd(8), gpsdctl(8), gps(1), libgps(3), libgpsd(3), gpsprof(1), gpsfake(1).

AUTHOR

Eric S. Raymond esr@thyrsus.com.

Search for    or go to Top of page |  Section 1 |  Main Index


The GPSD Project NTPSHMMON (1) 25 Jan 2015

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.