summaryrefslogtreecommitdiff
path: root/docs/source/examples/hlapi/v1arch/asyncore/contents.rst
blob: 5f1e16d9b64ac095b5ca69b7fd2220e9fc318f84 (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

Asynchronous SNMP (asyncore, v1arch)
====================================

Applications build around :mod:`asyncore` get CPU time on :mod:`socket`
events being watched for by :mod:`select` dispatcher. User code
lives mostly in isolated functions (or any callable objects).

As it is with any asynchronous I/O system, `asyncore` lets you run
many SNMP queries in parallel and/or sequentially, interleave SNMP
queries with other I/O operations for as long as they are managed
within the same event loop.

The :mod:`pysnmp.hlapi.v1arch.asyncore` package implements `asyncore`
binding to pysnmp's `v1arch` services.

In most examples approximate analogues of well known Net-SNMP snmp* tools
command line options are shown. That may help those readers who, by chance
are familiar with Net-SNMP tools, better understanding what example code doe

Here's a quick example on a simple SNMP GET by high-level API:

.. include:: /../../examples/hlapi/v1arch/asyncore/manager/cmdgen/v2c-get.py
   :start-after: options:
   :end-before: Functionally

.. literalinclude:: /../../examples/hlapi/v1arch/asyncore/manager/cmdgen/v2c-get.py
   :start-after: """#
   :language: python

.. toctree::

   /examples/hlapi/v1arch/asyncore/manager/cmdgen/snmp-versions
   /examples/hlapi/v1arch/asyncore/manager/cmdgen/modifying-variables
   /examples/hlapi/v1arch/asyncore/manager/cmdgen/walking-operations
   /examples/hlapi/v1arch/asyncore/manager/cmdgen/table-operations
   /examples/hlapi/v1arch/asyncore/manager/cmdgen/mib-tweaks
   /examples/hlapi/v1arch/asyncore/manager/cmdgen/transport-tweaks
   /examples/hlapi/v1arch/asyncore/manager/cmdgen/advanced-topics

The following code sends SNMP TRAP:

   .. include:: /../../examples/hlapi/v1arch/asyncore/agent/ntforg/generic-v1-trap.py
      :start-after: options:
      :end-before: Functionally

   .. literalinclude:: /../../examples/hlapi/v1arch/asyncore/agent/ntforg/generic-v1-trap.py
      :start-after: """#
      :language: python

More examples on Notification Originator API usage follow.

.. toctree::

   /examples/hlapi/v1arch/asyncore/agent/ntforg/common-notifications
   /examples/hlapi/v1arch/asyncore/agent/ntforg/evaluating-notification-type
   /examples/hlapi/v1arch/asyncore/agent/ntforg/advanced-topics

More sophisticated SNMP operations can still be performed with
PySNMP via its Native API to Standard SNMP Applications.