diff options
author | Eric S. Raymond <esr@thyrsus.com> | 2009-12-06 09:51:09 +0000 |
---|---|---|
committer | Eric S. Raymond <esr@thyrsus.com> | 2009-12-06 09:51:09 +0000 |
commit | a270780c09e33337669f7c7f39d9733c6be01d4c (patch) | |
tree | 3a15060d1273d7666d8dd3d74e601e54fcee76cb /gpspipe.xml | |
parent | 36ffb1e3642ca147fe4f3885b41aec36491d6696 (diff) | |
download | gpsd-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.xml | 11 |
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> |