blob: d52b0a63416935ebe08d9faec1fad4a5248f2724 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
SNMP library for Python
=======================
.. toctree::
:maxdepth: 2
PySNMP is a cross-platform, pure-`Python <http://www.python.org/>`_
`SNMP <http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol>`_
engine implementation. It features fully-functional SNMP engine capable
to act in Agent/Manager/Proxy roles, talking SNMP v1/v2c/v3 protocol
versions over IPv4/IPv6 and other network transports.
Despite its name, SNMP is not really a simple protocol. For instance its
third version introduces complex and open-ended security framework,
multilingual capabilities, remote configuration and other features.
PySNMP implementation closely follows intricate system details and features
bringing most possible power and flexibility to its users.
Current PySNMP stable version is 4.4. It runs with Python 2.4 through 3.6
and is recommended for new applications as well as for migration from
older, now obsolete, PySNMP releases. All site documentation and
examples are written for the 4.4 and later versions in mind.
Older materials are still available under the obsolete section.
Besides the libraries, a set of pure-Python
`command-line tools <https://pypi.org/project/snmpclitools/>`_
are shipped along with the system. Those tools mimic the interface
and behaviour of popular Net-SNMP snmpget/snmpset/snmpwalk utilities.
They may be useful in a cross-platform situations as well as a testing
and prototyping instrument for pysnmp users.
PySNMP software is free and open-source. Source code is hosted in
a `Github repo <https://github.com/etingof/pysnmp>`_.
The library is being distributed under 2-clause BSD-style license.
PySNMP library development has been initially sponsored
by a `PSF <http://www.python.org/psf/>`_ grant.
Quick start
-----------
You already know something about SNMP and have no courage to dive into
this implementation? Try out quick start page!
.. toctree::
:maxdepth: 2
/quick-start
Documentation
-------------
.. toctree::
:maxdepth: 2
/docs/tutorial
/docs/api-reference
Examples
--------
.. toctree::
:maxdepth: 2
/examples/contents
Download
--------
Best way is usually to
.. code-block:: bash
# pip install pysnmp
If that does not work for you for some reason, you might need to read the
following page.
.. toctree::
:maxdepth: 2
/download
License
-------
.. toctree::
:maxdepth: 2
/license
FAQ
---
.. toctree::
:maxdepth: 2
/faq
Further development
-------------------
We fanatically document all fixes, changes and new features in changelog.
There you could also download the latest unreleased pysnmp tarball
containing the latest fixes and improvements.
.. toctree::
:maxdepth: 1
/changelog
Our development plans and new features we consider for eventual implementation
are collected in the following section.
.. toctree::
:maxdepth: 2
/development
Contact
-------
In case of questions or troubles using PySNMP, please open up an
`issue <https://github.com/etingof/pysnmp/issues>`_ at GitHub or ask at
`Stack Overflow <http://stackoverflow.com/questions/tagged/pysnmp>`_ .
Old site archive
----------------
.. toctree::
:maxdepth: 2
/oldsite
|
