o a@sddlZddlmZmZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZdd lmZgd ZGd d d eZGd ddeZGdddeZdS)N)rfc1902rfc1905)v2c ZipMibSource)addMibCompiler)SmiError)AbstractSimpleAsn1Item) PyAsn1Error)debug)ObjectIdentity ObjectTypeNotificationTypec@seZdZdZd\ZZddZddZddZd d Z d d Z d dZ ddZ ddZ ddZddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Zd1d2Zd3d4Zd5d6Zd7d8Z d9S):r a Create an object representing MIB variable ID. At the protocol level, MIB variable is only identified by an OID. However, when interacting with humans, MIB variable can also be referred to by its MIB name. The *ObjectIdentity* class supports various forms of MIB variable identification, providing automatic conversion from one to others. At the same time *ObjectIdentity* objects behave like :py:obj:`tuples` of py:obj:`int` sub-OIDs. See :RFC:`1902#section-2` for more information on OBJECT-IDENTITY SMI definitions. Parameters ---------- args initial MIB variable identity. Recognized variants: * single :py:obj:`tuple` or integers representing OID * single :py:obj:`str` representing OID in dot-separated integers form * single :py:obj:`str` representing MIB variable in dot-separated labels form * single :py:obj:`str` representing MIB name. First variable defined in MIB is assumed. * pair of :py:obj:`str` representing MIB name and variable name * pair of :py:obj:`str` representing MIB name and variable name followed by an arbitrary number of :py:obj:`str` and/or :py:obj:`int` values representing MIB variable instance identification. Other parameters ---------------- kwargs MIB resolution options(object): * whenever only MIB name is given, resolve into last variable defined in MIB if last=True. Otherwise resolves to first variable (default). Notes ----- Actual conversion between MIB variable representation formats occurs upon :py:meth:`~pysnmp.smi.rfc1902.ObjectIdentity.resolveWithMib` invocation. Examples -------- >>> from pysnmp.smi.rfc1902 import ObjectIdentity >>> ObjectIdentity((1, 3, 6, 1, 2, 1, 1, 1, 0)) ObjectIdentity((1, 3, 6, 1, 2, 1, 1, 1, 0)) >>> ObjectIdentity('1.3.6.1.2.1.1.1.0') ObjectIdentity('1.3.6.1.2.1.1.1.0') >>> ObjectIdentity('iso.org.dod.internet.mgmt.mib-2.system.sysDescr.0') ObjectIdentity('iso.org.dod.internet.mgmt.mib-2.system.sysDescr.0') >>> ObjectIdentity('SNMPv2-MIB', 'system') ObjectIdentity('SNMPv2-MIB', 'system') >>> ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0) ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0) >>> ObjectIdentity('IP-MIB', 'ipAdEntAddr', '127.0.0.1', 123) ObjectIdentity('IP-MIB', 'ipAdEntAddr', '127.0.0.1', 123) cOsT||_||_d|_|_d|_|_|j|_d|_|_ |_ d|_ |_ d|_ dS)N)_ObjectIdentity__args_ObjectIdentity__kwargs _ObjectIdentity__mibSourcesToAdd_ObjectIdentity__modNamesToLoad!_ObjectIdentity__asn1SourcesToAdd#_ObjectIdentity__asn1SourcesOptionsstDirty_ObjectIdentity__state_ObjectIdentity__indices_ObjectIdentity__oid_ObjectIdentity__label_ObjectIdentity__modName_ObjectIdentity__symName_ObjectIdentity__mibNode)selfargskwargsrr4/usr/lib/python3/dist-packages/pysnmp/smi/rfc1902.py__init__Ts    zObjectIdentity.__init__cCs,|j|j@r|j|j|jfStd|jj)aReturns MIB variable symbolic identification. Returns ------- str MIB module name str MIB variable symbolic name : :py:class:`~pysnmp.proto.rfc1902.ObjectName` class instance representing MIB variable instance index. Raises ------ SmiError If MIB variable conversion has not been performed. Examples -------- >>> objectIdentity = ObjectIdentity('1.3.6.1.2.1.1.1.0') >>> objectIdentity.resolveWithMib(mibViewController) >>> objectIdentity.getMibSymbol() ('SNMPv2-MIB', 'sysDescr', (0,)) >>> %s object not fully initialized)rstCleanrr rr __class____name__r"rrr% getMibSymbol^s zObjectIdentity.getMibSymbolcC"|j|j@r |jStd|jj)aCReturns OID identifying MIB variable. Returns ------- : :py:class:`~pysnmp.proto.rfc1902.ObjectName` full OID identifying MIB variable including possible index part. Raises ------ SmiError If MIB variable conversion has not been performed. Examples -------- >>> objectIdentity = ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0) >>> objectIdentity.resolveWithMib(mibViewController) >>> objectIdentity.getOid() ObjectName('1.3.6.1.2.1.1.1.0') >>> r'rr(rrr)r*r+rrr%getOid}s zObjectIdentity.getOidcCr-)aReturns symbolic path to this MIB variable. Meaning a sequence of symbolic identifications for each of parent MIB objects in MIB tree. Returns ------- tuple sequence of names of nodes in a MIB tree from the top of the tree towards this MIB variable. Raises ------ SmiError If MIB variable conversion has not been performed. Notes ----- Returned sequence may not contain full path to this MIB variable if some symbols are now known at the moment of MIB look up. Examples -------- >>> objectIdentity = ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0) >>> objectIdentity.resolveWithMib(mibViewController) >>> objectIdentity.getOid() ('iso', 'org', 'dod', 'internet', 'mgmt', 'mib-2', 'system', 'sysDescr') >>> r')rr(rrr)r*r+rrr%getLabels zObjectIdentity.getLabelcCr-Nr')rr(r!rr)r*r+rrr% getMibNodes zObjectIdentity.getMibNodecC |j|j@SN)rr(r+rrr%isFullyResolved zObjectIdentity.isFullyResolvedcOs@|jdur ||_n|j|7_|jr|j||S||_|S)aAdds path to a repository to search ASN.1 MIB files. Parameters ---------- *asn1Sources : one or more URL in form of :py:obj:`str` identifying local or remote ASN.1 MIB repositories. Path must include the *@mib@* component which will be replaced with MIB module name at the time of search. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.ObjectIdentity` reference to itself Notes ----- Please refer to :py:class:`~pysmi.reader.localfile.FileReader`, :py:class:`~pysmi.reader.httpclient.HttpReader` and :py:class:`~pysmi.reader.ftpclient.FtpReader` classes for in-depth information on ASN.1 MIB lookup. Examples -------- >>> ObjectIdentity('SNMPv2-MIB', 'sysDescr').addAsn1Source('http://mibs.snmplabs.com/asn1/@mib@') ObjectIdentity('SNMPv2-MIB', 'sysDescr') >>> N)rrupdater"Z asn1Sourcesr$rrr%addAsn1MibSources  zObjectIdentity.addAsn1MibSourcecG&|jdur ||_|S|j|7_|S)agAdds path to repository to search PySNMP MIB files. Parameters ---------- *mibSources : one or more paths to search or Python package names to import and search for PySNMP MIB modules. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.ObjectIdentity` reference to itself Notes ----- Normally, ASN.1-to-Python MIB modules conversion is performed automatically through PySNMP/PySMI interaction. ASN1 MIB modules could also be manually compiled into Python via the `mibdump.py `_ tool. Examples -------- >>> ObjectIdentity('SNMPv2-MIB', 'sysDescr').addMibSource('/opt/pysnmp/mibs', 'pysnmp_mibs') ObjectIdentity('SNMPv2-MIB', 'sysDescr') >>> N)rr"Z mibSourcesrrr% addMibSources zObjectIdentity.addMibSourcecGr:)aSchedules search and load of given MIB modules. Parameters ---------- *modNames: one or more MIB module names to load up and use for MIB variables resolution purposes. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.ObjectIdentity` reference to itself Examples -------- >>> ObjectIdentity('SNMPv2-MIB', 'sysDescr').loadMibs('IF-MIB', 'TCP-MIB') ObjectIdentity('SNMPv2-MIB', 'sysDescr') >>> N)rr"ZmodNamesrrr%loadMibss zObjectIdentity.loadMibsc Cs|jdur%tjtj@otdd|j|jjdd|jDd|_|jdur3t|jdddn8tjtj@oCtdd|jt|j|j|j d |j d |j d |j d |j d dd|_|_ |j durtjtj@otdd|j |jj |j d|_ |j |j@r|S|jddd\}}d|_t|jdtr|jd|t|jdkrtjtj@otd|jz t|jd|_WntySt|jdttfr||jd\}}}n>> objectIdentity = ObjectIdentity('SNMPv2-MIB', 'sysDescr') >>> objectIdentity.resolveWithMib(mibViewController) ObjectIdentity('SNMPv2-MIB', 'sysDescr') >>> Nzadding MIB sources %s, cSg|]}t|qSrr.0xrrr% _z1ObjectIdentity.resolveWithMib..T) ifAvailable ifNotAddedz(adding MIB compiler with source paths %s searchers borrowers destinationrFrG)ZsourcesrHrIrJrFrGzloading MIB modules %s SNMPv2-SMI MibScalarMibTableColumnrrrzresolving %s as OID or label.ZlastcSr@r)intrArrr%rDrEz Unknown object name component %rz(resolved %r into prefix %r and suffix %rz#resolved prefix %r into MIB node %rzresolved indices are %rrz *                            zObjectIdentity.resolveWithMibc sX|j|j@r$td|j|j|jrdpddfdd|jDfStd|j j )Nz %s::%s%s%srNrcs.g|]}|jddrd|p|qS)FZmatchConstraintsz"%s") isSuperTypeOf prettyPrintrAsrr%rDs.z.ObjectIdentity.prettyPrint..r') rr(rZ OctetStringrr rrTrr)r*r+rrjr%ris  zObjectIdentity.prettyPrintcC"d|jjddd|jDfS)N%s(%s)r?cSr@rreprrArrr%rDrEz+ObjectIdentity.__repr__..)r)r*rTrr+rrr%__repr__"zObjectIdentity.__repr__cC&|j|j@r t|jStd|jjN"%s object not properly initialized)rr(rQrrr)r*r+rrr%__str__  zObjectIdentity.__str__cCs&|j|j@r |j|kStd|jjrsr.r"otherrrr%__eq__$rvzObjectIdentity.__eq__cCs&|j|j@r |j|kStd|jjrsr.rwrrr%__ne__*rvzObjectIdentity.__ne__cCs&|j|j@r |j|kStd|jjrsr.rwrrr%__lt__0rvzObjectIdentity.__lt__cCs&|j|j@r |j|kStd|jjrsr.rwrrr%__le__6rvzObjectIdentity.__le__cC&|j|j@r |j|kStd|jjrsr.rwrrr%__gt__<rvzObjectIdentity.__gt__cCr}rsr.rwrrr%__ge__BrvzObjectIdentity.__ge__cCs&|j|j@r |jdkStd|jj)Nrrtr.r+rrr% __nonzero__HrvzObjectIdentity.__nonzero__cCrrrs)rr(boolrrr)r*r+rrr%__bool__NrvzObjectIdentity.__bool__cC&|j|j@r |j|Std|jjrsr.r"irrr% __getitem__TrvzObjectIdentity.__getitem__cCrrrs)rr(rZrrr)r*r+rrr%__len__ZrvzObjectIdentity.__len__cCs&|j|j@r |j|Std|jjrsr.rwrrr%__add__`rvzObjectIdentity.__add__cCs&|j|j@r ||jStd|jjrsr.rwrrr%__radd__frvzObjectIdentity.__radd__cCrrrs)rr(hashrrr)r*r+rrr%__hash__lrvzObjectIdentity.__hash__cCs<|j|j@r|dvrt|j|St|td|jj|f)N) ZasTuplecloneZsubtypeZ isPrefixOfZisSameTypeWithrhZ getTagSetZgetEffectiveTagSetZ getTagMapZtagSetindexz3%s object not properly initialized for accessing %s)rr(getattrrAttributeErrorrr)r*)r"attrrrr% __getattr__rs  zObjectIdentity.__getattr__N)!r* __module__ __qualname____doc__rr(r&r,r/r0r2r5r9r<r>rYrirpruryrzr{r|r~rrrrrrrrrrrrr%r s>= $($]  r c@sleZdZdZd\ZZdddZddZdd Zd d Z d d Z ddZ ddZ ddZ dddZddZdS)r a=Create an object representing MIB variable. Instances of :py:class:`~pysnmp.smi.rfc1902.ObjectType` class are containers incorporating :py:class:`~pysnmp.smi.rfc1902.ObjectIdentity` class instance (identifying MIB variable) and optional value belonging to one of SNMP types (:RFC:`1902`). Typical MIB variable is defined like this (from *SNMPv2-MIB.txt*): .. code-block:: bash sysDescr OBJECT-TYPE SYNTAX DisplayString (SIZE (0..255)) MAX-ACCESS read-only STATUS current DESCRIPTION "A textual description of the entity. This value should..." ::= { system 1 } Corresponding ObjectType instantiation would look like this: .. code-block:: python ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr'), 'Linux i386 box') In order to behave like SNMP variable-binding (:RFC:`1157#section-4.1.1`), :py:class:`~pysnmp.smi.rfc1902.ObjectType` objects also support sequence protocol addressing `objectIdentity` as its 0-th element and `objectSyntax` as 1-st. See :RFC:`1902#section-2` for more information on OBJECT-TYPE SMI definitions. Parameters ---------- objectIdentity : :py:class:`~pysnmp.smi.rfc1902.ObjectIdentity` Class instance representing MIB variable identification. objectSyntax : Represents a value associated with this MIB variable. Values of built-in Python types will be automatically converted into SNMP object as specified in OBJECT-TYPE->SYNTAX field. Notes ----- Actual conversion between MIB variable representation formats occurs upon :py:meth:`~pysnmp.smi.rfc1902.ObjectType.resolveWithMib` invocation. Examples -------- >>> from pysnmp.smi.rfc1902 import * >>> ObjectType(ObjectIdentity('1.3.6.1.2.1.1.1.0')) ObjectType(ObjectIdentity('1.3.6.1.2.1.1.1.0'), Null('')) >>> ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0), 'Linux i386') ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0), 'Linux i386') rNcCs<|durtj}t|tstd|f||g|_|j|_dSNz5initializer should be ObjectIdentity instance, not %r)r unSpecifiedrXr r_ObjectType__argsr_ObjectType__state)r"objectIdentityZ objectSyntaxrrr%r&s    zObjectType.__init__cCrr1)rr(rrr)r*rrrr%rrvzObjectType.__getitem__cCs|Sr4rir+rrr%ruszObjectType.__str__cCrl)Nrmr?cSr@rrnrArrr%rDrEz'ObjectType.__repr__..)r)r*rTrr+rrr%rprqzObjectType.__repr__cCr3r4)rr(r+rrr%r5r6zObjectType.isFullyResolvedcOs|jdj|i||S)aAdds path to a repository to search ASN.1 MIB files. Parameters ---------- *asn1Sources : one or more URL in form of :py:obj:`str` identifying local or remote ASN.1 MIB repositories. Path must include the *@mib@* component which will be replaced with MIB module name at the time of search. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.ObjectType` reference to itself Notes ----- Please refer to :py:class:`~pysmi.reader.localfile.FileReader`, :py:class:`~pysmi.reader.httpclient.HttpReader` and :py:class:`~pysmi.reader.ftpclient.FtpReader` classes for in-depth information on ASN.1 MIB lookup. Examples -------- >>> ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr')).addAsn1Source('http://mibs.snmplabs.com/asn1/@mib@') ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr')) >>> r)rr9r8rrr%r9szObjectType.addAsn1MibSourcecG|jdj||S)a{Adds path to repository to search PySNMP MIB files. Parameters ---------- *mibSources : one or more paths to search or Python package names to import and search for PySNMP MIB modules. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.ObjectType` reference to itself Notes ----- Normally, ASN.1-to-Python MIB modules conversion is performed automatically through PySNMP/PySMI interaction. ASN1 MIB modules could also be manually compiled into Python via the `mibdump.py `_ tool. Examples -------- >>> ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr')).addMibSource('/opt/pysnmp/mibs', 'pysnmp_mibs') ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr')) >>> r)rr<r;rrr%r<szObjectType.addMibSourcecGr)a#Schedules search and load of given MIB modules. Parameters ---------- *modNames: one or more MIB module names to load up and use for MIB variables resolution purposes. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.ObjectType` reference to itself Examples -------- >>> ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr')).loadMibs('IF-MIB', 'TCP-MIB') ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr')) >>> r)rr>r=rrr%r>szObjectType.loadMibsTc Cs|j|j@r|S|jd||jddd\}}t|jd||fsD|r:t|jdts:t d|jdf|j|jO_|St|jdt j t j t j t jfr^|j|jO_|Sz|jd|jd|jd<Wn4tyd|jd|jdjj|jdtdf}|rt|jdtst |Ynwtj|jddd rt|jd||jd<|j|jO_tjtj@otd |jd|jdf|S|S) a$Perform MIB variable ID and associated value conversion. Parameters ---------- mibViewController : :py:class:`~pysnmp.smi.view.MibViewController` class instance representing MIB browsing functionality. Other Parameters ---------------- ignoreErrors: :py:class:`bool` If `True` (default), ignore MIB object name or value casting failures if possible. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.ObjectType` reference to itself Raises ------ SmiError In case of fatal MIB hanling errora Notes ----- Calling this method involves :py:meth:`~pysnmp.smi.rfc1902.ObjectIdentity.resolveWithMib` method invocation. Examples -------- >>> from pysmi.hlapi import varbinds >>> mibViewController = varbinds.AbstractVarBinds.getMibViewController( engine ) >>> objectType = ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr'), 'Linux i386') >>> objectType.resolveWithMib(mibViewController) ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr'), DisplayString('Linux i386')) >>> str(objectType) 'SNMPv2-MIB::sysDescr."0" = Linux i386' >>> rrKrLrMrz2MIB object %r is not OBJECT-TYPE (MIB not loaded?)z8MIB object %r having type %r failed to cast value %r: %sFrgzresolved %r syntax is %r)rr(rrYrUrWrXr2r rrZ UnSpecifiedZ NoSuchObjectZNoSuchInstanceZ EndOfMibViewZ getSyntaxrr rir)r*r`rarZObjectIdentifierrhr r rRrS)r"rb ignoreErrorsrLrMerrrrr%rY*sZ * (    *zObjectType.resolveWithMibcCs<|j|j@rd|jd|jdfStd|jj)N%s = %srrr')rr(rrirr)r*r+rrr%ris  zObjectType.prettyPrintr4T)r*rrrrr(r&rrurpr5r9r<r>rYrirrrr%r ~s9 !  Wr c@speZdZdZd\ZZdifddZddZdd Zd d Z d d Z ddZ ddZ ddZ dddZddZdS)ra* Create an object representing SNMP Notification. Instances of :py:class:`~pysnmp.smi.rfc1902.NotificationType` class are containers incorporating :py:class:`~pysnmp.smi.rfc1902.ObjectIdentity` class instance (identifying particular notification) and a collection of MIB variables IDs that :py:class:`~pysnmp.entity.rfc3413.oneliner.cmdgen.NotificationOriginator` should gather and put into notification message. Typical notification is defined like this (from *IF-MIB.txt*): .. code-block:: bash linkDown NOTIFICATION-TYPE OBJECTS { ifIndex, ifAdminStatus, ifOperStatus } STATUS current DESCRIPTION "A linkDown trap signifies that the SNMP entity..." ::= { snmpTraps 3 } Corresponding NotificationType instantiation would look like this: .. code-block:: python NotificationType(ObjectIdentity('IF-MIB', 'linkDown')) To retain similarity with SNMP variable-bindings, :py:class:`~pysnmp.smi.rfc1902.NotificationType` objects behave like a sequence of :py:class:`~pysnmp.smi.rfc1902.ObjectType` class instances. See :RFC:`1902#section-2` for more information on NOTIFICATION-TYPE SMI definitions. Parameters ---------- objectIdentity : :py:class:`~pysnmp.smi.rfc1902.ObjectIdentity` Class instance representing MIB notification type identification. instanceIndex : :py:class:`~pysnmp.proto.rfc1902.ObjectName` Trailing part of MIB variables OID identification that represents concrete instance of a MIB variable. When notification is prepared, `instanceIndex` is appended to each MIB variable identification listed in NOTIFICATION-TYPE->OBJECTS clause. objects : dict Dictionary-like object that may return values by OID key. The `objects` dictionary is consulted when notification is being prepared. OIDs are taken from MIB variables listed in NOTIFICATION-TYPE->OBJECTS with `instanceIndex` part appended. Notes ----- Actual notification type and MIB variables look up occurs upon :py:meth:`~pysnmp.smi.rfc1902.NotificationType.resolveWithMib` invocation. Examples -------- >>> from pysnmp.smi.rfc1902 import * >>> NotificationType(ObjectIdentity('1.3.6.1.6.3.1.1.5.3')) NotificationType(ObjectIdentity('1.3.6.1.6.3.1.1.5.3'), (), {}) >>> NotificationType(ObjectIdentity('IP-MIB', 'linkDown'), ObjectName('3.5')) NotificationType(ObjectIdentity('1.3.6.1.6.3.1.1.5.3'), ObjectName('3.5'), {}) rrcCsBt|ts td|f||_||_||_g|_g|_|j|_ dSr) rXr r!_NotificationType__objectIdentity _NotificationType__instanceIndex_NotificationType__objects_NotificationType__varBinds%_NotificationType__additionalVarBindsr_NotificationType__state)r"rZ instanceIndexZobjectsrrr%r&s  zNotificationType.__init__cCrr1)rr(rrr)r*rrrr%rrvzNotificationType.__getitem__cCsd|jj|j|j|jfS)Nz%s(%r, %r, %r))r)r*rrrr+rrr%rpszNotificationType.__repr__cGsHtjtj@o td|f|j|j@rtd|jj|j ||S)aYAppends variable-binding to notification. Parameters ---------- *varBinds : :py:class:`~pysnmp.smi.rfc1902.ObjectType` One or more :py:class:`~pysnmp.smi.rfc1902.ObjectType` class instances. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.NotificationType` reference to itself Notes ----- This method can be used to add custom variable-bindings to notification message in addition to MIB variables specified in NOTIFICATION-TYPE->OBJECTS clause. Examples -------- >>> nt = NotificationType(ObjectIdentity('IP-MIB', 'linkDown')) >>> nt.addVarBinds(ObjectType(ObjectIdentity('SNMPv2-MIB', 'sysDescr', 0))) NotificationType(ObjectIdentity('IP-MIB', 'linkDown'), (), {}) >>> zadditional var-binds: %rz%s object is already sealed) r rRrSrr(rr)r*rextend)r"varBindsrrr% addVarBindss   zNotificationType.addVarBindscOs|jj|i||S)aAdds path to a repository to search ASN.1 MIB files. Parameters ---------- *asn1Sources : one or more URL in form of :py:obj:`str` identifying local or remote ASN.1 MIB repositories. Path must include the *@mib@* component which will be replaced with MIB module name at the time of search. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.NotificationType` reference to itself Notes ----- Please refer to :py:class:`~pysmi.reader.localfile.FileReader`, :py:class:`~pysmi.reader.httpclient.HttpReader` and :py:class:`~pysmi.reader.ftpclient.FtpReader` classes for in-depth information on ASN.1 MIB lookup. Examples -------- >>> NotificationType(ObjectIdentity('IF-MIB', 'linkDown'), (), {}).addAsn1Source('http://mibs.snmplabs.com/asn1/@mib@') NotificationType(ObjectIdentity('IF-MIB', 'linkDown'), (), {}) >>> )rr9r8rrr%r9sz!NotificationType.addAsn1MibSourcecG|jj||S)aAdds path to repository to search PySNMP MIB files. Parameters ---------- *mibSources : one or more paths to search or Python package names to import and search for PySNMP MIB modules. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.NotificationType` reference to itself Notes ----- Normally, ASN.1-to-Python MIB modules conversion is performed automatically through PySNMP/PySMI interaction. ASN1 MIB modules could also be manually compiled into Python via the `mibdump.py `_ tool. Examples -------- >>> NotificationType(ObjectIdentity('IF-MIB', 'linkDown'), (), {}).addMibSource('/opt/pysnmp/mibs', 'pysnmp_mibs') NotificationType(ObjectIdentity('IF-MIB', 'linkDown'), (), {}) >>> )rr<r;rrr%r<#s zNotificationType.addMibSourcecGr)a=Schedules search and load of given MIB modules. Parameters ---------- *modNames: one or more MIB module names to load up and use for MIB variables resolution purposes. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.NotificationType` reference to itself Examples -------- >>> NotificationType(ObjectIdentity('IF-MIB', 'linkDown'), (), {}).loadMibs('IF-MIB', 'TCP-MIB') NotificationType(ObjectIdentity('IF-MIB', 'linkDown'), (), {}) >>> )rr>r=rrr%r>Cs zNotificationType.loadMibscCr3r4)rr(r+rrr%r5[r6z NotificationType.isFullyResolvedTc Cs|j|j@r|S|j||jtttj j |j|||j dd\}|j }i}t||rc|D])}t||j||}|jt||j|tj||t|jd||<q8ntjtj@oqtd|jf|jD].}t|tstt|d|d}||||d|vr||j||d<qu|j|qug|_|j|jO_tjtj@otd|j|jf|S|S)aPerform MIB variable ID conversion and notification objects expansion. Parameters ---------- mibViewController : :py:class:`~pysnmp.smi.view.MibViewController` class instance representing MIB browsing functionality. Other Parameters ---------------- ignoreErrors: :py:class:`bool` If `True` (default), ignore MIB object name or value casting failures if possible. Returns ------- : :py:class:`~pysnmp.smi.rfc1902.NotificationType` reference to itself Raises ------ SmiError In case of fatal MIB hanling errora Notes ----- Calling this method might cause the following sequence of events (exact details depends on many factors): * :py:meth:`pysnmp.smi.rfc1902.ObjectIdentity.resolveWithMib` is called * MIB variables names are read from NOTIFICATION-TYPE->OBJECTS clause, :py:class:`~pysnmp.smi.rfc1902.ObjectType` instances are created from MIB variable OID and `indexInstance` suffix. * `objects` dictionary is queried for each MIB variable OID, acquired values are added to corresponding MIB variable Examples -------- >>> notificationType = NotificationType(ObjectIdentity('IF-MIB', 'linkDown')) >>> notificationType.resolveWithMib(mibViewController) NotificationType(ObjectIdentity('IF-MIB', 'linkDown'), (), {}) >>> rKrrzAWARNING: MIB object %r is not NOTIFICATION-TYPE (MIB not loaded?)rzresolved %r into %r)rr(rrYrappendr r rZ apiTrapPDUZ snmpTrapOIDrUrWr2rXZ getObjectsrrrVrrrZr rRrSr) r"rbrZSmiNotificationTyperfZvarBindsLocationZnotificationObjectrrrrr%rY^sX ,          "zNotificationType.resolveWithMibcCs2|j|j@rddd|jDStd|jj)N cSs(g|]}d|d|dfqS)rrrrrArrr%rDs(z0NotificationType.prettyPrint..r')rr(rTrrr)r*r+rrr%ris zNotificationType.prettyPrintNr)r*rrrrr(r&rrprr9r<r>r5rYrirrrr%rs@ #!   [r)r`Z pysnmp.protorrZpysnmp.proto.apirZpysnmp.smi.builderrZpysnmp.smi.compilerrZpysnmp.smi.errorrZpyasn1.type.baser Z pyasn1.errorr Zpysnmpr __all__objectr r rrrrr%s&       n