# SmartSNMP

**Repository Path**: xmant/SmartSNMP

## Basic Information

- **Project Name**: SmartSNMP
- **Description**: 小巧精悍的SNMP代理，支持SNMPv1/v2c/v3，使用Lua写私有mib
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2015-03-24
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

SmartSNMP - A Smart SNMP Agent
==============================

[![Build Status](https://travis-ci.org/credosemi/smartsnmp.svg?branch=master)](https://travis-ci.org/credosemi/smartsnmp) [![Coverage Status](https://coveralls.io/repos/credosemi/smartsnmp/badge.svg?branch=master)](https://coveralls.io/r/credosemi/smartsnmp?branch=master)

**SmartSNMP** is a minimal easy-config agent for network management supporting
SNMP v1/v2c/v3 and AgentX. It is written in C99 and Lua5.1. It can run both on
PC platforms like Linux and embedded systems such as OpenWRT.

License
-------

**SmartSNMP** is licensed under GPLv2 with "PRIVATE MIB" EXCEPTION, see `LICENSE` file for more details.

Configuration and Interfaces
----------------------------

One of the biggest bonuses (aka smartest features) of this agent is that you can
write your own private mibs and load it only if you learn to write lua files as
shown in `config` and `mibs` directory.

Operation
---------

**SmartSNMP** can run in two modes: the **SNMP mode** and the **AgentX mode**. In SNMP
mode the agent will run as an independent SNMP agent and process SNMP datagram
from the client, while in AgentX mode the agent will run as an sub-agent against
NET-SNMP as the master agent and process AgentX datagram from the master.

Revelant test samples are shown respectively as `tests/snmpd_test.sh` and `tests/agentx_test.sh`

Dependencies
------------

- Lua 5.1
- One of transports
  - built-in
    - select
    - kqueue
    - epoll
  - libevent
  - libubox/uloop (for OpenWrt)

Build
-----

Different event-driven mechanisms and transport options need respective libraries.
For expample, in libevent transport you need to install libevent, in uloop
transport you need to install libubox. Especially, on Ubuntu you should install
liblua5.1 while liblua is needed on other platforms.

Assume **SmartSNMP** is running on Ubuntu, you shall install libraries such as:

    # lua5.1
    sudo apt-get install -y lua5.1 liblua5.1-0-dev

    # scons & git
    sudo apt-get install -y scons git

    # clone with git
    git clone https://github.com/credosemi/smartsnmp.git

For more build options, type:

    scons --help

You will get:

    ... SCons Options ...
    Local Options:
      --with-agentx               enable agentx module you want to use
      --without-crypto            disable crypto modules you do not want to use
      --without-md5               disable MD5 module you do not want to use
      --without-sha               disable SHA module you do not want to use
      --without-aes               disable AES module you do not want to use
      --transport=[built-in|libevent|uloop]
                                  select transport model
      --evloop=[select|kqueue|epoll]
                                  select event loop model
      --with-cflags=CFLAGS        use CFLAGS as compile time arguments (will
                                    ignore CFLAGS env)
      --with-ldflags=LDFLAGS      use LDFLAGS as link time arguments to ld (will
                                    ignore LDFLAGS env)
      --with-libs=LIBS            use LIBS as link time arguments to ld
      --with-liblua=DIR           use liblua in DIR
      --with-libubox=DIR          use libubox in DIR (only for transport is uloop)
      --with-libevent=DIR         use libevent in DIR (only for transport is
                                    libevent)
      --gcov=[yes|no]             compile C source code with gcov support

You can specify options above you need to build the project.

_Installation scripts is coming soon._

Test script
-----------

Any SNMP daemon installed in you system should be closed before test.

    sudo /etc/init.d/snmpd stop

In **SNMP** mode, we would run SmartSNMP as daemon:

    cd smartsnmp
    scons
    sudo ./tests/snmp_daemon.sh

Then run test cases at another terminal:

    cd smartsnmp
    ./tests/testcase.sh

In **AgentX** mode, NET-SNMP will be tested as the master agent, so we will
download **NET-SNMP-5.7.3** source and build out the image in `tests` directory:

    cd smartsnmp
    ./tests/netsnmp_build.sh

Then run NET-SNMP as the master agent:

    sudo ./tests/net-snmp-release/sbin/snmpd -f -Lo -m "" -C -c tests/snmpd.conf

Then run SmartSNMP as a sub-agent at another terminal:

    cd smartsnmp
    scons --with-agentx
    ./tests/agentx_daemon.sh

Then run test cases at the third terminal:

    cd smartsnmp
    ./tests/testcase.sh

**Note:** If you want to run `./tests/test_all.py` as unit tests, you have to
build SmartSNMP with "scons --with-agentx" command.

TODO
----

See `TODO.md`.

Authors
-------

See `AUTHORS`.