trishul-snmp

CLI Reference

The CLI is a thin wrapper over the Python API. It is useful for smoke testing, offline translation, notification debugging, and simple operator workflows, but it is not the primary product surface.

Common manager options

All live commands (get, getnext, getbulk, walk, bulkwalk) share these options:

Option	Default	Description
`--host`	required	Target agent hostname or IP address
`--port`	`161`	Target UDP port
`--community`	`public`	SNMPv2c community string
`--timeout`	`2.0`	Request timeout in seconds
`--retries`	`1`	Retry count per request
`--bundle`	—	Compiled module JSON file or bundle directory
`--numeric`	off	Render numeric OIDs in text output even when a bundle is loaded
`--json`	off	Emit machine-readable JSON output

Exit codes: 0 success, 1 runtime/translation/protocol failure or non-zero SNMP error status, 2 invalid CLI usage from argparse.

Common notification send options

The outbound notification commands (trap, inform) share these options:

Option	Default	Description
`--host`	required	Target notification receiver hostname or IP address
`--port`	`162`	Target UDP port
`--community`	`public`	SNMPv2c community string
`--timeout`	`2.0`	Request timeout in seconds
`--retries`	`1`	Retry count per request
`--bundle`	—	Compiled module JSON file or bundle directory
`--uptime`	`0`	`sysUpTime.0` value in centiseconds
`--varbind`	repeatable	Notification payload varbind in `OID=TYPE:VALUE` form
`--json`	off	Emit machine-readable JSON output

Supported TYPE values for --varbind:

int
string
hex
oid
ip
counter32
gauge32
timeticks
opaque
counter64
null

oid values may be numeric or symbolic. Symbolic OIDs require --bundle.

`tsnmp translate`

tsnmp translate --bundle PATH TARGET

Offline translation only.

Argument	Description
`TARGET`	Numeric OID or `MODULE::symbol[.suffix]` target

Option	Description
`--bundle`	Compiled module JSON file or bundle directory

Examples:

tsnmp translate --bundle ./IF-MIB.json IF-MIB::ifDescr.1
tsnmp translate --bundle ./mibs-json 1.3.6.1.2.1.2.2.1.2.1

`tsnmp get`

tsnmp get [OPTIONS] TARGET [TARGET ...]

Examples:

tsnmp get --host 10.0.0.10 1.3.6.1.2.1.1.3.0
tsnmp get --host 10.0.0.10 --bundle ./IF-MIB.json IF-MIB::ifDescr.1
tsnmp get --host 10.0.0.10 --json 1.3.6.1.2.1.1.3.0

`tsnmp getnext`

tsnmp getnext [OPTIONS] TARGET [TARGET ...]

Examples:

tsnmp getnext --host 10.0.0.10 1.3.6.1.2.1.2.2
tsnmp getnext --host 10.0.0.10 --bundle ./IF-MIB.json IF-MIB::ifTable

`tsnmp getbulk`

tsnmp getbulk [OPTIONS] TARGET [TARGET ...]

Additional options:

Option	Default	Description
`--non-repeaters`	`0`	Number of non-repeaters
`--max-repetitions`	`10`	Maximum repetitions per repeating target

Examples:

tsnmp getbulk --host 10.0.0.10 --non-repeaters 0 --max-repetitions 10 1.3.6.1.2.1.2.2
tsnmp getbulk --host 10.0.0.10 --bundle ./mibs-json IF-MIB::ifTable

`tsnmp walk`

tsnmp walk [OPTIONS] ROOT

Uses GETBULK by default.

Additional options:

Option	Default	Description
`--max-repetitions`	`10`	Maximum repetitions per bulk step
`--no-bulk`	off	Use GETNEXT rather than GETBULK

Examples:

tsnmp walk --host 10.0.0.10 --bundle ./mibs-json IF-MIB::ifTable
tsnmp walk --host 10.0.0.10 --no-bulk 1.3.6.1.2.1.2.2

`tsnmp bulkwalk`

tsnmp bulkwalk [OPTIONS] ROOT

Additional options:

Option	Default	Description
`--max-repetitions`	`10`	Maximum repetitions per bulk request

Examples:

tsnmp bulkwalk --host 10.0.0.10 --bundle ./mibs-json IF-MIB::ifTable

`tsnmp trap`

tsnmp trap [OPTIONS] NOTIFICATION

Sends an SNMPv2c trap and prints the assigned request id.

Examples:

tsnmp trap --host 10.0.0.20 1.3.6.1.6.3.1.1.5.3
tsnmp trap --host 10.0.0.20 --bundle ./mibs-json IF-MIB::linkDown \
  --uptime 123 \
  --varbind IF-MIB::ifIndex.7=int:7

`tsnmp inform`

tsnmp inform [OPTIONS] NOTIFICATION

Sends an SNMPv2c inform and prints the response varbinds.

Additional option:

Option	Default	Description
`--numeric`	off	Render numeric OIDs in text output even when a bundle is loaded

Examples:

tsnmp inform --host 10.0.0.20 1.3.6.1.6.3.1.1.5.3
tsnmp inform --host 10.0.0.20 --bundle ./mibs-json IF-MIB::linkDown \
  --varbind IF-MIB::ifIndex.7=int:7

`tsnmp listen`

tsnmp listen [OPTIONS]

Listens for inbound SNMPv2c traps and informs.

Options:

Option	Default	Description
`--host`	`0.0.0.0`	Listener bind hostname or IP address
`--port`	`162`	Listener UDP port
`--community`	repeatable	Optional allowlist entry; repeat to allow multiple values
`--bundle`	—	Compiled module JSON file or bundle directory
`--count`	`0`	Number of notifications to receive before exit; `0` means run until interrupted
`--numeric`	off	Render numeric OIDs in text output even when a bundle is loaded
`--json`	off	Emit one JSON object per received notification

Examples:

tsnmp listen --host 127.0.0.1 --port 9162 --count 1
tsnmp listen --bundle ./mibs-json --community public --community traps --json

`tsnmp decode-notification`

tsnmp decode-notification [OPTIONS]

Offline decode for BER-encoded SNMPv2c traps and informs.

Options:

Option	Default	Description
`--hex`	mutually exclusive	Hex-encoded SNMP message bytes
`--file`	mutually exclusive	Path to raw BER-encoded SNMP message bytes
`--bundle`	—	Compiled module JSON file or bundle directory
`--numeric`	off	Render numeric OIDs in text output even when a bundle is loaded
`--json`	off	Emit machine-readable JSON output

Examples:

tsnmp decode-notification --hex 302602010104067075626c6963...
tsnmp decode-notification --file ./trap.ber --bundle ./mibs-json

`tsnmp version`

tsnmp version

Print the installed package version and exit.

Output modes

Default output is line-oriented text:

IF-MIB::ifDescr.1 = eth0

Machine-readable mode:

tsnmp get --host 10.0.0.10 --json 1.3.6.1.2.1.1.3.0

Numeric rendering even when a bundle is loaded:

tsnmp get --host 10.0.0.10 --bundle ./mibs-json --numeric IF-MIB::ifDescr.1

Listener JSON mode emits one JSON object per line so it can stream indefinitely.

Scope limits

Deliberately still not included:

set
compile workflows
raw MIB file or directory ingestion

If you need rich runtime usage, prefer the Python API.

This site is open source. Improve this page.