NAME

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

SYNOPSIS

       gpsdctl action device

OPTIONS

       action
           may be add or remove. If no daemon instance is running when an add is requested, this
           program will launch one.

       device
           argument should be the pathname of a device. The device will be opened by gpsd to read
           sensor data.

DESCRIPTION

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

ENVIRONMENT

       Two environment variables are interpreted.

       GPSD_SOCKET
           sets the location of the control socket. If the effective user ID of this program is
           root then it usually defaults to /run/gpsd.sock, although some systems may use the
           deprecated /var/run/gpsd.sock instead. Non-root users will use /tmp/gpsd.sock.

       GPSD_OPTIONS
           may be a list of options to be passed to gpsd when this tool launches it. It defaults
           to an empty string.

RETURN VALUES

       0
           on success.

       1
           if the action was unknown or the write to the control socket failed,

SEE ALSO

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

RESOURCES

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

COPYING

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

AUTHOR

       Eric S. Raymond