Skip to main content

Sysdescparser is a utility tool for network operators. This module parses SNMP sysDescr(OID: 1.3.6.1.2.1.1.1).

Recent IP equipments are implemented useful API. However connection method is different with each vendor. In case of multi-vendor environment, we have to check each target node’s information such as vendor name and os name. I think checking of SNMP sysDescr is a very efficient as a unified method for pre-filter. This module parses sysDescr value with vendor name, model name, os name and os version as far as possible. However, the sysDescr is free format. It does not guarantee that these information always exists. Unknown value, assigns the UNKNOWN. If you have any need to handle the equipment that this module does not support, then please send the sysDescr value to this package author. Or, please contact using function of the such as github pull request.

https://secure.travis-ci.org/mtoshi/sysdescrparser.svg?branch=master https://coveralls.io/repos/mtoshi/sysdescrparser/badge.svg?branch=master Latest Version

Requirements

  • Python2.7, 3.5, 3.6, 3.7, PyPy.

Instration

  • PyPI or Github.

    $ pip install sysdescrpaser
    
    or
    
    $ git clone https://github.com/mtoshi/sysdescrparser
    $ cd sysdescrparser
    $ sudo python setup.py install

Using example

  • Example for Juniper Junos sysDescr

    >>> from sysdescrparser import sysdescrparser
    >>> sysdescr = sysdescrparser('Juniper Networks, Inc. ex2200-48t-4g internet router, kernel JUNOS 10.2R1.8 #0: 2010-05-27 20:13:49 UTC')
    >>> sysdescr.vendor
    'JUNIPER'
    >>> sysdescr.model
    'ex2200-48t-4g'
    >>> sysdescr.os
    'JUNOS'
    >>> sysdescr.version
    '10.2R1.8'
  • Example for Cisco CiscoIOS sysDescr

    >>> sysdescr = sysdescrparser('Cisco IOS Software, c7600s72033_rp Software (c7600s72033_rp-ADVIPSERVICESK9-M), Version 12.2(33)SRC5, RELEASE SOFTWARE (fc2)')
    >>> sysdescr.vendor
    'CISCO'
    >>> sysdescr.model
    'c7600s72033_rp-ADVIPSERVICESK9-M'
    >>> sysdescr.os
    'IOS'
    >>> sysdescr.version
    '12.2(33)SRC5'
  • Example for Brocade VDX sysDescr

    >>> sysdescr = sysdescrparser('Brocade VDX Switch.')
    >>> sysdescr.vendor
    'BROCADE'
    >>> sysdescr.model
    'VDX'
    >>> sysdescr.os
    'NOS'
    >>> sysdescr.version
    'UNKNOWN'

Parsing logic and Support Vendor and OS

  • About parsing logic and support of vendor and os.

    Of course you are able to see this python code and also see how it works easily from sample data. https://github.com/mtoshi/sysdescrparser/blob/master/samples/sample_data.json It will be able to understand almost. (Sometimes, using hard code. And also using UNKNOWN values.) This sample data is also used directly by code test.

  • About uncovered vendor and os.

    If you have any need to handle the equipment that this module does not support, then please send the sysDescr value to this package author. Or, please contact using function of the such as github pull request.

  • If you already enabled SNMP daemon, then you can get sysDescr value with below.

    % snmpwalk -Os -v 2c -c your_community_string localhost 1.3.6.1.2.1.1.1
    sysDescr.0 = STRING: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    
    % snmpget -Os -v 2c -c your_community_string localhost 1.3.6.1.2.1.1.1.0
    sysDescr.0 = STRING: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Metadata

Release files for snmpsysdescrparser 0.1.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for snmpsysdescrparser 0.1.21
File Size Uploaded
snmpsysdescrparser-0.1.21.tar.gz 11.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for snmpsysdescrparser 0.1.21
File Interpreter ABI Platform
snmpsysdescrparser-0.1.21-py3-none-any.whl Python 3 none any Details

Total release size: 40.2 kB

Release files / snmpsysdescrparser-0.1.21.tar.gz

Download URL snmpsysdescrparser-0.1.21.tar.gz
Size 11.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4f1924ea15f23204beb3411b0e2801474b4303aff3045dddcf318bb39e1dfc4e
BLAKE2b-256 checksum
How to use checksums
4a06e204e273fd99fdef92ffc963e7a4c9f62be1ee428502731b2900e3b60190
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.7.3

Release files / snmpsysdescrparser-0.1.21-py3-none-any.whl

Download URL snmpsysdescrparser-0.1.21-py3-none-any.whl
Size 28.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
64ab112bc7101181ed835e05bcce5632dc54ee26a38acaa1ce5debadc619d949
BLAKE2b-256 checksum
How to use checksums
e70a7b730725d345fc43d01372389cd35e62dd3b038c378c660e0f2ada45cf9f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.7.0 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.7.3

Release history Release notifications | RSS feed

This release

0.1.21 This release

2 release files

0.1.19

2 release files

0.1.18

1 release file

0.1.17

1 release file

0.1.16

1 release file

0.1.15

1 release file

0.1.13

1 release file

0.1.11

1 release file

0.1.10

1 release file

0.1.9

1 release file

0.1.8

1 release file

0.1.7

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page