Devuan fork of gpsd
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

184 lines
6.0 KiB

  1. <?xml version="1.0" encoding="ISO-8859-1"?>
  2. <!--
  3. This file is Copyright (c) 2010 by the GPSD project
  4. SPDX-License-Identifier: BSD-2-clause
  5. -->
  6. <!DOCTYPE refentry PUBLIC
  7. "-//OASIS//DTD DocBook XML V4.1.2//EN"
  8. "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
  9. <refentry id='ntpshmmon.1'>
  10. <refentryinfo><date>21 Dec 2018</date></refentryinfo>
  11. <refmeta>
  12. <refentrytitle>ntpshmmon</refentrytitle>
  13. <manvolnum>1</manvolnum>
  14. <refmiscinfo class="source">The GPSD Project</refmiscinfo>
  15. <refmiscinfo class="manual">GPSD Documentation</refmiscinfo>
  16. </refmeta>
  17. <refnamediv id='name'>
  18. <refname>ntpshmmon</refname>
  19. <refpurpose>capture samples from gpsd or other ntpd refclock sources</refpurpose>
  20. </refnamediv>
  21. <refsynopsisdiv id='synopsis'>
  22. <cmdsynopsis>
  23. <command>ntpshmmon</command>
  24. <arg choice='opt'>-? </arg>
  25. <arg choice='opt'>-h </arg>
  26. <arg choice='opt'>-n <replaceable>nsamples</replaceable></arg>
  27. <arg choice='opt'>-o </arg>
  28. <arg choice='opt'>-s </arg>
  29. <arg choice='opt'>-t <replaceable>nseconds</replaceable></arg>
  30. <arg choice='opt'>-v </arg>
  31. <arg choice='opt'>-V </arg>
  32. </cmdsynopsis>
  33. </refsynopsisdiv>
  34. <refsect1 id='description'><title>DESCRIPTION</title>
  35. <para>This program monitors the shared-memory segments updated by
  36. <citerefentry><refentrytitle>gpsd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  37. , and possibly other refclock sources, as a way of communicating with
  38. ntpd, the Network Time Protocol daemon. It reads these in exactly the way an
  39. ntpd instance does. It can be run concurrently with ntpd without
  40. interfering with ntpd's normal operation.</para>
  41. <para>This program runs forever, or until a termination option is
  42. matched, or until interrupted, generating sample reports to standard
  43. output. Each line consists of whitespace-separated textual
  44. fields.</para>
  45. <para>Here is an example of the beginning of a report file:
  46. <screen>
  47. ntpshmmon version 3.18
  48. # Name Seen@ Clock Real L Pre
  49. sample NTP2 1424926256.443030206 1424926256.115869233 1424926256.000000000 0 -1
  50. sample NTP3 1424926256.443060517 1424926255.995430821 1424926256.000000000 0 -20
  51. sample NTP3 1424926256.995747347 1424926256.995422728 1424926257.000000000 0 -20
  52. sample NTP2 1424926257.112433572 1424926257.111936726 1424926257.000000000 0 -1
  53. sample NTP3 1424926257.996221153 1424926257.995410232 1424926258.000000000 0 -20
  54. sample NTP2 1424926258.107769409 1424926258.107451006 1424926258.000000000 0 -1
  55. sample NTP3 1424926258.995647636 1424926258.995406476 1424926259.000000000 0 -20
  56. </screen></para>
  57. <para>The output always begins with a header line expressing the
  58. version of the output format; the version line begins with "ntpshmmon
  59. version" and is followed by a numeric version field.</para>
  60. <para>The remainder of the file is either commments or sample lines. A
  61. comment line begins with a # and should ignored by programs that
  62. interpret this format.</para>
  63. <para>The fields of a sample line are as follows:
  64. <orderedlist>
  65. <listitem><para>The keyword "sample"</para></listitem>
  66. <listitem><para>The NTP unit from which it was collected.</para></listitem>
  67. <listitem><para>Collection time of day, seconds.</para></listitem>
  68. <listitem><para>Receiver time of day, seconds.</para></listitem>
  69. <listitem><para>Clock time of day, seconds.</para></listitem>
  70. <listitem><para>Leap-second notification status.</para></listitem>
  71. <listitem><para>Source precision (log(2) of source jitter).</para></listitem>
  72. </orderedlist>
  73. </para>
  74. <para>In these fields, "clock time" is the high-precision system clock
  75. time measured by the source and "receiver time" is from the receiver.
  76. Both times are in UTC. It is normal for the seconds part of receiver
  77. time to coincide with the seconds part of collection time and for the
  78. nanoseconds part of receiver time to be zero.</para>
  79. <para>If the -o option is used, the "Seen@" column is replaced with the
  80. "Offset" column. The "Offset" is the difference between "Clock" and
  81. "Real" times.</para>
  82. </refsect1>
  83. <refsect1 id='options'><title>OPTIONS</title>
  84. <variablelist>
  85. <varlistentry>
  86. <term>-?</term>
  87. <listitem>
  88. <para>Display program usage and exit.</para>
  89. </listitem>
  90. </varlistentry>
  91. <varlistentry>
  92. <term>-h</term>
  93. <listitem>
  94. <para>Display program usage and exit.</para>
  95. </listitem>
  96. </varlistentry>
  97. <varlistentry>
  98. <term>-n</term>
  99. <listitem>
  100. <para>Set maximum number of samples to collect.</para>
  101. </listitem>
  102. </varlistentry>
  103. <varlistentry>
  104. <term>-o</term>
  105. <listitem>
  106. <para>Replace the "Seen@" column with the "Offset" column. The "Offset" is
  107. the difference between "Clock" and "Real" times.
  108. </para>
  109. </listitem>
  110. </varlistentry>
  111. <varlistentry>
  112. <term>-s</term>
  113. <listitem>
  114. <para>Remove all SHM segments used by GPSD. This
  115. option will normally only be of interest to GPSD developers.</para>
  116. </listitem>
  117. </varlistentry>
  118. <varlistentry>
  119. <term>-t</term>
  120. <listitem>
  121. <para>Set maximum time to collect samples in seconds.</para>
  122. </listitem>
  123. </varlistentry>
  124. <varlistentry>
  125. <term>-v</term>
  126. <listitem>
  127. <para>Enable verbose status messages.</para>
  128. </listitem>
  129. </varlistentry>
  130. <varlistentry>
  131. <term>-V</term>
  132. <listitem>
  133. <para>Display program version and exit.</para>
  134. </listitem>
  135. </varlistentry>
  136. </variablelist>
  137. </refsect1>
  138. <refsect1 id='see_also'><title>SEE ALSO</title>
  139. <para>
  140. <citerefentry><refentrytitle>gpsd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
  141. <citerefentry><refentrytitle>gpsdctl</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
  142. <citerefentry><refentrytitle>gps</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  143. <citerefentry><refentrytitle>libgps</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
  144. <citerefentry><refentrytitle>libgpsmm</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
  145. <citerefentry><refentrytitle>gpsprof</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  146. <citerefentry><refentrytitle>gpsfake</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
  147. </para>
  148. </refsect1>
  149. <refsect1 id='maintainer'><title>AUTHOR</title>
  150. <para>Eric S. Raymond <email>esr@thyrsus.com</email>.</para>
  151. </refsect1>
  152. </refentry>