diff options
author | Robert Norris <rw_norris@hotmail.com> | 2017-03-08 00:24:14 +0000 |
---|---|---|
committer | Fred Wright <fw@fwright.net> | 2017-03-17 15:44:59 -0700 |
commit | 8c2cefb7a0400f3ddb215a9605f5cd26fea56537 (patch) | |
tree | 7bb652adecfad8bcf19aeebdb62d01fd68d19d0f /gpxlogger.xml | |
parent | 02d31b09c4e85942c23ef8de52bbaa1240286d9c (diff) | |
download | gpsd-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.xml | 149 |
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> & + Petter Reinholdtsen <email>pere@hungry.com</email> & + Chris Kuethe <email>chris.kuethe@gmail.com</email> +</para> + +</refsect1> + +</refentry> |