1 files changed, 43 insertions, 41 deletions
diff --git a/examples/v3arch/asyncore/oneliner/manager/cmdgen/set-v3-with-custom-contextengineid-and-contextname.py b/examples/v3arch/asyncore/oneliner/manager/cmdgen/set-v3-with-custom-contextengineid-and-contextname.py
index 9c5b20f..f017882 100644
--- a/examples/v3arch/asyncore/oneliner/manager/cmdgen/set-v3-with-custom-contextengineid-and-contextname.py
+++ b/examples/v3arch/asyncore/oneliner/manager/cmdgen/set-v3-with-custom-contextengineid-and-contextname.py
@@ -1,43 +1,45 @@
-#
-# Command Generator
-#
-# Send SNMP SET request using the following options:
-#
-# * with SNMPv3 with user 'usr-md5-none', MD5 auth and no privacy protocols
-# * over IPv4/UDP
-# * to an Agent at demo.snmplabs.com:161
-# * addressing particular set of Managed Objects at remote SNMP Engine by:
-#   * contextEngineId 0x80004fb805636c6f75644dab22cc and
-#   * contextName 'a172334d7d97871b72241397f713fa12'
-# * setting SNMPv2-MIB::sysName.0 to new value (type taken from MIB)
-#
+"""
+Custom ContextEngineId and ContextName
+++++++++++++++++++++++++++++++++++++++
+
+Send SNMP SET request using the following options:
+
+* with SNMPv3 with user 'usr-md5-none', MD5 auth and no privacy protocols
+* over IPv4/UDP
+* to an Agent at demo.snmplabs.com:161
+* addressing particular set of Managed Objects at remote SNMP Engine by:
+  * contextEngineId 0x80004fb805636c6f75644dab22cc and
+  * contextName 'a172334d7d97871b72241397f713fa12'
+* setting SNMPv2-MIB::sysName.0 to new value (type taken from MIB)
+
+Functionally similar to:
+
+| $ snmpset -v3 -u usr-md5-des -l authPriv -A authkey1 -X privkey1 \
+|       -E 80004fb805636c6f75644dab22cc -n a172334d7d97871b72241397f713fa12 \
+|       demo.snmplabs.com  \
+|       SNMPv2-MIB::sysORDescr.1 = "new system name"
+
+"""#
 from pysnmp.entity.rfc3413.oneliner.cmdgen import *
-from pysnmp.proto import rfc1902
 
-for errorIndication, \
-    errorStatus, errorIndex, \
-    varBinds in setCmd(SnmpEngine(),
-                       UsmUserData('usr-md5-none', 'authkey1'),
-                       UdpTransportTarget(('demo.snmplabs.com', 161)),
-                       ContextData(
-                           contextEngineId=rfc1902.OctetString(hexValue='80004fb805636c6f75644dab22cc'),
-                           contextName='da761cfc8c94d3aceef4f60f049105ba'
-                       ),
-                       ObjectType(
-                           ObjectIdentity('SNMPv2-MIB', 'sysORDescr', 1),
-                           'new system name'
-                       )):
-    # 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(
+    setCmd(SnmpEngine(),
+           UsmUserData('usr-md5-none', 'authkey1'),
+           UdpTransportTarget(('demo.snmplabs.com', 161)),
+           ContextData(contextEngineId=OctetString(hexValue='80004fb805636c6f75644dab22cc'),
+                       contextName='da761cfc8c94d3aceef4f60f049105ba'),
+           ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysORDescr', 1),
+                      'new system name'))
+)
+
+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 ]))