Command-line SNMP tools
This is a collection of command-line SNMP tools written in pure-Python.
The tools mimic their famous Net-SNMP
counterparts.
In the past this project was known as pysnmp-apps.
Features
- Complete SNMPv1/v2c and SNMPv3 support
- Interface compatible (almost) with Net-SNMP's snmp* tools.
- SNMPv3 USM supports MD5/SHA/SHA-224/SHA-256/SHA-384/SHA-512 auth and
DES/3-DES/AES-128/AES-192/AES-256 privacy crypto algorithms
- Automatically downloads required MIBs from the Internet
- Runs over IPv4 and/or IPv6 transports
- Cross-platform: works on Linux, Windows and macOS.
- 100% Python, works with Python 3.8+
Download
The snmpclitools package is distributed under terms and conditions of 2-clause
BSD license. Source code is freely
available as a Github repo.
Installation
Download snmpclitools from PyPI or just run:
$ pip install snmpclitools
How to use the tools
The most of pysnmp command-line tools could be run in a similar way as their Net-SNMP counterparts. For example:
$ snmpbulkwalk -v3 -u usr-md5-des -l authPriv -A authkey1 -X privkey1 demo.pysnmp.com system
SNMPv2-MIB::sysDescr.0 = DisplayString: Linux grommit 3.5.11.1
SNMPv2-MIB::sysObjectID.0 = ObjectIdentifier: iso.org.dod.internet.private.enterprises.8072.3.2.101.3.6.1.4.1.8072.3.2.10
SNMPv2-MIB::sysUpTime.0 = TimeTicks: 43 days 1:55:47.85372214785
[ skipped ]
SNMPv2-MIB::sysORUpTime."8" = TimeStamp: 0 days 0:0:0.77
SNMPv2-MIB::sysORUpTime."9" = TimeStamp: 0 days 0:0:0.77
$ snmpget -v3 -u usr-sha-aes -l authPriv -A authkey1 -X privkey1 demo.pysnmp.com IP-MIB::ipAdEntBcastAddr.\"127.0.0.1\"
IP-MIB::ipAdEntBcastAddr."127.0.0.1" = Integer32: 1
$ snmpset -v2c -c public demo.pysnmp.com SNMPv2-MIB::sysDescr.0 = my-new-descr
notWritable(17)
For more information, please, run any of these tools with --help
option.
You can play with different security protocols against the publicly available SNMP
agent like this one @www.pysnmp.com.
Getting help
If something does not work as expected, please open up a
GitHub issue or post
your question to Stack Overflow.
Feedback and collaboration
Your pull requests are very welcome!
Copyright (c) 2005-2019, Ilya Etingof.
Copyright (c) 2022-2024, LeXtudio Inc..
All rights reserved.