Command-line SNMP tools
-----------------------
[![PyPI](https://img.shields.io/pypi/v/snmpclitools-lextudio.svg?maxAge=2592000)](https://pypi.org/project/snmpclitools-lextudio)
[![PyPI Downloads](https://img.shields.io/pypi/dd/snmpclitools-lextudio)](https://pypi.python.org/pypi/snmpclitools-lextudio/)
[![Python Versions](https://img.shields.io/pypi/pyversions/snmpclitools-lextudio.svg)](https://pypi.org/project/snmpclitools-lextudio/)
[![GitHub license](https://img.shields.io/badge/license-BSD-blue.svg)](https://raw.githubusercontent.com/lextudio/snmpclitools/master/LICENSE.rst)
This is a collection of command-line SNMP tools written in pure-Python.
The tools mimic their famous [Net-SNMP](https://sourceforge.net/projects/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/SHA224/SHA256/SHA384/SHA512 auth and
DES/3DES/AES128/AES192/AES256 privacy crypto algorithms
* Automatically downloads required MIBs from the Internet
* Runs over IPv4 and/or IPv6 transports
* Cross-platform: works on Linux, Windows and OS X.
* 100% Python, works with Python 3.7+
Download
--------
The snmpclitools package is distributed under terms and conditions of 2-clause
BSD [license](https://www.pysnmp.com/snmpclitools/license.html). Source code is freely
available as a Github [repo](https://github.com/lextudio/snmpclitools).
Installation
------------
Download snmpclitools from [PyPI](https://pypi.org/project/snmpclitools-lextudio) or just run:
```bash
$ pip install snmpclitools-lextudio
```
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:
```bash
$ 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 #2 PREEMPT Tue Mar 1 14:03:24 MSD 2016 i686 unknown unknown GNU/Linux
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](https://www.pysnmp.com/snmpsim/public-snmp-agent-simulator.html).
Getting help
------------
If something does not work as expected, please open up a
[GitHub issue](https://github.com/lextudio/pysnmp/issues/new) or post
your question [to Stack Overflow](https://stackoverflow.com/questions/ask).
Feedback and collaboration
--------------------------
Your pull requests are very welcome!
Copyright (c) 2005-2019, [Ilya Etingof](mailto:etingof@gmail.com).
Copyright (c) 2022-2024, [LeXtudio Inc.](mailto:support@lextudio.com).
All rights reserved.
Raw data
{
"_id": null,
"home_page": "https://github.com/lextudio/snmpclitools",
"name": "snmpclitools-lextudio",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Ilya Etingof",
"author_email": "etingof@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a1/10/06fa2ed69462e1af0f515860da81db27c0fe4bcc3623c44436730369c06c/snmpclitools_lextudio-0.7.0.tar.gz",
"platform": null,
"description": "\nCommand-line SNMP tools\n-----------------------\n\n[![PyPI](https://img.shields.io/pypi/v/snmpclitools-lextudio.svg?maxAge=2592000)](https://pypi.org/project/snmpclitools-lextudio)\n[![PyPI Downloads](https://img.shields.io/pypi/dd/snmpclitools-lextudio)](https://pypi.python.org/pypi/snmpclitools-lextudio/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/snmpclitools-lextudio.svg)](https://pypi.org/project/snmpclitools-lextudio/)\n[![GitHub license](https://img.shields.io/badge/license-BSD-blue.svg)](https://raw.githubusercontent.com/lextudio/snmpclitools/master/LICENSE.rst)\n\nThis is a collection of command-line SNMP tools written in pure-Python.\nThe tools mimic their famous [Net-SNMP](https://sourceforge.net/projects/net-snmp/)\ncounterparts.\n\nIn the past this project was known as *pysnmp-apps*.\n\nFeatures\n--------\n\n* Complete SNMPv1/v2c and SNMPv3 support\n* Interface compatible (almost) with Net-SNMP's snmp\\* tools.\n* SNMPv3 USM supports MD5/SHA/SHA224/SHA256/SHA384/SHA512 auth and\n DES/3DES/AES128/AES192/AES256 privacy crypto algorithms\n* Automatically downloads required MIBs from the Internet\n* Runs over IPv4 and/or IPv6 transports\n* Cross-platform: works on Linux, Windows and OS X.\n* 100% Python, works with Python 3.7+\n\nDownload\n--------\n\nThe snmpclitools package is distributed under terms and conditions of 2-clause\nBSD [license](https://www.pysnmp.com/snmpclitools/license.html). Source code is freely\navailable as a Github [repo](https://github.com/lextudio/snmpclitools).\n\nInstallation\n------------\n\nDownload snmpclitools from [PyPI](https://pypi.org/project/snmpclitools-lextudio) or just run:\n\n```bash\n$ pip install snmpclitools-lextudio\n```\n\nHow to use the tools\n--------------------\n\nThe most of pysnmp command-line tools could be run in a similar way as their Net-SNMP counterparts. For example:\n\n```bash\n$ snmpbulkwalk -v3 -u usr-md5-des -l authPriv -A authkey1 -X privkey1 demo.pysnmp.com system\nSNMPv2-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\nSNMPv2-MIB::sysObjectID.0 = ObjectIdentifier: iso.org.dod.internet.private.enterprises.8072.3.2.101.3.6.1.4.1.8072.3.2.10\nSNMPv2-MIB::sysUpTime.0 = TimeTicks: 43 days 1:55:47.85372214785\n[ skipped ]\nSNMPv2-MIB::sysORUpTime.\"8\" = TimeStamp: 0 days 0:0:0.77\nSNMPv2-MIB::sysORUpTime.\"9\" = TimeStamp: 0 days 0:0:0.77\n\n$ snmpget -v3 -u usr-sha-aes -l authPriv -A authkey1 -X privkey1 demo.pysnmp.com IP-MIB::ipAdEntBcastAddr.\\\"127.0.0.1\\\"\nIP-MIB::ipAdEntBcastAddr.\"127.0.0.1\" = Integer32: 1\n\n$ snmpset -v2c -c public demo.pysnmp.com SNMPv2-MIB::sysDescr.0 = my-new-descr\nnotWritable(17)\n```\n\nFor more information, please, run any of these tools with `--help` option.\n\nYou can play with different security protocols against the publicly available SNMP\nagent like [this one @www.pysnmp.com](https://www.pysnmp.com/snmpsim/public-snmp-agent-simulator.html).\n\nGetting help\n------------\n\nIf something does not work as expected, please open up a\n[GitHub issue](https://github.com/lextudio/pysnmp/issues/new) or post\nyour question [to Stack Overflow](https://stackoverflow.com/questions/ask).\n\nFeedback and collaboration\n--------------------------\n\nYour pull requests are very welcome!\n\nCopyright (c) 2005-2019, [Ilya Etingof](mailto:etingof@gmail.com).\nCopyright (c) 2022-2024, [LeXtudio Inc.](mailto:support@lextudio.com).\nAll rights reserved.\n",
"bugtrack_url": null,
"license": "BSD-2-Clause",
"summary": "A collection of command-line tools for SNMP management purposes built on top of PySNMP package.",
"version": "0.7.0",
"project_urls": {
"Homepage": "https://github.com/lextudio/snmpclitools",
"Repository": "https://github.com/lextudio/snmpclitools"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bfe3d88ec2a1155f833993fcf1aabe1a9640a2454b3c3a05a7220de41b65c6b1",
"md5": "cdc44af213a64585f97af33e318f2d7f",
"sha256": "33ced60d10d421dd636f5f5b8f4bb00ddce48645b2e9bb705a0e2b29898066b9"
},
"downloads": -1,
"filename": "snmpclitools_lextudio-0.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cdc44af213a64585f97af33e318f2d7f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7,<4.0",
"size": 36708,
"upload_time": "2024-03-04T04:31:23",
"upload_time_iso_8601": "2024-03-04T04:31:23.916945Z",
"url": "https://files.pythonhosted.org/packages/bf/e3/d88ec2a1155f833993fcf1aabe1a9640a2454b3c3a05a7220de41b65c6b1/snmpclitools_lextudio-0.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a11006fa2ed69462e1af0f515860da81db27c0fe4bcc3623c44436730369c06c",
"md5": "95b83ee7a244c365d1c5a3fc090168cd",
"sha256": "837c861da1543c73f62da1e361adca073130da9ee5b2274b06c39b39db714767"
},
"downloads": -1,
"filename": "snmpclitools_lextudio-0.7.0.tar.gz",
"has_sig": false,
"md5_digest": "95b83ee7a244c365d1c5a3fc090168cd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7,<4.0",
"size": 51264,
"upload_time": "2024-03-04T04:31:25",
"upload_time_iso_8601": "2024-03-04T04:31:25.638902Z",
"url": "https://files.pythonhosted.org/packages/a1/10/06fa2ed69462e1af0f515860da81db27c0fe4bcc3623c44436730369c06c/snmpclitools_lextudio-0.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-04 04:31:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lextudio",
"github_project": "snmpclitools",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "snmpclitools-lextudio"
}