General Commands Manual

NAME¶

gnss-share

DESCRIPTION¶

gnss-share is an app that facilitates sharing GNSS location data with multiple clients, while providing a way to perform device-specific setup beforehand. For some devices, it can also manage loading and storing A-GPS data.

CONCEPTS¶

gnss-share was originally created to allow multiplexing GNSS data from a single device to multiple clients, and to facilitate loading/storing A-GPS data to and from the device. gnss-share effectively acts as a proxy between the GNSS device and the clients, which allows controlling when and what location data clients receive, as well as giving an opportunity to set time, rough location, etc on the device to improve lock speed. Some external signals can be used to control gnss-share, see SIGNALS for more information.

COMMANDS¶

[none]

The default behavior if no command is specified is to run in server mode.

store

Store almanac and ephemerides data and quit.

load

Load almanac and ephemerides data and quit.

OPTIONS¶

-c <path>

Path to the configuration file to use. Default: /etc/gnss-share.conf

-d

Enable printing debug output.

-h

Print help and exit.

SIGNALS¶

In addition to the command line options, this application will respond to the following signals when in "server" mode:

SIGUSR1

The application will load AGPS data from the directory agps_directory specified in the configuration file, and continue running afterward.

SIGUSR2

The application will store AGPS data to the directory agps_directory specified in the configuration file, and continue running afterward.

AUTHORS¶

Clayton Craft <clayton@craftyguy.net>

2023-06-01