GPSSNMP(1) GPSD Documentation GPSSNMP(1)

# [NAME](#NAME)

gpssnmp - SNMP helper client for gpsd

# [SYNOPSIS](#SYNOPSIS)

**gpssnmp** \[OPTIONS] \[server\[:port\[:device]]]

**gpssnmp** -h

**gpssnmp** -g OID

**gpssnmp** -n OID

**gpssnmp** -p

**gpssnmp** -V

# [DESCRIPTION](#DESCRIPTION)

**gpssnmp** is a **gpsd** client that works as an SNMP helper for **MRTG**.

**gpssnmp** does not require root privileges. It will also run fine as root.

**gpssnmp** can act as an agent to **snmpd** in *pass* mode or in *pass\_persist* mode. So it can be used to extend **snmpd** with the **GPSD-MIB**. Given the nature of the **SNMP** protocol, do not expect good latency. Data from different epochs may be mixed up together.

**Note**

this program is new in version 3.24.1 and will be subject to  
change for a few revisions. Consider it a Work In Progress (WIP).

# [OPTIONS](#OPTIONS)

**-?**, **-h**, **--help**

Print a summary of options and then exit. Use with "-D 1" to see valid OID values. Use with "-D 2" to see valid OID values with scale values and descriptions.

**-g OID**

Get the specified OID.

**-n OID**

Get the next OID starting at OID.

**-p**, **--persist**

Enter *pass\_persist* mode. This allows better performance when used as an agent for the **snmpd** daemon. See the snmpd.conf man page for details.

**-V**, **--version**

Print the package version and exit.

# [EXAMPLES:](#EXAMPLES:)

To get the number of saltellits seen with the OID

```


   $ gpssnmp -g .1.3.6.1.4.1.59054.11.2.1.3.1


   .1.3.6.1.4.1.59054.11.2.1.3.1


   INTEGER


   15
```

To get the number of saltellits seen with the MIB name

```


   $ gpssnmp -g skynSat.1


   .1.3.6.1.4.1.59054.11.2.1.3.1


   INTEGER


   15
```

## [Connecting to snmpd](#Connecting_to_snmpd)

**gpssnmp** can work as a "pass-through script" with **snmpd**. To enable this functionality on an already working snmpd installation, add this to your **snmpd.conf** file, and then restart **snmpd**:

```
# be sure SNMPv2 community "public" can access all MIBs:
rocommunity public  localhost
# configure pass-through of GPSD-MIB to gpssnmp
pass .1.3.6.1.4.1.59054  /usr/local/bin/gpssnmp
```

You can then query the number of satlettites in use this way:

```
$ snmpget -c public -v 2c localhost skynSat.1
GPSD-MIB::skynSat.1 = INTEGER: 16
```

Dump the entire "sky" OID this way:

```
$ snmpwalk -c public -v 2c localhost GPSD-MIB::sky
GPSD-MIB::skynSat.1 = INTEGER: 17
GPSD-MIB::skyuSat.1 = INTEGER: 8
GPSD-MIB::skySNRavg.1 = INTEGER: 2000
```

Dump the entire GPSD-MIB this way:

```
$ snmpwalk -c public -v 2c localhost gpsd
GPSD-MIB::tpvLeapSeconds = INTEGER: 18
GPSD-MIB::tpvNumber = INTEGER: 1
GPSD-MIB::tpvIndex.1 = INTEGER: 1
[...]
```

**gpssnmp** supports the *pass\_persist* mode of snmpd. To have **snmpd** use **gpssnmp** in this mode put this in your *snmpd.conf* file:

```
pass_persist .1.3.6.1.4.1.59054  /usr/local/bin/gpssnmp --persist
```

# [RETURN VALUES](#RETURN_VALUES)

**0**

on success.

**1**

on failure

# [SEE ALSO](#SEE_ALSO)

[**cgps**(1)](/man/os/gpsd/cgps.1), [**gps**(1)](/man/os/gpsd/gps.1), [**gpspipe**(1)](/man/os/gpsd/gpspipe.1), [**snmpget**(1)](/man/os/gpsd/snmpget.1), [**snmpwalk**(1)](/man/os/gpsd/snmpwalk.1), [**xgps**(1)](/man/os/gpsd/xgps.1)

[**snmpd.conf**(5)](/man/os/gpsd/snmpd.conf.5)

[**gpsd**(8)](/man/os/gpsd/gpsd.8), [**snmpd**(8)](/man/os/gpsd/snmpd.8)

# [RESOURCES](#RESOURCES)

**Project web site:** <https://gpsd.io/>

# [COPYING](#COPYING)

SPDX-FileCopyrightText: The GPSD project  
SPDX-FileType: DOCUMENTATION  
SPDX-License-Identifier: BSD-2-clause

2026-10-09 GPSD Version 3.27.5

---

Document: gpssnmp(1) from gpsd 3.27.5-r5 (Chainguard OS)
Source: https://gitlab.com/gpsd/gpsd