README.md
1NAME
2 gpxloggerd – GPX logging daemon
3
4SYNOPSIS
5 gpxloggerd [-dhVv] [-D level] [-f template] [-u user [:group]]
6 [-p pidfile] [-m meters] [-M meters] [-a degrees]
7 [-I interval] [-i timeout] [server [:port [:device]]]
8
9DESCRIPTION
10 The gpxloggerd is a tiny daemon that connects to GPSD(8) and logs
11 received fix information in the GPX format. By default the gpxloggerd
12 connects to GPSD(8) at the localhost:2947 and logs to stdout GPX data for
13 all GPS devices served be the daemon.
14
15 The options are as follows:
16
17 -h Print usage and exit.
18
19 -V Print version number and exit.
20
21 -v Be as verbose as possible when writing GPX log. For now this
22 means logging of ⟨fix⟩, ⟨sat⟩, ⟨hdop⟩, ⟨vdop⟩ and ⟨pdop⟩ fields,
23 which bloats size of produced GPX significantly. By default this
24 option is turned off, and only coordinates, time and elevation
25 are logged.
26
27 -d Detach from terminal and become a daemon.
28
29 -D level
30 Set the underlying libgps(3) library to the given debug level.
31
32 -f template
33 Write data to the given file instead of stdout. The template
34 isn't a bare filename, but can be a format for the strftime(3).
35
36 -u user [:group]
37 Lower the daemon priveleges to the specified user and group.
38
39 -p pidfile
40 Write the daemon pid to the specified file.
41
42 -m meters
43 Suppress logging of track segment in case if it lays within the
44 specified distance away from the previous logged track segment.
45 This option is useful to avoid polluted GPX traces at parking
46 lots and other places, where vehicle stands still for long time.
47 The option is turned off by default.
48
49 -a degrees
50 Suppress logging of track segment unless the course (azimuth,
51 bearing) of the vehicle has changed to a value equal or greater
52 than the specified angle in degrees. This option is useful to
53 make traces on straight roads more sparse. The option is turned
54 off by default.
55
56 -M meters
57 Set maximum track segment length. This option is meaningful only
58 in conjunction with the -a option. The default value is 200
59 meters.
60
61 -i timeout
62 Start new track if the time jump between current fix and previous
63 logged one is above the timeout. By default timeout value is 300
64 seconds.
65
66 -I interval
67 Specify logging interval between trackpoints in seconds. The
68 default one is one second.
69
70 When the gpxloggerd daemon receives SIGHUP it finalizes GPX in the
71 current output file, closes it and then starts a new one using the
72 configured template as a file name.
73