iurii-likh / python-netsnmpagent Goto Github PK
View Code? Open in Web Editor NEWThis project forked from pief/python-netsnmpagent
Allows to write net-snmp subagents in Python.
License: GNU Lesser General Public License v3.0
This project forked from pief/python-netsnmpagent
Allows to write net-snmp subagents in Python.
License: GNU Lesser General Public License v3.0
python-netsnmpagent Module Copyright (c) 2013-2019 Pieter Hollants <[email protected]> Licensed under the GNU Lesser Public License (LGPL) version 3 WHAT IS IT? python-netsnmpagent is a Python module that facilitates writing Net-SNMP subagents in Python. Subagents connect to a locally running Master agent (snmpd) over a Unix domain socket (eg. "/var/run/agentx/master") and using the AgentX protocol (RFC2741). They implement custom Management Information Base (MIB) modules that extend the local node's MIB tree. Usually, this requires writing a MIB as well, ie. a text file that specifies the structure, names and data types of the information within the MIB module. python-netsnmpagent was written after a lot of frustration trying to fix the python-agentx module hosted on Sourceforge. I fixed some smaller issues there but when it came to making sure that you could actually walk the whole MIB, not just the variables registered, I realized that it would not make much sense to reimplement the complete behavior of a proper SNMP agent when the NetSNMP API actually can handle those things for you. Also, to be honest, I don't get python-agentx's design :-) python-netsnmpagent, by contrast, in the first line focusses on making the net-snmp C agent API accessible from Python. Though I will try not to just pass through every library call 1:1 but wrap them in a useful manner. net-snmp itself also comes with a Python module (see the "python" subdirectory in the source distribution), however it seems to offer bindings that implement the client side only, not the agent side. REQUIREMENTS python-netsnmpagent requires the net-snmp libraries to be installed. The runtime libraries are enough, development files are not necessary. Tested versions include 5.4.2 (included with SUSE Linux Enterprise Server 11 SP2), 5.4.3 (included with Ubuntu 12.04 LTS) and net-snmp 5.7.3 (included with openSUSE 12.3). While the intent is to support both net-snmp 5.4.x and 5.7.x versions at least for the near future, I want to avoid double code paths whereever possible. I therefore have to stick to the net-snmp 5.4.x way of things at certain places indicated by code comments. python-netsnmpagent has been tested and is compatible with: - Python 2.6 - Python 2.7 - Python 3.5 (since November 1st, 2016) LICENSE Version older than May 28th, 2016 were licensed under the GNU General Public License (GPL), version 3. Since May 28th, 2016, python-netsnmpagent is being licensed under the GNU Lesser General Public License (LGPL), version 3. See http://www.gnu.org/licenses/lgpl-3.0.txt or the included file LICENSE. DOWNLOAD The PyPI page with distribution archives is available at http://pypi.python.org/pypi/netsnmpagent Binary RPMs for SuSE distributions are available via search.opensuse.org and the Open Build Service Project page at https://build.opensuse.org/package/show?package=python-netsnmpagent&project=home%3Apfhllnts If you wish to follow development more closely clone the GitHub repo: https://github.com/pief/python-netsnmpagent.git INSTALLATION If you do not use a ready package for your Linux distribution, you can install directly from source using python setup.py install This will most probably require appropriate rights (eg. being "root"). EXAMPLE USAGE The "examples" subdirectory contains well-commented example agents that should give you a quickstart on how to use python-netsnmpagent. Read the "README" file contained there for a short introduction on the different examples. API The Python API has not really been documented yet. For now, please see the example agents' source code for info on how to use the python-netsnmpagent module. NOTE: Since 2019-07-24 the OctetString interface has been changed to return a bytes() array instead of a String. This is to accomodate the fact that OctetStrings may contain NUL bytes, i.e. in the case of MAC addresses. TESTS python-netsnmpagent now comes with integration tests to test the net-snmp integration. Type "make tests" to run them. See tests/README for the reasons why "nosetests" can't be run directly. TODO - notifications/traps - more tests CREDITS python-netsnmpagent was inspired by python-agentx, courtesy of Bozhin Zafirov <[email protected]>. I blatantly ripped some ideas and some lines of code, shame on me. SNMP contexts support and various other additions were implemented by Steven Hiscocks <[email protected]>. Support for Gauge32, Float and TruthValue variable types was implemented based on a merge request by Bill Randle <[email protected]>. The bug that DisplayStrings/OctetStrings got truncated when trying to update them with a string larger that the original InitVal was hunted down and fixed by Max "mk23" Kalika <[email protected]>. Tobias Deiminger <[email protected]> contributed fixes related to using IpAddress objects as table indices. Konrad Gräfe <[email protected]> fixed among other things the OctetString interface to return bytes() instead of a String so NUL bytes are accounted for. Additional smaller bugfixes were done by Anton Todorov <[email protected]>.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.