1 files changed, 44 insertions, 38 deletions
diff --git a/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-table-object-by-multiple-indices.py b/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-table-object-by-multiple-indices.py
index 7b78a35..ebc2b0c 100644
--- a/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-table-object-by-multiple-indices.py
+++ b/examples/v3arch/asyncore/oneliner/manager/cmdgen/get-v3-table-object-by-multiple-indices.py
@@ -1,40 +1,46 @@
-#
-# Command Generator
-#
-# Send SNMP GET request using the following options:
-#
-# * with SNMPv3, user 'usr-sha-aes128', SHA auth, AES128 privacy
-# * over IPv4/UDP
-# * to an Agent at demo.snmplabs.com:161
-# * for TCP-MIB::tcpConnLocalAddress."0.0.0.0".22."0.0.0.0".0 MIB object
-#
+"""
+Fetch table row by composite index
+++++++++++++++++++++++++++++++++++
+
+Send SNMP GET request using the following options:
+
+* with SNMPv3, user 'usr-sha-aes128', SHA auth, AES128 privacy
+* over IPv4/UDP
+* to an Agent at demo.snmplabs.com:161
+* for TCP-MIB::tcpConnLocalAddress."0.0.0.0".22."0.0.0.0".0 MIB object
+
+Functionally similar to:
+
+| $ snmpget -v3 -l authPriv -u usr-md5-des -A authkey1 -X privkey1 \
+|           -a SHA -x AES \
+|           demo.snmplabs.com \
+|           TCP-MIB::tcpConnLocalAddress."0.0.0.0".22."0.0.0.0".0 
+
+"""#
 from pysnmp.entity.rfc3413.oneliner.cmdgen import *
 
-for errorIndication, \
-    errorStatus, errorIndex, \
-    varBinds in getCmd(SnmpEngine(),
-                       UsmUserData('usr-sha-aes128', 'authkey1', 'privkey1',
-                                   authProtocol=usmHMACSHAAuthProtocol,
-                                   privProtocol=usmAesCfb128Protocol ),
-                       UdpTransportTarget(('demo.snmplabs.com', 161)),
-                       ContextData(),
-                       ObjectType(
-                           ObjectIdentity('TCP-MIB',
-                                          'tcpConnLocalAddress',
-                                          '0.0.0.0', 22,
-                                          '0.0.0.0', 0)
-                       )):
-    # Check for errors and print out results
-    if errorIndication:
-        print(errorIndication)
-    else:
-        if 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 ]))
-    break
+errorIndication, errorStatus, errorIndex, varBinds = next(
+    getCmd(SnmpEngine(),
+           UsmUserData('usr-sha-aes128', 'authkey1', 'privkey1',
+                       authProtocol=usmHMACSHAAuthProtocol,
+                       privProtocol=usmAesCfb128Protocol ),
+           UdpTransportTarget(('demo.snmplabs.com', 161)),
+           ContextData(),
+           ObjectType(ObjectIdentity('TCP-MIB',
+                                     'tcpConnLocalAddress',
+                                     '0.0.0.0', 22,
+                                     '0.0.0.0', 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 ]))