summaryrefslogtreecommitdiff
path: root/gpxlogger.xml
diff options
context:
space:
mode:
authorRobert Norris <rw_norris@hotmail.com>2017-03-08 00:24:14 +0000
committerFred Wright <fw@fwright.net>2017-03-17 15:44:59 -0700
commit8c2cefb7a0400f3ddb215a9605f5cd26fea56537 (patch)
tree7bb652adecfad8bcf19aeebdb62d01fd68d19d0f /gpxlogger.xml
parent02d31b09c4e85942c23ef8de52bbaa1240286d9c (diff)
downloadgpsd-8c2cefb7a0400f3ddb215a9605f5cd26fea56537.tar.gz
Separate gpxlogger man page
As a more stand-alone application, shift gpxlogger help into it's own dedicated man page. This also aids the separate distribution of a Windows version of gpxlogger, where the .html version of help can be supplied. TESTED: 'scons build-all www' generates current man pages and the new versions of gpxlogger.1 and gpxlogger.html Signed-off-by: Fred Wright <fw@fwright.net>
Diffstat (limited to 'gpxlogger.xml')
-rw-r--r--gpxlogger.xml149
1 files changed, 149 insertions, 0 deletions
diff --git a/gpxlogger.xml b/gpxlogger.xml
new file mode 100644
index 00000000..41c20c24
--- /dev/null
+++ b/gpxlogger.xml
@@ -0,0 +1,149 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+This file is Copyright (c) 2017 by the GPSD project
+BSD terms apply: see the file COPYING in the distribution root for details.
+-->
+<!DOCTYPE refentry PUBLIC
+ "-//OASIS//DTD DocBook XML V4.1.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+<refentry id='gpxlogger.1'>
+<refentryinfo><date>05 Mar 2017</date></refentryinfo>
+<refmeta>
+<refentrytitle>gpxlogger</refentrytitle>
+<manvolnum>1</manvolnum>
+<refmiscinfo class="source">The GPSD Project</refmiscinfo>
+<refmiscinfo class="manual">GPSD Documentation</refmiscinfo>
+</refmeta>
+<refnamediv id='name'>
+<refname>gpxlogger</refname>
+<refpurpose>Tool to connect to gpsd and generate a GPX file</refpurpose>
+</refnamediv>
+<refsynopsisdiv id='synopsis'>
+
+<cmdsynopsis>
+ <command>gpxlogger</command>
+ <arg choice='opt'>-D <replaceable>debug-level</replaceable></arg>
+ <arg choice='opt'>-d </arg>
+ <arg choice='opt'>-e <replaceable>export-method</replaceable></arg>
+ <arg choice='opt'>-f <replaceable>filename</replaceable></arg>
+ <arg choice='opt'>-l </arg>
+ <arg choice='opt'>-m <replaceable>minmove</replaceable></arg>
+ <arg choice='opt'>-h </arg>
+ <arg choice='opt'>-V </arg>
+ <arg choice='opt'>-i <replaceable>track timeout</replaceable></arg>
+ <group>
+ <replaceable>server</replaceable>
+ <group>
+ <replaceable>:port</replaceable>
+ <group><replaceable>:device</replaceable></group>
+ </group>
+ </group>
+</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1 id='description'><title>DESCRIPTION</title>
+<para>This program collects fixes from <application>gpsd</application>
+and logs them to standard output in GPX, an XML profile for track
+logging.</para>
+
+<para>The output may be composed of multiple tracks. A new track is
+created if there's no fix written for an interval specified by the
+<option>-i</option> and defaulting to 5 seconds.</para>
+
+<para><application>gpxlogger</application> can use any of the
+export methods that <application>gpsd</application> supports.
+For a list of these methods, use the <option>-l</option>.
+To force the method, give the <option>-e</option> one of
+the colon-terminated method names from the <option>-l</option>
+table.</para>
+</refsect1>
+
+<refsect1 id='options'><title>OPTIONS</title>
+
+<para>The <option>-h</option> option causes <application>gpxlogger</application>
+to emit a summary of its options and then exit.</para>
+
+<para>The <option>-V</option> option causes <application>gpxlogger</application>
+to dump the package version and exit.</para>
+
+<para> The <option>-D</option> option sets a debug level;
+it is primarily for use by GPSD developers.
+It enables various progress messages to standard error.</para>
+
+<para>The <option>-d</option> option tells
+<application>gpxlogger</application> to run as a daemon in background.
+It requires the <option>-f</option> option, which directs output to a
+specified logfile.</para>
+
+<para>The <option>-m</option> option sets a minimum move distance in
+meters (it may include a fractional decimal part). Motions shorter
+than this will not be logged.</para>
+
+<para>The <option>-r</option> option tells
+<application>gpxlogger</application> to retry when GPSd loses the fix.
+Without <option>-r</option>, <application>gpxlogger</application>
+would quit in this case.</para>
+
+<para>If D-Bus support is available on the host, GPSD is configured to
+use it, and <command>-e dbus</command> is specified, this program
+listens to DBUS broadcasts from
+<application>gpsd</application> via org.gpsd.fix.</para>
+
+<para>With <command>-e sockets</command>, or if sockets is the method
+defaulted to, you may give a server-port-device specification as
+arguments.</para>
+
+<para>The sockets default is to all devices on the localhost,
+using the default GPSD port 2947. An optional argument to any
+client may specify a server to get data from. A colon-separated suffix
+is taken as a port number. If there is a second colon-separated
+suffix, that is taken as a specific device name to be
+watched. However, if the server specification contains square
+brackets, the part inside them is taken as an IPv6 address and
+port/device suffixes are only parsed after the trailing bracket.
+Possible cases look like this:</para>
+
+<variablelist>
+<varlistentry>
+<term>localhost:/dev/ttyS1</term>
+<listitem><para>Look at the default port of localhost, trying both
+IPv4 and IPv6 and watching output from serial device 1.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>example.com:2317</term>
+<listitem><para>Look at port 2317 on example.com, trying both
+IPv4 and IPv6.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>71.162.241.5:2317:/dev/ttyS3</term>
+<listitem><para>Look at port 2317 at the specified IPv4
+address, collecting data from attached serial device 3.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term>[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210]:2317:/dev/ttyS5</term>
+<listitem><para>Look at port 2317 at the specified IPv6
+address, collecting data from attached serial device 5.</para></listitem>
+</varlistentry>
+</variablelist>
+
+</refsect1>
+
+<refsect1 id='see_also'><title>SEE ALSO</title>
+<para>
+<citerefentry><refentrytitle>gpsd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>gps</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+<citerefentry><refentrytitle>gpspipe</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+</para>
+</refsect1>
+
+<refsect1 id='maintainer'><title>AUTHORS</title>
+
+<para>
+ Amaury Jacquot <email>sxpert@sxpert.org</email> &amp;
+ Petter Reinholdtsen <email>pere@hungry.com</email> &amp;
+ Chris Kuethe <email>chris.kuethe@gmail.com</email>
+</para>
+
+</refsect1>
+
+</refentry>