Name | Date | Size | #Lines | LOC | ||
---|---|---|---|---|---|---|
.. | 03-May-2022 | - | ||||
docs/ | H | 07-Jan-2018 | - | 1,567 | 992 | |
scripts/ | H | 07-Jan-2018 | - | 1,040 | 790 | |
snmpclitools/ | H | 07-Jan-2018 | - | 2,175 | 1,587 | |
snmpclitools.egg-info/ | H | 03-May-2022 | - | 35 | 34 | |
MANIFEST.in | H A D | 07-Jan-2018 | 158 | 6 | 5 | |
PKG-INFO | H A D | 07-Jan-2018 | 1.5 KiB | 35 | 34 | |
README.md | H A D | 07-Jan-2018 | 3.3 KiB | 86 | 61 | |
runtests.sh | H A D | 07-Jan-2018 | 1.5 KiB | 40 | 35 | |
setup.cfg | H A D | 07-Jan-2018 | 88 | 9 | 6 | |
setup.py | H A D | 07-Jan-2018 | 3.4 KiB | 126 | 97 |
README.md
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