diff options
author | Eric S. Raymond <esr@thyrsus.com> | 2005-01-15 17:46:58 +0000 |
---|---|---|
committer | Eric S. Raymond <esr@thyrsus.com> | 2005-01-15 17:46:58 +0000 |
commit | 89ccb059b30ed82e4d74c1fd2d1e9b02be574430 (patch) | |
tree | d68c12a89649897151698900bad519223f7e754c /libgps.xml | |
parent | cc50bb3bc6a27ffcfb3c6e9ca75cb1a367e347a7 (diff) | |
download | gpsd-89ccb059b30ed82e4d74c1fd2d1e9b02be574430.tar.gz |
Integrate support for automatic reconnect on connection drop.
Diffstat (limited to 'libgps.xml')
-rw-r--r-- | libgps.xml | 16 |
1 files changed, 13 insertions, 3 deletions
@@ -76,9 +76,9 @@ interface that goes through and is intended for concurrent use by several applications, and one low-level interface that speaks directly with the serial or USB device to which the GPS is attached. This page describes the high-level -interface is safe for multiple applications to use simultaneously; it -is probably the one you want. The low-level interface is documented -at +interface that is safe for multiple applications to use +simultaneously; it is probably the one you want. The low-level +interface is documented at <citerefentry><refentrytitle>libgps</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para> <para>Calling <function>gpsd_open()</function> initializes a GPS-data @@ -106,6 +106,11 @@ user has issued an 'R' or 'W' command with to the client. If the third argument is non-NULL, it is used as a hook function to be called on each line of streamed data. </para> +<para>The <function>gpsd_query()</function> and +<function>gpsd_poll()</function> functions attempt to reconnect to the +daemon if the connection to it has been lost +(<errorname>EBADF</errorname> error).</para> + <para>Several member groups within the GPS-data structure have last-modified timestamps and change-flag members associated with them; these get updated on each query or poll as well. @@ -127,6 +132,11 @@ released when it is garbage-collected.</para> </para> </refsect1> +<refsect1 id='bugs'><title>BUGS</title> +<para>The C reconnect support uses the <varname>errno</varname> global, +and is therefore not thread-safe in the presence of frequent reconnects.</para> +</refsect1> + <refsect1 id='author'><title>AUTHOR</title> <para>Eric S. Raymond <esr@thyrsus.com>.</para> </refsect1> |