summaryrefslogtreecommitdiff
path: root/gpspipe.xml
diff options
context:
space:
mode:
authorJeff Francis <jeff@gritch.org>2008-07-31 17:33:09 +0000
committerJeff Francis <jeff@gritch.org>2008-07-31 17:33:09 +0000
commit4272432d845253c97966703d68c5b0746796f795 (patch)
tree6e2a2feabd8eb9cb98c78c317e0862faa6726c24 /gpspipe.xml
parent8fe9919500bf73b8234d63eb6c9a5787fa67d0bd (diff)
downloadgpsd-4272432d845253c97966703d68c5b0746796f795.tar.gz
Add options to gpspipe to run as a daemon...
...to write output to a file (instead of stdout), and to sleep for ten seconds before attempting to connect to gpsd (useful when running from /etc/init.d/ as a daemon).
Diffstat (limited to 'gpspipe.xml')
-rw-r--r--gpspipe.xml17
1 files changed, 17 insertions, 0 deletions
diff --git a/gpspipe.xml b/gpspipe.xml
index 13df09ea..c511d8bd 100644
--- a/gpspipe.xml
+++ b/gpspipe.xml
@@ -17,6 +17,9 @@
<cmdsynopsis>
<command>gpspipe</command>
<arg choice='opt'>-h</arg>
+ <arg choice='opt'>-d</arg>
+ <arg choice='opt'>-l</arg>
+ <arg choice='opt'>-f <replaceable>filename</replaceable></arg>
<arg choice='opt'>-n <replaceable>count</replaceable></arg>
<arg choice='opt'>-r</arg>
<arg choice='opt'>-R</arg>
@@ -54,12 +57,22 @@ If omitted, <application>gpspipe</application> connects to 127.0.0.1 on
the default port (2947) and uses the first device opened by
<application>gpsd</application>.</para>
+<para><application>gpspipe</application> may be run as a daemon, but
+requires the -f flag for writing the output to a file.</para>
+
</refsect1>
<refsect1 id='options'><title>OPTIONS</title>
<para>-h makes <application>gpspipe</application> print
a usage message and exit.</para>
+<para>-d causes <application>gpspipe</application> to run as a daemon.</para>
+
+<para>-l causes <application>gpspipe</application> to sleep for ten
+seconds before attempting to connect to gpsd. This is very useful
+when running as a daemon, giving gpsd time to start before
+attempting a connection.</para>
+
<para>-r causes raw NMEA sentences to be output.</para>
<para>-R causes super-raw (gps binary) data to be output. This overrides
@@ -71,6 +84,10 @@ specified serial device with setttings 4800 8N1. Thus
to emulate a serial port hardwired to a GPS that
<application>gpsd</application> is managing.</para>
+<para>-f option causes the collected data to be written to the
+specified file. Use of this option is mandatory
+if <application>gpspipe</application> is run as a daemon.</para>
+
<para>-w causes native <application>gpsd</application>sentences to be
output.</para>