summaryrefslogtreecommitdiff
path: root/gpspipe.xml
diff options
context:
space:
mode:
authorEric S. Raymond <esr@thyrsus.com>2009-12-06 09:51:09 +0000
committerEric S. Raymond <esr@thyrsus.com>2009-12-06 09:51:09 +0000
commita270780c09e33337669f7c7f39d9733c6be01d4c (patch)
tree3a15060d1273d7666d8dd3d74e601e54fcee76cb /gpspipe.xml
parent36ffb1e3642ca147fe4f3885b41aec36491d6696 (diff)
downloadgpsd-a270780c09e33337669f7c7f39d9733c6be01d4c.tar.gz
Refactor gpspipe to use gps_stream() and gps_open().
So it becomes wire-protocol-independent (no longer generating its own ?WATCH command). It still reads froom the session socket, rather than doing gps_poll(), in order to avoide decode overhead. Building on this, use the new WATCH_DEVICE flag to make gpspipe honor the device part of a standard source specification, if that is present. Make -D an option for enabling client-library progress debugging. Rename the -f (output-file) option to -o.
Diffstat (limited to 'gpspipe.xml')
-rw-r--r--gpspipe.xml11
1 files changed, 6 insertions, 5 deletions
diff --git a/gpspipe.xml b/gpspipe.xml
index 19d0d852..e3fefcea 100644
--- a/gpspipe.xml
+++ b/gpspipe.xml
@@ -19,7 +19,7 @@
<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'>-o <replaceable>filename</replaceable></arg>
<arg choice='opt'>-n <replaceable>count</replaceable></arg>
<arg choice='opt'>-r</arg>
<arg choice='opt'>-R</arg>
@@ -27,6 +27,7 @@
<arg choice='opt'>-t</arg>
<arg choice='opt'>-w</arg>
<arg choice='opt'>-v</arg>
+ <arg choice='opt'>-D <replaceable>debug-level</replaceable></arg>
<group>
<replaceable>server</replaceable>
<group><replaceable>:port</replaceable>
@@ -52,13 +53,13 @@ to the local <application>gpsd</application> without causing problems.</para>
time stamped. There is also an option to exit gracefully after a
given count of packets.</para>
-<para>Optionally a server, tcp port number and remote device can be given.
+<para>Optionally a server, TCP/IP port number and remote device can be given.
If omitted, <application>gpspipe</application> connects to 127.0.0.1 on
-the default port (2947) and uses the first device opened by
+the default port (2947) and watches all devices 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>
+requires the -o flag for writing the output to a file.</para>
</refsect1>
<refsect1 id='options'><title>OPTIONS</title>
@@ -84,7 +85,7 @@ specified serial device with settings 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
+<para>-o 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>