summaryrefslogtreecommitdiff
path: root/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v2c-with-custom-timeout-and-retries.py
blob: 1439aeb3904757ec3e9af788cb2cf8056be6e637 (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
"""
Custom request timeout
++++++++++++++++++++++

Send SNMP GET request using the following options:

* with SNMPv2c, community 'public'
* over IPv4/UDP
* to an Agent at demo.snmplabs.com:161
* for an OID in string form 
* use custom timeout and request retries values

Transport timing settings (maximum number of request retries and 
individual request timeout in seconds) can be set on a per-target basis
as explained by the code that follows.

Keep in mind that while timeout value can be specified in fractions of a
second, default pysnmp timer resolution is quite low (about 0.5 sec)
so there's no much point in using timeouts which is not a multiple of 0.5
Internal timer can be programmatically adjusted to finer resolution if needed.

If retries value is set to 0, pysnmp will issue a single request. Even
if no response arrives, there will be no retry. Likewise, retries=1
means one initial request plus one retry.

Functionally similar to:

| $ snmpget -v1 -c public demo.snmplabs.com 1.3.6.1.2.1.1.1.0

"""#
from pysnmp.entity.rfc3413.oneliner.cmdgen import *

errorIndication, errorStatus, errorIndex, varBinds = next(
    getCmd(SnmpEngine(),
           CommunityData('public'),
           UdpTransportTarget(
               ('demo.snmplabs.com', 161), timeout=1.5, retries=0
           ),
           ContextData(),
           ObjectType(ObjectIdentity('1.3.6.1.2.1.1.1.0')))
)

if errorIndication:
    print(errorIndication)
elif errorStatus:
    print('%s at %s' % (
            errorStatus.prettyPrint(),
            errorIndex and varBinds[int(errorIndex)-1][0] or '?'
        )
    )
else:
    for varBind in varBinds:
        print(' = '.join([ x.prettyPrint() for x in varBind ]))