GPSDEBUGINFO(1)

📦
version 3.27.5 · 8 versions
, in arch rolling, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

✨ gpsdebuginfo(1) — GPSD Documentation ✨

okay bestie, so like… you know how when something's wrong with gpsd and you're like "help?? 😭" and nobody can help you because they can't see your machine? yeah. this is the fix. it's gpsdebuginfo, a little diagnostic queen from the GPSD crew, and she's about to spill ALL the tea about your setup. 🫖

💖 NAME 💖

gpsdebuginfo — generate a gpsd debug dump of your host. that's it, that's the job. she collects the receipts. 🧾✨

🌸 SYNOPSIS 🌸

gpsdebuginfo

no args, no flags, no drama. just run her. 💅

🦋 DESCRIPTION 🦋

so gpsdebuginfo is a shell script that runs a whole little series of short tests to check the state of gpsd on your machine. that's literally her whole personality. 🔍

run it, and then when you go ask for support help, send the complete output, without change. don't trim it, don't prettify it, don't "fix" it — the whole thing, untouched, periodt. the people helping you need the full picture, not the aesthetic version. 📸

ngl, the script should not collect any Personally Identifiable Information (PII). but like… you may wish to study the output before sending it to verify that for yourself. trust but verify, babes. 👀

now here's the important part: gpsdebuginfo should be run as root. 👑

  • it may be run as a normal user — but you'll get a loss of functionality, so some of the good stuff just won't show up. 🙈
  • running under sudo may cause misleading results. so not the vibe. don't do that. 🚫

🎀 OPTIONS 🎀

None. zero. nada. she takes no options and needs no options, she's self-sufficient like that. 💅✨

🌈 ENVIRONMENT 🌈

this script depends on the following environment variables, so keep an eye on them:

  • PATH — used to find gpsd, gpspipe, and other installed gpsd parts. it's giving "where's the crew at" energy. 🔎
  • PYTHONPATH — used to find the gps Python module. 🐍

💜 RETURN VALUES 💜

  • 0 — on success. that's the only one, and honestly? iconic. slay. ✨

🔥 SEE ALSO 🔥

gpsd(8), cgps(1), gps(1), gpspipe(1) — go read the family, they're all icons. 📚

🌟 RESOURCES 🌟

Project web site: https://gpsd.io/ — the mothership, the main character HQ. 🏰

👑 COPYING 👑

This file is Copyright 2021 by the GPSD project

SPDX-License-Identifier: BSD-2-clause

(legal stuff but make it cute: it's open, it's licensed, it's fine. 🫶)

🍓 AUTHOR 🍓

Gary E. Miller — the legend, the architect, the one who wrote this. respect. 🫡

and that's the whole page bestie!! GPSD Version 3.27.5, dated 2025-11-04, and that's GPSDEBUGINFO(1) — go run it, send the output, get your fix. mwah 💖✨

📦 where this page comes from