.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "gnss-share" "1" "2023-06-01" "gnss-share"
.P
.SH NAME
.P
gnss-share
.P
.SH DESCRIPTION
.P
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.\&
.P
.SH CONCEPTS
.P
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 \fBSIGNALS\fR for more information.\&
.P
.SH COMMANDS
.P
\fB[none]\fR
.RS 4
The default behavior if no command is specified is to run in server mode.\&
.P
.RE
\fBstore\fR
.RS 4
Store almanac and ephemerides data and quit.\&
.P
.RE
\fBload\fR
.RS 4
Load almanac and ephemerides data and quit.\&
.P
.RE
.SH OPTIONS
.P
\fB-c\fR <path>
.RS 4
Path to the configuration file to use.\& Default: /etc/gnss-share.\&conf
.P
.RE
\fB-d\fR
.RS 4
Enable printing debug output.\&
.P
.RE
\fB-h\fR
.RS 4
Print help and exit.\&
.P
.RE
.SH SIGNALS
.P
In addition to the command line options, this application will respond to the
following signals when in "server" mode:
.P
\fBSIGUSR1\fR
.RS 4
The application will load AGPS data from the directory \fBagps_directory\fR
specified in the configuration file, and continue running afterward.\&
.P
.RE
\fBSIGUSR2\fR
.RS 4
The application will store AGPS data to the directory \fBagps_directory\fR
specified in the configuration file, and continue running afterward.\&
.P
.RE
.SH SEE ALSO
.RS 4
\fBgnss-share.\&conf\fR(5)
.P
.RE
.SH AUTHORS
.P
\fBClayton Craft\fR <clayton@craftyguy.\&net>