NAME

       gpxlogger - Tool to connect to gpsd and generate a GPX file

SYNOPSIS

       gpxlogger [-?] [--daemonize] [--debug debug-level] [--export export-method] [--exports]
                 [--help] [--intervaltrack timeout] [--minmove minmove] [--output filename]
                 [--version] [-d] [-D debug-level] [-e export-method] [-f filename] [-h]
                 [-i track timeout] [-l] [-m minmove] [-V] [server [:port [:device]]]

DESCRIPTION

       This program collects fixes from gpsd and logs them to standard output in GPX, an XML
       profile for track logging.

       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 -i, --interval and defaulting to 5 seconds.

       gpxlogger can use any of the export methods that gpsd supports. For a list of these
       methods, use the -l, --exports. To force the method, give the -e, --export one of the
       colon-terminated method names from the -l, --exports table.

OPTIONS

       -?, -h, --help
           Print a summary of options and then exit.

       -d, --daemonize
           Run as a daemon in background. It requires the -f, --output option, which directs
           output to a specified logfile.

       -D LVL, --debug LVL
           Sets the debug level; it is primarily for troubleshooting. It enables various progress
           messages to standard error.

       -e METHOD, --export METHOD
           If D-Bus support is available on the host, GPSD is configured to use it, and -e dbus,
           --export dbus is specified, this program listens to DBUS broadcasts from gpsd via
           org.gpsd.fix.

           With -e sockets, or if sockets is the method defaulted to, you may give a
           server-port-device specification as arguments.

           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:

           localhost:/dev/ttyS1
               Look at the default port of localhost, trying both IPv4 and IPv6 and watching
               output from serial device 1.

           example.com:2317
               Look at port 2317 on example.com, trying both IPv4 and IPv6.

           71.162.241.5:2317:/dev/ttyS3
               Look at port 2317 at the specified IPv4 address, collecting data from attached
               serial device 3.

           [FEDC:BA98:7654:3210:FEDC:BA98:7654:3210]:2317:/dev/ttyS5
               Look at port 2317 at the specified IPv6 address, collecting data from attached
               serial device 5.

           With -e shm, --export shm this program will listen to the local gpsd using shared
           memory.

       -i SECONDS, --interval SECONDS
           A new track is created if there's no fix written for an interval of SECONDS.
           Defaulting to 5 seconds.

       -l, --exports
           List all possible options for -e, --export.

       -m MINMOVE, --minmove MINMOVE
           Sets a minimum move distance in meters (it may include a fractional decimal part).
           Motions shorter than this will not be logged.

       -r, --reconnect
           Retry when GPSd loses the fix. Without -r, gpxlogger would quit in this case.

       -V, --version
           Dump the package version and exit.

SEE ALSO

       gpsd(8), gps(1) gpspipe(1)

AUTHORS

       Amaury Jacquot <sxpert@sxpert.org> & Petter Reinholdtsen <pere@hungry.com> & Chris Kuethe
       <chris.kuethe@gmail.com>