summaryrefslogtreecommitdiff
path: root/gpsd.xml
diff options
context:
space:
mode:
authorEric S. Raymond <esr@thyrsus.com>2011-08-19 04:04:42 -0400
committerEric S. Raymond <esr@thyrsus.com>2011-08-19 04:04:42 -0400
commit2551c7b16d4ff0abc1b33a995122d8c0cd20ff79 (patch)
treeb4c043a29552fa5a35de6b72f947c8a6321881de /gpsd.xml
parentdb373d933decad0ba097cc89de4b3f2cc9218c95 (diff)
downloadgpsd-2551c7b16d4ff0abc1b33a995122d8c0cd20ff79.tar.gz
The -N option no longer drops privileges.
The price is that only devices specified on the gpsd commmand line will do PPS, because the calls to set line discipline stop being available after we drop privileges. In practice, this shouldn't be a problem, as PPS devices ar RS232 ports that can't be hotplugged and thus *must* be specified on the command line. All regression tests pass.
Diffstat (limited to 'gpsd.xml')
-rw-r--r--gpsd.xml10
1 files changed, 8 insertions, 2 deletions
diff --git a/gpsd.xml b/gpsd.xml
index d5483726..1ecbfee1 100644
--- a/gpsd.xml
+++ b/gpsd.xml
@@ -193,8 +193,8 @@ nonexistent in USB GPSes which lack a DTR line.)</para>
</varlistentry>
<varlistentry>
<term>-N</term>
-<listitem><para>Don't daemonize; run in foreground. Also suppresses
-privilege-dropping. This switch is mainly useful for debugging.</para>
+<listitem><para>Don't daemonize; run in foreground.
+This switch is mainly useful for debugging.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -795,6 +795,12 @@ supported.</para>
<para>The ISGPS used for RTCM2 and subframes decoder logic is
sufficiently convoluted to confuse some compiler optimizers, notably
in GCC 3.x at -O2, into generating bad code.</para>
+
+<para>Devices meant to to use PPS for high-precision timekeeping may
+fail if they are specifed after startup by a control-socket command,
+as opposed to on the daemon's original command line. (Root privileges
+are dropped early, and some Unix varients require them in order to set
+the PPS line discipline.)</para>
</refsect1>
<refsect1 id='files'><title>FILES</title>