gnss-share(1)

📦
version 0.8.2 · 6 versions
, in ubuntu resolute, ubuntu stonking

💖 gnss-share(1) — General Commands Manual 💖

okay bestie, sit down, hydrate, and let me tell you about gnss-share, a whole icon of a command. 🌸

✨ NAME ✨

gnss-share — yes that's the whole name, she needs no subtitle, she's that girl 🎀

🌈 DESCRIPTION 🌈

gnss-share is the app that facilitates sharing GNSS location data with multiple clients at once, while also giving you a way to do device-specific setup beforehand. Not every device is the same, you know? So sometimes you gotta prep first. 💅

And for some devices — not all, just some — she can also manage loading and storing A-GPS data. Fancy. 🔥

🦋 CONCEPTS 🦋

So here's the lore, bestie. gnss-share was originally created to do two things:

  • allow multiplexing GNSS data from a single device out to multiple clients 🙌
  • make it easy to load/store A-GPS data to and from the device 💾

Basically? gnss-share effectively acts as a proxy between your GNSS device and the clients. Proxy era. 👑

And because she's the middlewoman, she gets to control when and what location data the clients receive. That's a lot of power, ngl. She can also use that moment to set time, rough location, and stuff like that on the device — all to improve lock speed. Faster lock, faster life. ⚡

Also!! Some external signals can be used to control gnss-share too. Head down to SIGNALS if you want the tea on that. 🍓

💜 COMMANDS 💜

  • [none] — no command at all? no problem. The default behavior when you don't specify a command is to run in server mode. She just does that. ✨
  • store — store the almanac and ephemerides data, then quit. Mission accomplished, she's out. 💫
  • load — load the almanac and ephemerides data, then quit. Same energy, opposite direction. 🔄

🎀 OPTIONS 🎀

  • -c <path> — the path to the configuration file she should use. Default: /etc/gnss-share.conf
  • -d — turn on printing debug output. For when you wanna see everything the girl is doing. 🔍
  • -h — print help and exit. The classic. 🙈

🫶 SIGNALS 🫶

On top of the command line options, this application will respond to these signals when she's in "server" mode:

  • SIGUSR1 — the application will load AGPS data from the directory agps_directory that you specified in the configuration file, and then keep running afterward. No quitting, she's just loading and vibing. ✨
  • SIGUSR2 — the application will store AGPS data to the directory agps_directory that you specified in the configuration file, and then keep running afterward. Saving the data, staying the main character. 💾
heads up bestie: these two only hit when she's in server mode, so don't come for her when she's off doing store or load chores. 💀

🌸 SEE ALSO 🌸

👑 AUTHORS 👑

  • Clayton Craft <clayton@craftyguy.net> 💖

and that's the whole page, bestie, you absolutely ate that read. 💅 this fine piece of documentation is from gnss-share and it's dated 2026-01-20 — periodt. 🎀✨

📦 where this page comes from