title Extending the Agent
description You can extend the snmp agent to have it return information
description that you yourself define.
token exec
info run a simple command using exec()
info arguments: [oid] name /path/to/executable arguments
question 1 The OID where the results table should be display [default=extTable]
question 2 The "name" to associate with this command when displaying the results.
question 3 The path to the program to be run.
question 4 The arguments to pass to $3
token pass
info Run a command that intepretes the request for an entire tree.
info The pass program defined here will get called for all
info requests below a certain point in the mib tree. It is then
info responsible for returning the right data beyond that point.
info #
info arguments: miboid program
info #
info example: pass .1.3.6.1.4.1.2021.255 /path/to/local/passtest
info #
info See the snmpd.conf manual page for further information.
info #
info Consider using "pass_persist" for a performance increase.
question 1 The OID where the script should take control of
question 2 The path to the program that should be called
token pass_persist
info Run a persistant process that intepretes the request for an entire tree.
info The pass program defined here will get called for all
info requests below a certain point in the mib tree. It is then
info responsible for returning the right data beyond that point.
info The pass_persist scripts must be able to stay running and accept input
info from stdin.
info #
info arguments: miboid program
info #
info example: pass_persist .1.3.6.1.4.1.2021.255 /path/to/local/pass_persisttest
info #
info See the snmpd.conf manual page for further information.
steal pass
token proxy
info Proxy requests to an external agent running somewhere else
info This passes all requests for a certain point of the mib tree to
info an external agent using snmp requests and then returning the
info results to the caller that spoke to our agent.
info arguments: [snmpcmd args] host oid [remoteoid]
question 1 Enter the "snmpcmd" arguments that specify how to talk to the remote host
question 2 The host you want to pass the requests to
qusetion 3 The oid that we should pass beyond
question 4 The oid of the remote site that we should talk to if different from $3
token sh
info run a simple command using system()
info arguments: [oid] name command arguments
info similar to exec, but implemented using system() instead of exec()
info #
info For security reasons, exec should be preferred.
steal exec
token dlmod
info dynamically extend the agent using a shared-object
info arguments: module-name module-path
question 1 Enter the name of the module
question 2 Enter the path to the $1 module