PySNMP-PySMI 1.1.12

SNMP MIB解析器

PySMI是SNMP SMI MIB解析器的纯Python实现，网址为SNMP SMI MIB解析器。该工具旨在将ASN.1 MIB转换为各种格式。目前，可以从ASN.1 MIB生成JSON和pysnmp模块。

功能

• 理解SMIv1、SMIv2和事实上的SMI方言
• 将MIB转换为pysnmp类和JSON文档
• 维护多个MIB模块的MIB对象索引
• 自动从本地目录、ZIP存档、HTTP和FTP服务器拉取ASN.1 MIB
• 100% Python，支持Python 2.4至Python 3.7

PySMI文档可以在pysmi网站找到。

如何使用PySMI

如果您使用pysnmp，您可能永远不会注意到pysmi的存在 - pysnmp在幕后调用pysmi进行MIB下载和编译（您仍然可以手动执行，通过调用mibdump.py工具）。

要将ASN.1 MIB转换为JSON文档，像这样调用mibdump.py工具

$ mibdump.py --generate-mib-texts  --destination-format json IF-MIB
Source MIB repositories: file:///usr/share/snmp/mibs, https://pysnmp.github.io/mibs/asn1/@mib@
Borrow missing/failed MIBs from: http://pysnmp.github.io/json/fulltexts/@mib@
Existing/compiled MIB locations: 
Compiled MIBs destination directory: .
MIBs excluded from code generation: RFC-1212, RFC-1215, RFC1065-SMI, RFC1155-SMI,
RFC1158-MIB, RFC1213-MIB, SNMPv2-CONF, SNMPv2-SMI, SNMPv2-TC, SNMPv2-TM
MIBs to compile: IF-MIB
Destination format: json
Parser grammar cache directory: not used
Also compile all relevant MIBs: yes
Rebuild MIBs regardless of age: yes
Do not create/update MIBs: no
Byte-compile Python modules: no (optimization level no)
Ignore compilation errors: no
Generate OID->MIB index: no
Generate texts in MIBs: yes
Keep original texts layout: no
Try various filenames while searching for MIB module: yes
Created/updated MIBs: IANAifType-MIB, IF-MIB, SNMPv2-MIB
Pre-compiled MIBs borrowed: 
Up to date MIBs: SNMPv2-CONF, SNMPv2-SMI, SNMPv2-TC
Missing source MIBs: 
Ignored MIBs: 
Failed MIBs: 

从IF-MIB模块构建的JSON文档将包含以下信息

   {
      "ifMIB": {
          "name": "ifMIB",
          "oid": "1.3.6.1.2.1.31",
          "class": "moduleidentity",
          "revisions": [
            "2007-02-15 00:00",
            "1996-02-28 21:55",
            "1993-11-08 21:55"
          ]
        },
      ...
      "ifTestTable": {
        "name": "ifTestTable",
        "oid": "1.3.6.1.2.1.31.1.3",
        "nodetype": "table",
        "class": "objecttype",
        "maxaccess": "not-accessible"
      },
      "ifTestEntry": {
        "name": "ifTestEntry",
        "oid": "1.3.6.1.2.1.31.1.3.1",
        "nodetype": "row",
        "class": "objecttype",
        "maxaccess": "not-accessible",
        "augmention": {
          "name": "ifTestEntry",
          "module": "IF-MIB",
          "object": "ifEntry"
        }
      },
      "ifTestId": {
        "name": "ifTestId",
        "oid": "1.3.6.1.2.1.31.1.3.1.1",
        "nodetype": "column",
        "class": "objecttype",
        "syntax": {
          "type": "TestAndIncr",
          "class": "type"
        },
        "maxaccess": "read-write"
      },
      ...
   }

通常，转换后的MIB捕获原始（ASN.1）MIB内容和布局的所有方面。上面的代码片段只是部分示例，但这里是完整的IF-MIB.json文件。

除了一对一的MIB转换外，PySMI库还可以生成JSON索引，以方便在大量MIB文件中快速查找MIB信息。例如，IP-MIB.json、TCP-MIB.json和UDP-MIB.json模块的JSON索引将包含如下信息

   {
      "compliance": {
         "1.3.6.1.2.1.48.2.1.1": [
           "IP-MIB"
         ],
         "1.3.6.1.2.1.49.2.1.1": [
           "TCP-MIB"
         ],
         "1.3.6.1.2.1.50.2.1.1": [
           "UDP-MIB"
         ]
      },
      "identity": {
          "1.3.6.1.2.1.48": [
            "IP-MIB"
          ],
          "1.3.6.1.2.1.49": [
            "TCP-MIB"
          ],
          "1.3.6.1.2.1.50": [
            "UDP-MIB"
          ]
      },
      "oids": {
          "1.3.6.1.2.1.4": [
            "IP-MIB"
          ],
          "1.3.6.1.2.1.5": [
            "IP-MIB"
          ],
          "1.3.6.1.2.1.6": [
            "TCP-MIB"
          ],
          "1.3.6.1.2.1.7": [
            "UDP-MIB"
          ],
          "1.3.6.1.2.1.49": [
            "TCP-MIB"
          ],
          "1.3.6.1.2.1.50": [
            "UDP-MIB"
          ]
      }
   }

在这个例子中，compliance和identity键指向MODULE-COMPLIANCE和MODULE-IDENTITY MIB对象，oids列出了MIB模块中定义的顶级OID分支。可以在这里查看数千个MIB的完整索引。

PySMI库可以自动从HTTP、FTP站点或本地目录获取所需的MIB。您可以为该目的配置任何可用的MIB源（包括https://pysnmp.github.io/mibs/asn1）。

如何获取PySMI

pysmi软件包在2-clause BSD许可协议下分发。源代码作为GitHub repo免费提供。

您可以使用pip install pysnmp-pysmi或从PyPI下载它。

如果某些事情没有按预期工作，请在GitHub上打开一个问题或在Stack Overflow上发布您的问题。

版权（c）2015-2020，Ilya Etingof。保留所有权利。