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

NAME

6       xgpsspeed - X speedometer for gpsd
7

SYNOPSIS

9       xgpsspeed [OPTIONS] [service[:port[:device]]]
10
11       xgpsspeed -h
12
13       xgpsspeed -V
14

DESCRIPTION

16       xgpsspeed is a speedometer that uses position information from gpsd.
17
18       The default display mode is a speed and track presentation modeled
19       after a marine navigation display; for backward compatibility the
20       --nautical option forces this mode. The --landspeed option produces a
21       simple speedometer.
22
23       The --speedunits option can be used to set the speed units for display;
24       follow the keyword with "knots" for nautical miles per hour, "kmh" for
25       kilometers per hour, or "mph" for miles per hour. The default is miles
26       per hour.
27
28       In the nautical mode only, --maxspeed sets the maximum on the
29       speedometer.
30
31       xgpsspeed will run fine as a normal user, and fine as root. Running
32       xgpsspeed under sudo will cause some loss of functionality.
33

OPTIONS

35       -?, -h, --help
36           Causes the client to emit a summary of its options and then exit.
37
38       -device DEVICE
39           The device on the host to connect to. The default is empty (any).
40
41       -D LVL, --debug LVL
42           Sets the debug level, it is primarily for use by GPSD developers.
43           It enables various progress messages to standard error.
44
45       --host HOST
46           The host (server) to connect to. The default is localhost.
47
48       -p PORT, --port PORT
49           The port to connect to. The default is 2947.
50
51       -V, --version
52           This option causes each client to dump the package version and
53           exit.
54

ARGUMENTS

56       By default, clients collect data from the local gpsd daemon running on
57       localhost, using the default GPSD port 2947. The optional argument to
58       any client may override this behavior: [server[:port[:device]]]
59
60       For further explanation, and examples, see the ARGUMENTS section in the
61       gps(1) man page
62

ENVIRONMENT

64       The environment variable GPSD_UNITS is checked if no unit system is
65       specified on the command line. It may be set to 'i'. 'imperial', 'm',
66       'metric', or 'n', 'nautical'.
67
68       LC_MEASUREMENT and then LANG are checked if no unit system has been
69       specified on the command line, or in GPSD_UNITS. If the value is 'C',
70       'POSIX', or begins with 'en_US' the unit system is set to imperial. The
71       default if no system has been selected defaults to metric.
72

RETURN VALUES

74       0
75           on success.
76
77       1
78           on failure
79

SEE ALSO

81       gpsd(8), gps(1), xgps(1)
82

RESOURCES

84       Project web site: https://gpsd.io/
85

COPYING

87       This file is Copyright 2013 by the GPSD project
88       SPDX-License-Identifier: BSD-2-clause
89

AUTHORS

91       Chen Wei
92
93       Robin Wittler
94
95
96
97GPSD, Version 3.25                2023-01-10                      XGPSSPEED(1)
Impressum