Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

snmp_target_mib (3erl)

Name

snmp_target_mib - MIB

Synopsis

Please see following description for synopsis

Description

snmp_target_mib(3)         Erlang Module Definition         snmp_target_mib(3)



NAME
       snmp_target_mib - Instrumentation Functions for SNMP-TARGET-MIB

DESCRIPTION
       The module snmp_target_mib implements the instrumentation functions for
       the SNMP-TARGET-MIB, and functions for configuring the database.

       The configuration files are described in the SNMP User's Manual.

       Legacy API  functions  add_addr/10  that  does  not  specify  transport
       domain,  and  add_addr/11  that  has got separate IpAddr and PortNumber
       arguments still work as before for backwards compatibility reasons.

DATA TYPES
       See the  data types in snmpa_conf.

EXPORTS
       configure(ConfDir) -> void()

              Types:

                 ConfDir = string()

              This function is called from the supervisor at system start-up.

              Inserts all data in the configuration files  into  the  database
              and  destroys  all  old rows with StorageType volatile. The rows
              created from the configuration file will have  StorageType  non-
              Volatile.

              All snmp counters are set to zero.

              If  an  error is found in the configuration file, it is reported
              using the function config_err/2 of the error report module,  and
              the function fails with the reason configuration_error.

              ConfDir is a string which points to the directory where the con-
              figuration files are found.

              The configuration files  read  are:  target_addr.conf  and  tar-
              get_params.conf.

       reconfigure(ConfDir) -> void()

              Types:

                 ConfDir = string()

              Inserts  all  data  in the configuration files into the database
              and destroys all old data, including the rows  with  StorageType
              nonVolatile.  The  rows created from the configuration file will
              have StorageType nonVolatile.

              Thus, the data in the SNMP-TARGET-MIB, after this  function  has
              been called, is the data from the configuration files.

              All snmp counters are set to zero.

              If  an  error is found in the configuration file, it is reported
              using the function config_err/2 of the , and the function  fails
              with the reason configuration_error.

              ConfDir is a string which points to the directory where the con-
              figuration files are found.

              The configuration files  read  are:  target_addr.conf  and  tar-
              get_params.conf.

       set_target_engine_id(TargetAddrName, EngineId) -> boolean()

              Types:

                 TargetAddrName = string()
                 EngineId = string()

              Changes  the  engine id for a target in the snmpTargetAddrTable.
              If notifications are sent as Inform requests to  a  target,  its
              engine id must be set.

       add_addr(Name, Domain, Addr, Timeout, Retry, TagList, Params, EngineId,
       TMask, MMS) -> Ret

              Types:

                 Name = string()
                 Domain = transportDomain()
                 Addr = transportAddress() % Default port is 162
                 Timeout = integer()
                 Retry = integer()
                 TagList = string()
                 ParamsName = string()
                 EngineId = string()
                 TMask = transportAddressMask() % Depends on Domain
                 MMS = integer()
                 Ret = {ok, Key} | {error, Reason}
                 Key = term()
                 Reason = term()

              Adds a target address definition to the agent config. Equivalent
              to one line in the target_addr.conf file.

       delete_addr(Key) -> Ret

              Types:

                 Key = term()
                 Ret = ok | {error, Reason}
                 Reason = term()

              Delete a target address definition from the agent config.

       add_params(Name, MPModel, SecModel, SecName, SecLevel) -> Ret

              Types:

                 Name = string()
                 MPModel = v1 | v2c | v3
                 SecModel = v1 | v2c | usm
                 SecName = string()
                 SecLevel = noAuthNoPriv | authNoPriv | authPriv
                 Ret = {ok, Key} | {error, Reason}
                 Key = term()
                 Reason = term()

              Adds  a target parameter definition to the agent config. Equiva-
              lent to one line in the target_params.conf file.

       delete_params(Key) -> Ret

              Types:

                 Key = term()
                 Ret = ok | {error, Reason}
                 Reason = term()

              Delete a target parameter definition from the agent config.



Ericsson AB                        snmp 5.11                snmp_target_mib(3)