1GPSDCTL(8)                    GPSD Documentation                    GPSDCTL(8)
2
3
4

NAME

6       gpsdctl - tool for sending commands to gpsd over its control socket
7

SYNOPSIS

9       gpdsctl action device
10

DESCRIPTION

12       This is a tool for sending an instance of gpsd commands over its
13       control socket to add or remove devices from the daemon's device list.
14       It is not intended to be called by users, but rather by the Linux
15       hotplug system and similar facilities.
16
17       The action argument may be "add" or "remove". If no daemon instance is
18       running when an add is requested, this program will launch one.
19
20       The "device" argument should be the pathname of a device. A device on
21       the list will be opened to read sensor data whenever a client requests
22       a watch.
23
24       Two environment variables are interpreted.
25
26       GPSD_SOCKET sets the location of the control socket. If the effective
27       user ID of this program is root then it usually defaults to
28       /run/gpsd.sock, although some systems may use the deprecated
29       /var/run/gpsd.sock instead. Non-root users will use /tmp/gpsd.sock.
30
31       GPSD_OPTIONS may be a list of options to be passed to gpsd when this
32       tool launches it. It defaults to an empty string.
33

RETURN VALUES

35       1 if the action was unknown or the write to the control socket failed,
36       0 otherwise
37

SEE ALSO

39       gpsd(8), gpsctl(1), gps(1), libgps(3), libgpsmm(3), gpsprof(1),
40       gpsfake(1).
41

AUTHOR

43       Eric S. Raymond <esr@thyrsus.com>.
44
45
46
47The GPSD Project                6 December 2020                     GPSDCTL(8)