Metadata-Version: 2.1
Name: snmpsim-data
Version: 1.0.1
Summary: This package includes a collection of SNMP dumps from different real-world SNMP-managed devices and software.
Home-page: https://github.com/lextudio/snmpsim-data
License: BSD-2-Clause
Author: Ilya Etingof
Author-email: etingof@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Telecommunications Industry
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Communications
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: pysmi (>=1.3.0,<2.0.0)
Requires-Dist: snmpsim (>=1.0.0,<2.0.0)
Project-URL: Repository, https://github.com/lextudio/snmpsim-data
Description-Content-Type: text/markdown


# SNMP Simulation Data

[![PyPI](https://img.shields.io/pypi/v/snmpsim-data.svg?maxAge=2592000)](https://pypi.org/project/snmpsim-data/)
[![Python Versions](https://img.shields.io/pypi/pyversions/snmpsim-data.svg)](https://pypi.org/project/snmpsim-data/)
[![GitHub license](https://img.shields.io/badge/license-BSD-blue.svg)](https://raw.githubusercontent.com/lextudio/snmpsim-data/master/LICENSE.txt)

The `snmpsim-data` package contains simulation data for
[snmpsim](https://www.pysnmp.com/snmpsim) - free and open-source SNMP agent simulator.

The package is distributed under 2-clause
[BSD license](https://www.pysnmp.com/snmpsim/license.html).

## Download

SNMP simulation data can be downloaded as a Python package from
[PyPI](https://pypi.org/project/snmpsim-data/).

## Installation

Just run:

```bash
$ pyenv local 3.12
$ pip install pipenv
$ pipenv install snmpsim-data
$ pipenv run setup-snmpsim-data ./data
```

This installs `snmpsim` package as a dependency, and copy simulation
data into the `data` directory.

## How to Use Simulation Data

Invoke `snmpsim-command-responder` and point it to a directory with simulation data:

``` bash
$ pipenv run snmpsim-command-responder --data-dir=data/UPS --agent-udpv4-endpoint=127.0.0.1:1024
```

> This allows the simulator to read the specific files and emulate UPS devices.

## Simulation Data Format
Simulation data is stored in simple plain-text files having `OID|TYPE|VALUE`
format:

``` bash
$ cat public.snmprec
1.3.6.1.2.1.1.1.0|4|Linux 2.6.25.5-smp SMP Tue Jun 19 14:58:11 CDT 2007 i686
1.3.6.1.2.1.1.2.0|6|1.3.6.1.4.1.8072.3.2.10
1.3.6.1.2.1.1.3.0|67|233425120
1.3.6.1.2.1.2.2.1.6.2|4x|00127962f940
1.3.6.1.2.1.4.22.1.3.2.192.21.54.7|64x|c3dafe61
...
```

Simulator maps query parameters like SNMP community names, SNMPv3 contexts or
IP addresses onto data files paths relative to the `data` directory.

## Documentation

Detailed information on SNMP simulator usage could be found at
[snmpsim site](https://www.pysnmp.com/snmpsim/).

## Getting help

If you run into bad simulation data, feel free to
[open an issue](https://github.com/lextudio/pysnmp/issues) on GitHub.

## Contributions

If you have an SNMP-managed device, consider snmpwalk'ing it (or use `snmprec` tool
from `snmpsim` package) and submit a PR offering your data.

Copyright (c) 2019, [Ilya Etingof](mailto:etingof@gmail.com).
Copyright (c) 2024, [LeXtudio Inc.](mailto:support@lextudio.com).
All rights reserved.

