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
135
136
137
138
139
140
|
.. include:: /includes/_links.rst
SNMP Library for Python |version|
=================================
.. toctree::
:maxdepth: 1
Return to PySNMP Homepage <https://pysnmp.com>
PySNMP is a cross-platform, pure-`Python`_ `SNMP`_
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 |version|. It runs with Python 3.9+
and is recommended for new applications as well as for migration from
older, now obsolete, PySNMP releases.
Besides the libraries, a set of pure-Python `command line tools`_
are shipped along with the system. Those tools mimic the interface
and behavior 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.
Quick Start and Samples
-----------------------
You already know something about SNMP and have no courage to dive into
this implementation? Try out quick start page!
We also have a collection of sample scripts to help you learn more about
every aspects of PySNMP.
.. toctree::
:maxdepth: 1
/quick-start
/examples/index
Documentation
-------------
.. note::
You can use version switch on the sidebar to browse documentation for
other supported PySNMP versions.
.. warning::
PySNMP 4.x, 5.x, 6.0, 6.1, and 7.0 are no longer supported. Materials
about such deprecated versions have been removed, but can still be found
in the `PySNMP GitHub repository`_.
If you are using one of these versions, please consider upgrading to a
supported version. You can find more information about supported
versions and their lifecycle by visiting `this lifecycle page`_.
You can learn more about how to upgrade from this page :doc:`/upgrade`.
Conceptual and API documentation are in the following section.
.. toctree::
:maxdepth: 2
/docs/index
.. note::
Documentation about the SNMP protocol can be found on `PySNMP Homepage`_.
Troubleshooting
---------------
If you are having trouble with PySNMP, please check the following section
to learn troubleshooting tips, upgrade guides, and performance tuning
advice.
.. toctree::
:maxdepth: 1
/troubleshooting
/upgrade
/performance
Downloads
---------
Please study the following pages to learn how to download versions of our
PySNMP package, and what changes are included from their release notes.
.. toctree::
:maxdepth: 1
/download
/changelog
License
-------
PySNMP software is free and open-source. Source code is hosted in
the `PySNMP Github repository`_.
The library is being distributed under 2-clause BSD-style license. More
details can be found in the following page.
.. toctree::
:maxdepth: 1
/license
PySNMP library development was initially sponsored by a `PSF`_ grant.
FAQ
---
We have a collection of frequently asked questions.
.. toctree::
:maxdepth: 2
/faq/index
Support
-------
To learn about community and commercial support options, please visit
.. toctree::
:maxdepth: 1
Support Options <https://www.pysnmp.com/support>
If you have other inquiries, please contact `LeXtudio Inc.`_.
|
