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       gpsdctl action device
10

OPTIONS

12       action
13           may be add or remove. If no daemon instance is running when an add
14           is requested, this program will launch one.
15
16       device
17           argument should be the pathname of a device. The device will be
18           opened by gpsd to read sensor data.
19

DESCRIPTION

21       This is a tool for sending an instance of gpsd commands over its
22       control socket to add or remove devices from the daemon’s device list.
23       It is not intended to be called by users, but rather by the Linux
24       hotplug system and similar facilities.
25

ENVIRONMENT

27       Two environment variables are interpreted.
28
29       GPSD_SOCKET
30           sets the location of the control socket. If the effective user ID
31           of this program is root then it usually defaults to /run/gpsd.sock,
32           although some systems may use the deprecated /var/run/gpsd.sock
33           instead. Non-root users will use /tmp/gpsd.sock.
34
35       GPSD_OPTIONS
36           may be a list of options to be passed to gpsd when this tool
37           launches it. It defaults to an empty string.
38

RETURN VALUES

40       0
41           on success.
42
43       1
44           if the action was unknown or the write to the control socket
45           failed,
46

SEE ALSO

48       gpsd(8), gpsctl(1), gps(1), libgps(3), libgpsmm(3), gpsprof(1),
49       gpsfake(1).
50

RESOURCES

52       Project web site: https://gpsd.io/
53

COPYING

55       This file is Copyright 2013 by the GPSD project
56       SPDX-License-Identifier: BSD-2-clause
57

AUTHOR

59       Eric S. Raymond
60
61
62
63GPSD, Version 3.24                2021-09-20                        GPSDCTL(8)