SNMPD connector library for Bash

Abstract

The SNMP daemon provided in the net-analyzer/net-snmp package supports a variety of extension mechanisms including "pass-through scripts" which allow simple Bash scripts to be used to extend the functionality of the agent. Unfortunately, writing such a script is a non-trivial exercise not least because the extension agent is required to assist the SNMP daemon by providing access to the MIB structure. This knowledge of the MIB structure is essential to facilitate GETNEXT requests which enable "walking" the resulting tree.

The dev-libs/snmpd-connector-lib package provides an SNMPD agent/connector library for the Bash shell scripting language designed to assist with the development of new SNMPD agents/connectors, especially those providing access to tabular data, by providing an extremely simple API as well as other useful features including abstraction of the MIB structure.

Contents

• Preparing the ground
  • Installing the SNMPD connector library
    • Installing the overlay
    • Installing the package
    • Depending on the package
• Documentation
  • MIB structure
    • Displaying the MIB structure as a tree
    • Displaying numeric OIDs
    • Walking the tree
    • MIB table structure
  • SNMPD connector library basics
    • Including the library
    • Defining the MIB structure
    • Define an index function
    • Implement MIB specific functions
    • Start the loop
• Reference
  • send_boolean
    • Function description
    • Function parameters
    • Example use
  • send_gauge
    • Function description
    • Function parameters
    • Example use
  • send_integer
    • Function description
    • Function parameters
    • Example use
  • send_none
    • Function description
    • Function parameters
    • Example use
  • send_string
    • Function description
    • Function parameters
    • Example use