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.  GPSD_SOCKET sets the
25       location of the control socket. It defaults to /var/run/gpsd.sock if
26       the effective user ID of this program is root, /tmp/gpsd.sock
27       otherwise.
28
29       GPSD_OPTIONS may be a list of options to be passed to gpsd when this
30       tool launches it. It defaults to an empty string.
31

RETURN VALUES

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

SEE ALSO

37       gpsd(8), gpsctl(1), gps(1), libgps(3), libgpsmm(3), gpsprof(1),
38       gpsfake(1).
39

AUTHOR

41       Eric S. Raymond <esr@thyrsus.com>.
42
43
44
45The GPSD Project                  25 Jun 2011                       GPSDCTL(8)