1GPXLOGGER(1)                  GPSD Documentation                  GPXLOGGER(1)
2
3
4

NAME

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

SYNOPSIS

9       gpxlogger [OPTIONS] [server[:port[:device]]]
10
11       gpxlogger -h
12
13       gpxlogger -V
14

DESCRIPTION

16       gpslogger program collects fixes from gpsd and logs them to standard
17       output in GPX format, an XML profile for track logging. It does not
18       need to run as root, but can run as root.
19
20       The output may be composed of multiple tracks. A new track is created
21       if there’s no fix written for an interval specified by the -i or
22       --interval option and defaulting to 5 seconds.
23
24       gpxlogger can use any of the export methods that gpsd supports. For a
25       list of these methods, use the -l or --exports option. To force a
26       method, give the -e, --export option folloed by one of the
27       colon-terminated method names from the -l, --exports table.
28

OPTIONS

30       -?, -h, --help
31           Print a summary of options and then exit.
32
33       -d, --daemonize
34           Run as a daemon in background. It requires the -f, --output option,
35           which directs output to a specified logfile.
36
37       -D LVL, --debug LVL
38           Sets the debug level, it is primarily for troubleshooting. It
39           enables various progress messages to standard error.
40
41       -e METHOD, --export METHOD
42           If D-Bus support is available on the host, GPSD is configured to
43           use it, and -e dbus, or --export dbus is specified, this program
44           listens to DBUS broadcasts from gpsd via org.gpsd.fix.
45
46           With -e sockets, or if sockets is the method defaulted to, you may
47           give a [server[:port[:device]]] specification as arguments. See the
48           ARGUMENTS section below for more details.
49
50           With -e shm, --export shm this program will listen to the local
51           gpsd using shared memory.
52
53       -F INFILE, --filein INFILE
54           Read gpsd JSON from file INFILE, instead of from a gpsd daemon.
55
56       -g, --garmin
57           Enable Garmin extensions to GPX format. This allows depth to also
58           be logged in the gpx output. Not compatible with Google maps.
59
60       -i SECONDS, --interval SECONDS
61           A new track is created if there’s no fix written for an interval of
62           SECONDS. Defaulting to 5 seconds.
63
64       -l, --exports
65           List all possible options for -e, --export.
66
67       -m MINMOVE, --minmove MINMOVE
68           Sets a minimum move distance in meters (it may include a fractional
69           decimal part). Motions shorter than this will not be logged.
70
71       -o OUTFILE, --output OUTFILE
72           Output the GPX logg to file file OUTFILE, instead of to stdout..
73
74       -r, --reconnect
75           Retry when GPSd loses the fix. Without -r, gpxlogger would quit in
76           this case.
77
78       -V, --version
79           Dump the package version and exit.
80

ARGUMENTS

82       By default, clients collect data from the local gpsd daemon running on
83       localhost, using the default GPSD port 2947. The optional argument to
84       any client may override this behavior: [server[:port[:device]]]
85
86       For further explanation, and examples, see the ARGUMENTS section in the
87       gps(1) man page
88

RETURN VALUES

90       0
91           on success.
92
93       1
94           on failure
95

SEE ALSO

97       gps(1)
98
99       gpsd(8)
100

RESOURCES

102       Project web site: https://gpsd.io/
103

COPYING

105       This file is Copyright 2013 by the GPSD project
106       SPDX-License-Identifier: BSD-2-clause
107

AUTHORS

109       Amaury Jacquot
110
111       Petter Reinholdtsen
112
113       Chris Kuethe
114
115
116
117GPSD, Version 3.25                2023-01-10                      GPXLOGGER(1)