1 2Command-line SNMP tools 3----------------------- 4 5[![PyPI](https://img.shields.io/pypi/v/snmpclitools.svg?maxAge=2592000)](https://pypi.python.org/pypi/snmpclitools) 6[![Python Versions](https://img.shields.io/pypi/pyversions/snmpclitools.svg)](https://pypi.python.org/pypi/snmpclitools/) 7[![Build status](https://travis-ci.org/etingof/snmpclitools.svg?branch=master)](https://secure.travis-ci.org/etingof/snmpclitools) 8[![GitHub license](https://img.shields.io/badge/license-BSD-blue.svg)](https://raw.githubusercontent.com/etingof/snmpclitools/master/LICENSE.txt) 9 10This is a collection of command-line SNMP tools written in pure-Python. 11The tools mimic their famous [Net-SNMP](http://sourceforge.net/projects/net-snmp/) 12counterparts. 13 14In the past this project was known as *pysnmp-apps*. 15 16Features 17-------- 18 19* Complete SNMPv1/v2c and SNMPv3 support 20* Interface compatible (almost) with Net-SNMP's snmp\* tools. 21* SNMPv3 USM supports MD5/SHA/SHA224/SHA256/SHA384/SHA512 auth and 22 DES/3DES/AES128/AES192/AES256 privacy crypto algorithms 23* Automatically downloads required MIBs from the Internet 24* Runs over IPv4 and/or IPv6 transports 25* Cross-platform: works on Linux, Windows and OS X. 26* 100% Python, works with Python 2.4 up to Python 3.6 27 28Download 29-------- 30 31The snmpclitools package is distributed under terms and conditions of 2-clause 32BSD [license](http://snmplabs.com/snmpclitools/license.html). Source code is freely 33available as a Github [repo](https://github.com/etingof/snmpclitools). 34 35Installation 36------------ 37 38Download snmpclitools from [PyPI](https://pypi.python.org/pypi/snmpclitools) or just run: 39 40```bash 41$ pip install snmpclitools 42``` 43 44How to use the tools 45-------------------- 46 47The most of pysnmp command-line tools could be run in a similar way as 48their Net-SNMP counterparts. For example: 49 50```bash 51$ snmpbulkwalk.py -v3 -u usr-md5-des -l authPriv -A authkey1 -X privkey1 demo.snmplabs.com system 52SNMPv2-MIB::sysDescr.0 = DisplayString: Linux grommit 3.5.11.1 #2 PREEMPT Tue Mar 1 14:03:24 MSD 2016 i686 unknown unknown GNU/Linux 53SNMPv2-MIB::sysObjectID.0 = ObjectIdentifier: iso.org.dod.internet.private.enterprises.8072.3.2.101.3.6.1.4.1.8072.3.2.10 54SNMPv2-MIB::sysUpTime.0 = TimeTicks: 43 days 1:55:47.85372214785 55[ skipped ] 56SNMPv2-MIB::sysORUpTime."8" = TimeStamp: 0 days 0:0:0.77 57SNMPv2-MIB::sysORUpTime."9" = TimeStamp: 0 days 0:0:0.77 58 59$ snmpget.py -v3 -u usr-sha-aes -l authPriv -A authkey1 -X privkey1 demo.snmplabs.com IP-MIB::ipAdEntBcastAddr.\"127.0.0.1\" 60IP-MIB::ipAdEntBcastAddr."127.0.0.1" = Integer32: 1 61 62$ snmpset.py -v2c -c public demo.snmplabs.com SNMPv2-MIB::sysDescr.0 = my-new-descr 63notWritable(17) 64``` 65 66For more information, please, run any of these tools with --help option. 67 68You can play with different security protocols against the publicly available SNMP 69agent like [this one @snmplabs.com](http://snmplabs.com/snmpsim/public-snmp-agent-simulator.html). 70 71Getting help 72------------ 73 74If something does not work as expected, please open up a 75[GitHub issue](https://github.com/etingof/snmpclitools/issues/new) or post 76your question [to Stack Overflow](http://stackoverflow.com/questions/ask). 77 78Feedback and collaboration 79-------------------------- 80 81I'm interested in bug reports, fixes, suggestions and improvements. Your 82pull requests are very welcome! 83 84Copyright (c) 2005-2018, [Ilya Etingof](mailto:etingof@gmail.com). All rights reserved. 85 86