snmpa (snmp v5.20.1)

Changes the log size of the Audit Trail Log. The application must be configured to use the audit trail log function. Please refer to disk_log(3) in Kernel Reference Manual for a description of how to change the log size.

convert_config(OldConfig)

This off-line utility function can be used to convert the old snmp application config (pre snmp-4.0) to the new snmp agent config (as of snmp-4.0).

current_address()

Get the address of the request currently being processed by the agent.

current_community()

Get the community of the request currently being processed by the agent.

current_context()

Get the context of the request currently being processed by the agent.

current_request_id()

Get the request-id of the request currently being processed by the agent.

del_agent_caps(Index)

This function can be used to delete an AGENT-CAPABILITY statement to the sysORTable in the agent. This table is defined in the SNMPv2-MIB.

disable_mibs_cache()

disable_mibs_cache(Agent)

Disable the mib server cache.

disable_mibs_cache_autogc()

disable_mibs_cache_autogc(Agent)

Disable automatic gc of the mib server cache.

discovery(TargetName, Notification)

discovery/3

discovery/4

discovery(TargetName, Notification, ContextName, Varbinds, DiscoHandler)

discovery(TargetName, Notification, ContextName, Varbinds, DiscoHandler, ExtraInfo)

Initiate the discovery process with the manager identified by TargetName using the notification Notification.

enable_mibs_cache()

enable_mibs_cache(Agent)

Enable the mib server cache.

enable_mibs_cache_autogc()

enable_mibs_cache_autogc(Agent)

Enable automatic gc of the mib server cache.

enum_to_int(Name, Enum)

enum_to_int(Db, Name, Enum)

Converts the symbolic value Enum to the corresponding integer of the enumerated object or type Name in a MIB. The MIB must be loaded.

gc_mibs_cache()

gc_mibs_cache/1

gc_mibs_cache/2

gc_mibs_cache(Agent, Age, GcLimit)

Perform mib server cache gc.

get(Agent, Vars)

get(Agent, Vars, Context)

Performs a GET operation on the agent. All loaded MIB objects are visible in this operation. The agent calls the corresponding instrumentation functions just as if it was a GET request coming from a manager.

get_agent_caps()

Returns all AGENT-CAPABILITY statements in the sysORTable in the agent. This table is defined in the SNMPv2-MIB.

get_next(Agent, Vars)

get_next(Agent, Vars, Context)

Performs a GET-NEXT operation on the agent. All loaded MIB objects are visible in this operation. The agent calls the corresponding instrumentation functions just as if it was a GET request coming from a manager.

info()

info(Agent)

Returns a list (a dictionary) containing information about the agent. Information includes loaded MIBs, registered sub-agents, some information about the memory allocation.

int_to_enum(Name, Int)

int_to_enum(Db, Name, Int)

Converts the integer Int to the corresponding symbolic value of the enumerated object or type Name in a MIB. The MIB must be loaded.

invalidate_mibs_cache()

invalidate_mibs_cache(Agent)

Invalidate the mib server cache.

load_mib(Mib)

load_mib(Agent, Mib)

Load a single Mib into an agent. The MibName is the name of the Mib, including the path to where the compiled mib is found. For example

load_mibs(Mibs)

load_mibs/2

load_mibs(Agent, Mibs, Force)

Load Mibs into an agent. If the agent cannot load all MIBs (the default value of the Force argument is false), it will indicate where loading was aborted. The MibName is the name of the Mib, including the path to where the compiled mib is found. For example,

log_to_io(LogDir)

log_to_io/2

log_to_io/3

log_to_io/4

log_to_io/5

log_to_io/6

log_to_io(LogDir, Mibs, LogName, LogFile, Block, Start, Stop)

Converts an Audit Trail Log to a readable format and prints it on stdio. LogName defaults to "snmpa_log". LogFile defaults to "snmpa.log".

log_to_txt(LogDir)

log_to_txt/2

log_to_txt/3

log_to_txt/4

log_to_txt/5

log_to_txt/6

log_to_txt/7

log_to_txt(LogDir, Mibs, OutFile, LogName, LogFile, Block, Start, Stop)

Converts an Audit Trail Log to a readable text file. OutFile defaults to "./snmpa_log.txt". LogName defaults to "snmpa_log". LogFile defaults to "snmpa.log".

me_of(Oid)

me_of(Agent, Oid)

Finds the mib entry corresponding to the Oid.

mib_of(Oid)

mib_of(Agent, Oid)

Finds the mib corresponding to the Oid.

name_to_oid(Name)

name_to_oid(Db, Name)

Looks up the OBJECT IDENTIFIER of a MIB object, given the symbolic name. Note, the OBJECT IDENTIFIER is given for the object, not for an instance.

oid_to_name(Oid)

oid_to_name(Db, Oid)

Looks up the symbolic name of a MIB object, given OBJECT IDENTIFIER.

print_mib_info()

Prints the content of all the (snmp) tables and variables for all mibs handled by the snmp agent.

print_mib_tables()

Prints the content of all the (snmp) tables for all mibs handled by the snmp agent.

print_mib_variables()

Prints the content of all the (snmp) variables for all mibs handled by the snmp agent.

register_notification_filter(Id, Mod, Data)

register_notification_filter/4

register_notification_filter(Agent, Id, Mod, Data, Where)

Registers a notification filter.

register_subagent(Agent, SubTree, SubAgent)

Registers a sub-agent under a sub-tree of another agent.

restart_set_worker()

restart_set_worker(Agent)

Restart the set worker process of a multi-threaded agent.

restart_worker()

restart_worker(Agent)

Restart the worker process of a multi-threaded agent.

send_notification2(Agent, Notification, SendOpts)

Send the notification Notification to the management targets defined for notify-name (name) in the snmpNotifyTable in SNMP-NOTIFICATION-MIB from the specified context.

send_notification(Agent, Notification, Receiver)

send_notification(Agent, Notification, Receiver, Varbinds)

send_notification(Agent, Notification, Receiver, NotifyName, Varbinds)

send_notification(Agent, Notification, Receiver, NotifyName, ContextName, Varbinds)

send_notification(Agent, Notification, Receiver, NotifyName, ContextName, Varbinds, LocalEngineID)

Sends the notification Notification to the management targets defined for NotifyName in the snmpNotifyTable in SNMP-NOTIFICATION-MIB from the specified context.

set_log_type(NewType)

set_log_type(Agent, NewType)

Changes the run-time Audit Trail log type.

set_request_limit(NewLimit)

set_request_limit(Agent, NewLimit)

Changes the request limit.

unload_mib(Mib)

unload_mib(Agent, Mib)

Unload a single Mib from an agent.

unload_mibs(Mibs)

unload_mibs/2

unload_mibs(Agent, Mibs, Force)

Unload Mibs from an agent. If it cannot unload all MIBs (the default value of the Force argument is false), it will indicate where unloading was aborted.

unregister_notification_filter(Id)

unregister_notification_filter(Agent, Id)

Unregister a notification filter.

unregister_subagent(Agent, SubAgentOidOrPid)

Unregister a sub-agent. If the second argument is a pid, then that sub-agent will be unregistered from all trees in Agent.

update_mibs_cache_age(Age)

update_mibs_cache_age(Agent, Age)

Change the mib server cache age property.

update_mibs_cache_gclimit(GcLimit)

update_mibs_cache_gclimit(Agent, GcLimit)

Change the mib server cache gclimit property.

verbosity(Target, Verbosity)

Sets 'verbosity' for the indicated process(s)

whereis_mib(MibName)

whereis_mib(Agent, MibName)

Get the full path to the (compiled) mib-file.

which_aliasnames()

Retrieve all alias-names known to the agent.

which_mibs()

which_mibs(Agent)

Retrieve the list of all the mibs loaded into this agent. Default is the master agent.

which_mibs_cache_size()

which_mibs_cache_size(Agent)

Retrieve the size of the mib server cache.

which_notification_filter()

which_notification_filter(Agent)

List all notification filters in an agent.

which_notifications()

Retrieve all notifications (and traps) known to the agent.

which_tables()

Retrieve all tables known to the agent.

which_transports()

Retrieve all configured transports.

which_variables()

Retrieve all variables known to the agent.

Types

db()

-type db() :: volatile | persistent | mnesia.

discovery_handler()

-type discovery_handler() :: module().

Module implementing the snmpa_discovery_handler behaviour.

me()

-type me() :: snmp:me().

mib_storage()

-type mib_storage() :: [mib_storage_opt()].

mib_storage_module()

-type mib_storage_module() :: atom().

mib_storage_opt()

-type mib_storage_opt() :: {module, mib_storage_module()} | {options, mib_storage_options()}.

mib_storage_options()

-type mib_storage_options() :: list().

name()

-type name() :: table_name() | variable_name().

name_db()

-type name_db() :: {name(), db()}.

nfilter_id()

-type nfilter_id() :: term().

nfilter_position()

-type nfilter_position() :: first | last | {insert_before, nfilter_id()} | {insert_after, nfilter_id()}.

notification_delivery_info()

-type notification_delivery_info() ::
          snmpa_notification_delivery_info_receiver:notification_delivery_info().

How shall (notification) delivery info be reported.

pdu_type()

-type pdu_type() :: snmp:pdu_type().

table_name()

-type table_name() :: atom().

transport_kind()

-type transport_kind() :: req_responder | trap_sender.

variable_name()

-type variable_name() :: atom().

Functions

add_agent_caps(Oid :: snmp:oid(), Descr :: string()) -> Index

Types

Index = integer()

This function can be used to add an AGENT-CAPABILITY statement to the sysORTable in the agent. The table is defined in the SNMPv2-MIB.

backup(BackupDir) ≡ backup/2

backup(Agent, BackupDir) -> Result

Types

Agent = pid() | AgentName

BackupDir = string()

Result = ok | {error, Reason}

Reason = backup_in_progress | term()

AgentName = atom()

Backup persistent/permanent data handled by the agent (such as local-db, mib-data and vacm).

Data stored by mnesia is not handled.

BackupDir cannot be identical to DbDir.

Simultaneous backup calls are not allowed. That is, two different processes cannot simultaneously successfully call this function. One of them will be first, and succeed. The second will fail with the error reason backup_in_progress.

change_log_size(NewSize :: snmp:log_size()) -> Result

Types

Result = ok | {error, Reason}

Reason = term()

The change is permanent, as long as the log is not deleted. That means, the log size is remembered across reboots.

convert_config(OldConfig :: list()) -> NewConfig

Types

OldConfig = NewConfig = list()

This off-line utility function can be used to convert the old snmp application config (pre snmp-4.0) to the new snmp agent config (as of snmp-4.0).

For information about the old config (OldConfig) see the OTP R9C documentation.

For information about the current agent config (AgentConfig), see the Configuring the application chapter of the SNMP user's guide.

current_address() -> Result

Types

Result = {value, Address} | false

Address = term()

Get the address of the request currently being processed by the agent.

Note that this function is intended to be called by the instrumentation functions and only if it is executed in the context of the agent process (e.g. it does not work if called from a spawned process).

current_community() -> Result

Types

Result = {value, Community} | false

Community = snmp_community_mib:name()

Get the community of the request currently being processed by the agent.

current_context() -> Result

Types

Result = {value, Context} | false

Context = snmp_community_mib:context_name()

Get the context of the request currently being processed by the agent.

current_request_id() -> Result

Types

Result = {value, RequestId} | false

RequestId = integer()

Get the request-id of the request currently being processed by the agent.

del_agent_caps(Index :: integer()) -> snmp:void()

This function can be used to delete an AGENT-CAPABILITY statement to the sysORTable in the agent. This table is defined in the SNMPv2-MIB.

disable_mibs_cache() ≡ disable_mibs_cache/1

disable_mibs_cache(Agent :: pid() | AgentName) -> snmp:void()

Types

AgentName = atom()

Disable the mib server cache.

disable_mibs_cache_autogc() ≡ disable_mibs_cache_autogc/1

disable_mibs_cache_autogc(Agent :: pid() | AgentName) -> snmp:void()

Types

AgentName = atom()

Disable automatic gc of the mib server cache.

discovery(TargetName, Notification) ≡ discovery/6

discovery/3 ≡ discovery/6

discovery/4 ≡ discovery/6

discovery(TargetName, Notification, ContextName, Varbinds, DiscoHandler) ≡ discovery/6

discovery(TargetName, Notification, ContextName, Varbinds, DiscoHandler, ExtraInfo)

-spec discovery(TargetName, Notification) -> {ok, ManagerEngineID} | {error, Reason}
                   when
                       TargetName :: string(),
                       Notification :: atom(),
                       ManagerEngineID :: snmp_framework_mib:engine_id(),
                       Reason :: term().

-spec discovery(TargetName, Notification, Varbinds) -> {ok, ManagerEngineID} | {error, Reason}
                   when
                       TargetName :: string(),
                       Notification :: atom(),
                       Varbinds :: [Varbind],
                       Varbind ::
                           {Variable :: atom(), Value} |
                           {OID :: snmp:oid(), Value} |
                           {Column :: atom(), RowIndex :: snmp:row_index(), Value},
                       Value :: term(),
                       ManagerEngineID :: snmp_framework_mib:engine_id(),
                       Reason :: term();
               (TargetName, Notification, ContextName) -> {ok, ManagerEngineID} | {error, Reason}
                   when
                       TargetName :: string(),
                       Notification :: atom(),
                       ContextName :: snmp_community_mib:context_name(),
                       ManagerEngineID :: snmp_framework_mib:engine_id(),
                       Reason :: term().

-spec discovery(TargetName, Notification, ContextName, Varbinds) ->
                   {ok, ManagerEngineID} | {error, Reason}
                   when
                       TargetName :: string(),
                       Notification :: atom(),
                       ContextName :: snmp_community_mib:context_name(),
                       Varbinds :: [Varbind],
                       Varbind :: {Variable, Value} | {Column, RowIndex, Value} | {OID, Value},
                       Variable :: atom(),
                       Column :: atom(),
                       RowIndex :: snmp:row_index(),
                       OID :: snmp:oid(),
                       Value :: term(),
                       ManagerEngineID :: snmp_framework_mib:engine_id(),
                       Reason :: term();
               (TargetName, Notification, Varbinds, DiscoHandler) ->
                   {ok, ManagerEngineID} | {error, Reason}
                   when
                       TargetName :: string(),
                       Notification :: atom(),
                       Varbinds :: [Varbind],
                       Varbind :: {Variable, Value} | {Column, RowIndex, Value} | {OID, Value},
                       Variable :: atom(),
                       Column :: atom(),
                       RowIndex :: snmp:row_index(),
                       OID :: snmp:oid(),
                       Value :: term(),
                       DiscoHandler :: discovery_handler(),
                       ManagerEngineID :: snmp_framework_mib:engine_id(),
                       Reason :: term().

-spec discovery(TargetName, Notification, ContextName, Varbinds, DiscoHandler) ->
                   {ok, ManagerEngineID} | {error, Reason}
                   when
                       TargetName :: string(),
                       Notification :: atom(),
                       ContextName :: snmp_community_mib:context_name(),
                       Varbinds :: [Varbind],
                       Varbind :: {Variable, Value} | {Column, RowIndex, Value} | {OID, Value},
                       Variable :: atom(),
                       Column :: atom(),
                       RowIndex :: snmp:row_index(),
                       OID :: snmp:oid(),
                       Value :: term(),
                       DiscoHandler :: discovery_handler(),
                       ManagerEngineID :: snmp_framework_mib:engine_id(),
                       Reason :: term().

-spec discovery(TargetName, Notification, ContextName, Varbinds, DiscoHandler, ExtraInfo) ->
                   {ok, ManagerEngineID} | {error, Reason}
                   when
                       TargetName :: string(),
                       Notification :: atom(),
                       ContextName :: snmp_community_mib:context_name(),
                       Varbinds :: [Varbind],
                       Varbind :: {Variable, Value} | {Column, RowIndex, Value} | {OID, Value},
                       Variable :: atom(),
                       Column :: atom(),
                       RowIndex :: snmp:row_index(),
                       OID :: snmp:oid(),
                       Value :: term(),
                       DiscoHandler :: discovery_handler(),
                       ExtraInfo :: term(),
                       ManagerEngineID :: snmp_framework_mib:engine_id(),
                       Reason :: term().

Initiate the discovery process with the manager identified by TargetName using the notification Notification.

This function is synchronous, which means that it will return when the discovery process has been completed or failed.

The DiscoHandler module is used during the discovery process. See discovery handler for more info.

The ExtraInfo argument is passed on to the callback functions of the DiscoHandler.

Note

If we are not at security-level noAuthNoPriv, this could be complicated, since the agent will then continue with stage 2, before which the usm-related updates must be done.

Note

The default discovery handler will require additional actions by the caller and the discovery will not work if the security-level is higher then noAuthNoPriv.

enable_mibs_cache() ≡ enable_mibs_cache/1

enable_mibs_cache(Agent :: pid() | AgentName) -> snmp:void()

Types

AgentName = atom()

Enable the mib server cache.

enable_mibs_cache_autogc() ≡ enable_mibs_cache_autogc/1

enable_mibs_cache_autogc(Agent :: pid() | AgentName) -> snmp:void()

Types

AgentName = atom()

Enable automatic gc of the mib server cache.

enum_to_int(Name, Enum) ≡ enum_to_int/3

enum_to_int(Db, Name, Enum) -> Result

Types

Db = term()

Name = Enum = atom()

Result = {value, Int} | false

Int = integer()

Converts the symbolic value Enum to the corresponding integer of the enumerated object or type Name in a MIB. The MIB must be loaded.

false is returned if the object or type is not defined in any loaded MIB, or if it does not define the symbolic value as enumerated.

Db is a reference to the symbolic store database (retrieved by a call to get_symbolic_store_db/0).

gc_mibs_cache() ≡ gc_mibs_cache/3

gc_mibs_cache/1 ≡ gc_mibs_cache/3

gc_mibs_cache/2 ≡ gc_mibs_cache/3

gc_mibs_cache(Agent, Age, GcLimit)

-spec gc_mibs_cache() -> {ok, NumElementsGCed} | {error, Reason}
                       when NumElementsGCed :: non_neg_integer(), Reason :: term().

-spec gc_mibs_cache(Agent) -> {ok, NumElementsGCed} | {error, Reason}
                       when
                           Agent :: pid() | AgentName,
                           AgentName :: atom(),
                           NumElementsGCed :: non_neg_integer(),
                           Reason :: term();
                   (Age) -> {ok, NumElementsGCed} | {error, Reason}
                       when Age :: pos_integer(), NumElementsGCed :: non_neg_integer(), Reason :: term().

-spec gc_mibs_cache(Agent, Age) -> {ok, NumElementsGCed} | {error, Reason}
                       when
                           Agent :: pid() | AgentName,
                           AgentName :: atom(),
                           Age :: pos_integer(),
                           NumElementsGCed :: non_neg_integer(),
                           Reason :: term();
                   (Age, GcLimit) -> {ok, NumElementsGCed} | {error, Reason}
                       when
                           Age :: pos_integer(),
                           GcLimit :: pos_integer() | infinity,
                           NumElementsGCed :: non_neg_integer(),
                           Reason :: term().

-spec gc_mibs_cache(Agent, Age, GcLimit) -> {ok, NumElementsGCed} | {error, Reason}
                       when
                           Agent :: pid() | AgentName,
                           AgentName :: atom(),
                           Age :: pos_integer(),
                           GcLimit :: pos_integer() | infinity,
                           NumElementsGCed :: non_neg_integer(),
                           Reason :: term().

Perform mib server cache gc.

Manually performs a mib server cache gc. This can be done regardless of the value of the autogc option. The NumElementsGCed value indicates how many elements where actually removed from the cache.

get(Agent, Vars) ≡ get/3

get(Agent, Vars, Context) -> Result

Types

Agent = pid() | AgentName

Vars = [snmp:oid()]

Context = snmp_community_mib:context_name()

Result = Values | {error, Reason}

Reason = term()

Values = [term()]

AgentName = atom()

Note that the request specific parameters (such as current_request_id/0) are not accessible for the instrumentation functions if this function is used.

get_agent_caps() -> Caps

Types

Caps = [[Cap]]

Cap = SysORIndex | SysORID | SysORDescr | SysORUpTime

SysORIndex = SysORUpTime = integer()

SysORID = snmp:oid()

SysORDescr = string()

Returns all AGENT-CAPABILITY statements in the sysORTable in the agent. This table is defined in the SNMPv2-MIB.

Note that the Erlang type language do not permit us to properly describe what this function returns. The exact return is:

[[SysORIndex, SysORID, SysORDescr, SysORUpTime]]

get_next(Agent, Vars) ≡ get_next/3

get_next(Agent, Vars, Context) -> Result

Types

Agent = pid() | AgentName

Vars = [snmp:oid()]

Context = snmp_community_mib:context_name()

Result = Values | {error, Reason}

Reason = {atom(), snmp:oid()}

Values = [{snmp:oid(), term()}]

AgentName = atom()

Note that the request specific parameters (such as snmpa:current_request_id/0 are not accessible for the instrumentation functions if this function is used.

info() ≡ info/1

info(Agent :: pid() | AgentName) -> Info

Types

Info = [{Key, Value}]

Key = Value = term()

AgentName = atom()

Returns a list (a dictionary) containing information about the agent. Information includes loaded MIBs, registered sub-agents, some information about the memory allocation.

int_to_enum(Name, Int) ≡ int_to_enum/3

int_to_enum(Db, Name, Int) -> Result

Types

Db = term()

Name = Enum = atom()

Int = integer()

Result = {value, Enum} | false

Converts the integer Int to the corresponding symbolic value of the enumerated object or type Name in a MIB. The MIB must be loaded.

false is returned if the object or type is not defined in any loaded MIB, or if it does not define the symbolic value as enumerated.

Db is a reference to the symbolic store database (retrieved by a call to get_symbolic_store_db/0).

invalidate_mibs_cache() ≡ invalidate_mibs_cache/1

invalidate_mibs_cache(Agent :: pid() | AgentName) -> snmp:void()

Types

AgentName = atom()

Invalidate the mib server cache.

The entire contents of the cache will be deleted.

load_mib(Mib) ≡ load_mib/2

(since OTP R16B02)

load_mib(Agent :: pid() | AgentName, Mib :: string()) -> Result

(since OTP R16B02)

Types

Result = ok | {error, Reason}

Reason = already_loaded | term()

AgentName = atom()

Load a single Mib into an agent. The MibName is the name of the Mib, including the path to where the compiled mib is found. For example:

          Dir = code:priv_dir(my_app) ++ "/mibs/",
          snmpa:load_mib(snmp_master_agent, Dir ++ "MY-MIB").

load_mibs(Mibs) ≡ load_mibs/3

load_mibs/2 ≡ load_mibs/3

load_mibs(Agent, Mibs, Force)

(since OTP R16B02)

-spec load_mibs(Mibs) -> ok | {error, Reason}
                   when
                       Mibs :: [MibName],
                       MibName :: string(),
                       Reason :: {'load aborted at', MibName, InternalReason},
                       InternalReason :: already_loaded | term().

-spec load_mibs(Agent, Mibs) -> ok | {error, Reason}
                   when
                       Agent :: pid() | AgentName,
                       AgentName :: atom(),
                       Mibs :: [MibName],
                       MibName :: string(),
                       Reason :: {'load aborted at', MibName, InternalReason},
                       InternalReason :: already_loaded | term();
               (Mibs, Force) -> ok | {error, Reason}
                   when
                       Mibs :: [MibName],
                       MibName :: string(),
                       Force :: boolean(),
                       Reason :: {'load aborted at', MibName, InternalReason},
                       InternalReason :: already_loaded | term().

-spec load_mibs(Agent, Mibs, Force) -> ok | {error, Reason}
                   when
                       Agent :: pid() | AgentName,
                       AgentName :: atom(),
                       Mibs :: [MibName],
                       MibName :: string(),
                       Force :: boolean(),
                       Reason :: {'load aborted at', MibName, InternalReason},
                       InternalReason :: already_loaded | term().

          Dir = code:priv_dir(my_app) ++ "/mibs/",
          snmpa:load_mibs(snmp_master_agent, [Dir ++ "MY-MIB"]).

If Force = true then the agent will continue attempting to load each mib even after failing to load a previous mib. Use with care.

log_to_io(LogDir) ≡ log_to_io/7

(since OTP R15B01)

log_to_io/2 ≡ log_to_io/7

(since OTP R15B01)

log_to_io/3 ≡ log_to_io/7

(since OTP R15B01)

log_to_io/4 ≡ log_to_io/7

(since OTP R15B01)

log_to_io/5 ≡ log_to_io/7

(since OTP R15B01)

log_to_io/6 ≡ log_to_io/7

(since OTP R15B01)

log_to_io(LogDir, Mibs, LogName, LogFile, Block, Start, Stop)

(since OTP R16B03)

-spec log_to_io(LogDir) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term().

-spec log_to_io(LogDir, Block) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Block :: boolean(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term();
               (LogDir, Mibs) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term().

-spec log_to_io(LogDir, Mibs, Block) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       Block :: boolean(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term();
               (LogDir, Mibs, LogName) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term().

-spec log_to_io(LogDir, Mibs, LogName, Block) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       Block :: boolean(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term();
               (LogDir, Mibs, LogName, LogFile) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       LogFile :: string(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term().

-spec log_to_io(LogDir, Mibs, LogName, LogFile, Block) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       LogFile :: string(),
                       Block :: boolean(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term();
               (LogDir, Mibs, LogName, LogFile, Start) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       LogFile :: string(),
                       Start :: null | snmp:log_time(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term().

-spec log_to_io(LogDir, Mibs, LogName, LogFile, Block, Start) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       LogFile :: string(),
                       Block :: boolean(),
                       Start :: null | snmp:log_time(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term();
               (LogDir, Mibs, LogName, LogFile, Start, Stop) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       LogFile :: string(),
                       Start :: null | snmp:log_time(),
                       Stop :: null | snmp:log_time(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term().

-spec log_to_io(LogDir, Mibs, LogName, LogFile, Block, Start, Stop) -> ok | {ok, Cnt} | {error, Reason}
                   when
                       LogDir :: string(),
                       Mibs :: [snmp:mib_name()],
                       LogName :: string(),
                       LogFile :: string(),
                       Block :: boolean(),
                       Start :: null | snmp:log_time(),
                       Stop :: null | snmp:log_time(),
                       Cnt :: {NumOK, NumERR},
                       NumOK :: non_neg_integer(),
                       NumERR :: pos_integer(),
                       Reason :: term().

Converts an Audit Trail Log to a readable format and prints it on stdio. LogName defaults to "snmpa_log". LogFile defaults to "snmpa.log".

The Block option indicates if the log should be blocked during conversion. This could be useful when converting large logs (when otherwise the log could wrap during conversion). Defaults to true.

See snmp:log_to_io/7 for more info.

log_to_txt(LogDir) ≡ log_to_txt/8

(since OTP R15B01)

log_to_txt/2 ≡ log_to_txt/8

log_to_txt/3 ≡ log_to_txt/8

log_to_txt/4 ≡ log_to_txt/8

log_to_txt/5 ≡ log_to_txt/8

log_to_txt/6 ≡ log_to_txt/8

log_to_txt/7 ≡ log_to_txt/8

log_to_txt(LogDir, Mibs, OutFile, LogName, LogFile, Block, Start, Stop)

(since OTP R16B03)

-spec log_to_txt(LogDir) -> snmp:void() when LogDir :: snmp:dir().

-spec log_to_txt(LogDir, Block) -> snmp:void() when LogDir :: snmp:dir(), Block :: boolean();
                (LogDir, Mibs) -> snmp:void() when LogDir :: snmp:dir(), Mibs :: [snmp:mib_name()].

-spec log_to_txt(LogDir, Mibs, Block) -> snmp:void()
                    when LogDir :: snmp:dir(), Mibs :: [snmp:mib_name()], Block :: boolean();
                (LogDir, Mibs, OutFile) -> snmp:void()
                    when LogDir :: snmp:dir(), Mibs :: [snmp:mib_name()], OutFile :: file:filename().

-spec log_to_txt(LogDir, Mibs, OutFile, Block) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        Block :: boolean();
                (LogDir, Mibs, OutFile, LogName) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        LogName :: string().

-spec log_to_txt(LogDir, Mibs, OutFile, LogName, Block) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        LogName :: string(),
                        Block :: boolean();
                (LogDir, Mibs, OutFile, LogName, LogFile) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        LogName :: string(),
                        LogFile :: string().

-spec log_to_txt(LogDir, Mibs, OutFile, LogName, LogFile, Block | Start) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        LogName :: string(),
                        LogFile :: string(),
                        Block :: boolean(),
                        Start :: null | snmp:log_time().

-spec log_to_txt(LogDir, Mibs, OutFile, LogName, LogFile, Block, Start) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        LogName :: string(),
                        LogFile :: string(),
                        Block :: boolean(),
                        Start :: null | snmp:log_time();
                (LogDir, Mibs, OutFile, LogName, LogFile, Start, Stop) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        LogName :: string(),
                        LogFile :: string(),
                        Start :: null | snmp:log_time(),
                        Stop :: null | snmp:log_time().

-spec log_to_txt(LogDir, Mibs, OutFile, LogName, LogFile, Block, Start, Stop) -> snmp:void()
                    when
                        LogDir :: snmp:dir(),
                        Mibs :: [snmp:mib_name()],
                        OutFile :: file:filename(),
                        LogName :: string(),
                        LogFile :: string(),
                        Block :: boolean(),
                        Start :: null | snmp:log_time(),
                        Stop :: null | snmp:log_time().

Converts an Audit Trail Log to a readable text file. OutFile defaults to "./snmpa_log.txt". LogName defaults to "snmpa_log". LogFile defaults to "snmpa.log".

The Block option indicates if the log should be blocked during conversion. This could be useful when converting large logs (when otherwise the log could wrap during conversion). Defaults to true.

See snmp:log_to_txt/8 for more info.

me_of(Oid) ≡ me_of/2

me_of(Agent, Oid) -> Result

Types

Agent = pid() | AgentName

Oid = snmp:oid()

Result = {ok, Me} | {error, Reason}

Reason = term()

AgentName = atom()

Me = snmp:me()

Finds the mib entry corresponding to the Oid.

If it is a variable, the Oid must be <Oid for var>.0 and if it is a table, Oid must be <table>.<entry>.<col>.<any>

mib_of(Oid) ≡ mib_of/2

mib_of(Agent, Oid) -> Result

Types

Agent = pid() | AgentName

Oid = snmp:oid()

Result = {ok, MibName} | {error, Reason}

Reason = term()

MibName = AgentName = atom()

Finds the mib corresponding to the Oid.

If it is a variable, the Oid must be <Oid for var>.0 and if it is a table, Oid must be <table>.<entry>.<col>.<any>.

name_to_oid(Name) ≡ name_to_oid/2

name_to_oid(Db :: term(), Name :: atom()) -> Result

Types

Result = {value, Oid} | false

Oid = snmp:oid()

Looks up the OBJECT IDENTIFIER of a MIB object, given the symbolic name. Note, the OBJECT IDENTIFIER is given for the object, not for an instance.

false is returned if the object is not defined in any loaded MIB.

Db is a reference to the symbolic store database (retrieved by a call to get_symbolic_store_db/0).

oid_to_name(Oid) ≡ oid_to_name/2

oid_to_name(Db :: term(), Oid :: snmp:oid()) -> Result

Types

Result = {value, Name} | false

Name = atom()

Looks up the symbolic name of a MIB object, given OBJECT IDENTIFIER.

false is returned if the object is not defined in any loaded MIB.

Db is a reference to the symbolic store database (retrieved by a call to get_symbolic_store_db/0).

print_mib_info() -> snmp:void()

(since OTP R14B02)

Prints the content of all the (snmp) tables and variables for all mibs handled by the snmp agent.

print_mib_tables() -> snmp:void()

(since OTP R14B02)

Prints the content of all the (snmp) tables for all mibs handled by the snmp agent.

print_mib_variables() -> snmp:void()

(since OTP R14B02)

Prints the content of all the (snmp) variables for all mibs handled by the snmp agent.

register_notification_filter(Id, Mod, Data) ≡ register_notification_filter/5

register_notification_filter/4 ≡ register_notification_filter/5

register_notification_filter(Agent, Id, Mod, Data, Where) -> Result

Types

Agent = pid() | AgentName

Id = nfilter_id()

Mod = module()

Data = Reason = term()

Where = nfilter_position()

Result = ok | {error, Reason}

AgentName = atom()

Registers a notification filter.

Mod is a module implementing the snmpa_notification_filter behaviour.

Data will be passed on to the filter when calling the functions of the behaviour.

register_subagent(Agent, SubTree, SubAgent) -> Result

Types

Agent = pid() | AgentName

SubTree = snmp:oid()

SubAgent = pid()

Result = ok | {error, Reason}

Reason = term()

AgentName = atom()

Registers a sub-agent under a sub-tree of another agent.

It is easy to make mistakes when registering sub-agents and this activity should be done carefully. For example, a strange behaviour would result from the following configuration:

snmp_agent:register_subagent(MAPid,[1,2,3,4],SA1),
snmp_agent:register_subagent(SA1,[1,2,3], SA2).

SA2 will not get requests starting with object identifier [1,2,3] since SA1 does not.

restart_set_worker() ≡ restart_set_worker/1

restart_set_worker(Agent :: pid | AgentName) -> snmp:void()

Types

AgentName = atom()

Restart the set worker process of a multi-threaded agent.

This is a utility function, that can be useful when e.g. debugging instrumentation functions.

restart_worker() ≡ restart_worker/1

restart_worker(Agent :: pid | AgentName) -> snmp:void()

Types

AgentName = atom()

Restart the worker process of a multi-threaded agent.

This is a utility function, that can be useful when e.g. debugging instrumentation functions.

send_notification2(Agent, Notification, SendOpts) -> snmp:void()

(since OTP R14B03)

Types

Agent = pid() | AgentName

Notification = Func = Column = Variable = AgentName = atom()

SendOpts = [SendOpt]

Value = Tag = term()

Mod = module()

Args = list()

Oid = snmp:oid()

RowIndex = snmp:row_index()

Varbind = {Variable, Value} | {Column, RowIndex, Value} | {Oid, Value}

SendOpt = {receiver, Receiver} |
          {name, snmp_notification_mib:notify_name()} |
          {context, snmp_community_mib:context_name()} |
          {varbinds, [Varbind]} |
          {local_engine_id, snmp_framework_mib:engine_id()} |
          {extra, term()}

Receiver = no_receiver | {Tag, Recv} | notification_delivery_info()

Recv = pid() | atom() | MFA

MFA = {Mod, Func, Args}

Send the notification Notification to the management targets defined for notify-name (name) in the snmpNotifyTable in SNMP-NOTIFICATION-MIB from the specified context.

If no name is specified (or if it is ""), the notification is sent to all management targets.

If no context is specified, the default context, "", is used.

The send option receiver specifies where information about delivery of Inform-Requests should be sent. The agent sends Inform-Requests and waits for acknowledgments from the management targets. The receiver can have three values:

no_receiver - No information is delivered.
notification_delivery_info/0 - The information is delivered via a function call according to this data.
{tag(), tag_receiver()} - The information is delivered either via messages or via a function call according to the value of tag_receiver().
Delivery is done differently depending on the value of tag_receiver():
- pid() | registered_name() - The info will be delivered in the following messages:
  - {snmp_targets, tag(), Addresses}
    This informs the user which target addresses the notification was sent to.
  - {snmp_notification, tag(), {got_response, Address}}
    This informs the user that this target address acknowledged the notification.
  - {snmp_notification, tag(), {no_response, Address}}
    This informs the user that this target address did not acknowledge the notification.
  The notification is sent as an Inform-Request to each target address in Addresses and if there are no targets for which an Inform-Request is sent, Addresses is the empty list [].
  The tag_receiver() will first be sent the snmp_targets message, and then for each address in Addresses list, one of the two snmp_notification messages.
- {Mod, Func, Args} - The info will be delivered via the function call:
  Mod:Func([Msg | Args])
  where Msg has the same content and purpose as the messages descrived above.

The 'process oid' "tag" that can be provided with the variable name / oids is intended to be used for oid post processing. The value 'keep', which is the default, leaves the oid as is. The value 'truncate', will cause the oid to be "truncated". That is, any trailing ".0" will be removed.

Note

There is a way to exclude a varbind from the notification. In the normal varbinds list, providing the special value '$ignore-oid' (instead of a normal value) will exclude this varbind from the notification.

A define for this has been added to the snmp_types.hrl include file, NOTIFICATION_IGNORE_VB_VALUE.

Note

The extra info is not normally interpreted by the agent, instead it is passed through to the net-if process. It is up to the implementor of that process to make use of this data.

The version of net-if provided by this application makes no use of this data, with one exception: Any tuple containing the atom snmpa_default_notification_extra_info may be used by the agent and is therefore reserved.

See the net-if incoming messages for sending a trap and notification for more info.

send_notification(Agent, Notification, Receiver) ≡ send_notification/7

send_notification(Agent, Notification, Receiver, Varbinds) ≡ send_notification/7

send_notification(Agent, Notification, Receiver, NotifyName, Varbinds) ≡ send_notification/7

send_notification(Agent, Notification, Receiver, NotifyName, ContextName, Varbinds) ≡ send_notification/7

send_notification(Agent, Notification, Receiver, NotifyName, ContextName, Varbinds, LocalEngineID) -> snmp:void()

(since OTP R14B)

Types

Agent = pid() | AgentName

Notification = Func = Column = Variable = AgentName = atom()

Receiver = no_receiver | {Tag, Recv} | notification_delivery_info()

NotifyName = snmp_notification_mib:notify_name()

ContextName = snmp_community_mib:context_name()

Varbinds = [Varbind]

LocalEngineID = snmp_framework_mib:engine_id()

Value = Tag = term()

Mod = module()

Args = list()

Oid = snmp:oid()

RowIndex = snmp:row_index()

Varbind = {Variable, Value} | {Column, RowIndex, Value} | {Oid, Value}

Recv = pid() | atom() | MFA

MFA = {Mod, Func, Args}

Sends the notification Notification to the management targets defined for NotifyName in the snmpNotifyTable in SNMP-NOTIFICATION-MIB from the specified context.

If no NotifyName is specified (or if it is ""), the notification is sent to all management targets (Addresses below).

If no ContextName is specified, the default "" context is used.

The parameter Receiver specifies where information about delivery of Inform-Requests should be sent. The agent sends Inform-Requests and waits for acknowledgments from the managers. Receiver can have three values:

no_receiver - No information is delivered.
notification_delivery_info/0 - The information is delivered via a function call according to this data.
{Tag, Recv} - The information is delivered either via messages or via a function call according to the value of Recv.

If Receiver has the value {Tag, Recv}, the delivery is done according to Recv:

pid() | atom() - The info will be delivered in the following messages:
- {snmp_targets, Tag, Addresses}
  This inform the user which target addresses the notification was sent to.
- {snmp_notification, Tag, {got_response, Address}}
  This informs the user that this target address acknowledged the notification.
- {snmp_notification, Tag, {no_response, Address}}
  This informs the user that this target address did not acknowledge notification.
The notification is sent as an Inform-Request to each target address in Addresses and if there are no targets for which an Inform-Request is sent, Addresses is the empty list [].
The receiver will first be sent the snmp_targets message, and then for each address in Addresses list, one of the two snmp_notification messages.
{Mod, Func, Args} - The info will be delivered via the function call:
Mod:Func([Msg | Args])
where Msg has the same content and purpose as the messages descrived above.

Address is a management target address and Addresses is a list of management target addresses. They are defined as followes:

        Addresses  = [address()]
        Address    = address()
        address()  = v1_address() | v3_address()
        v1_address() = {TDomain, TAddress}
        v3_address() = {{TDomain, TAddress}, V3MsgData}
        TDomain    = tdoamin()
        TAddress   = taddress()
        tdomain()  = The oid of snmpUDPDomain
                     This is the only supported transport domain.
        taddress() = [A1, A2, A3, A4, P1, P3]
                     The 4 first bytes makes up the IP-address and the last 2,
                     the UDP-port number.
        V3MsgData  = v3_msg_data()
        v3_msg_data() = term()

If Receiver is a notification_delivery_info/0 record, then the information about the notification delivery will be delivered to the receiver via the callback functions defined by the snmpa_notification_delivery_info_receiver behaviour according to the content of the notification_delivery_info/0 record.

The optional argument Varbinds defines values for the objects in the notification. If no value is given for an object, the Agent performs a get-operation to retrieve the value.

Varbinds is a list of Varbind, where each Varbind is one of:

{Variable, Value}, where Variable is the symbolic name of a scalar variable referred to in the notification specification.
{Column, RowIndex, Value}, where Column is the symbolic name of a column variable. RowIndex is a list of indices for the specified element. If this is the case, the OBJECT IDENTIFIER sent in the notification is the RowIndex appended to the OBJECT IDENTIFIER for the table column. This is the OBJECT IDENTIFIER which specifies the element.
{OID, Value}, where OID is the OBJECT IDENTIFIER for an instance of an object, scalar variable, or column variable.

For example, to specify that sysLocation should have the value "upstairs" in the notification, we could use one of:

{sysLocation, "upstairs"} or
{[1,3,6,1,2,1,1,6,0], "upstairs"} or
{?sysLocation_instance, "upstairs"} (provided that the generated .hrl file is included)

If a variable in the notification is a table element, the RowIndex for the element must be given in the Varbinds list. In this case, the OBJECT IDENTIFIER sent in the notification is the OBJECT IDENTIFIER that identifies this element. This OBJECT IDENTIFIER could be used in a get operation later.

This function is asynchronous, and does not return any information. If an error occurs, user_err/2 of the error report module is called and the notification is discarded.

Note

Note that the use of the LocalEngineID argument is only intended for special cases, if the agent is to "emulate" multiple EngineIDs! By default, the agent uses the value of SnmpEngineID (see SNMP-FRAMEWORK-MIB).

ExtraInfo is not normally used in any way by the agent. It is intended to be passed along to the net-if process, which is a component that a user can implement themself. The users own net-if may then make use of ExtraInfo. The net-if provided with this application does not process ExtraInfo.

There is one exception. Any tuple containing the atom snmpa_default_notification_extra_info will, in this context, be considered belonging to this application, and may be processed by the agent.

set_log_type(NewType) ≡ set_log_type/2

set_log_type(Agent, NewType) -> Result

Types

Agent = pid() | AgentName

NewType = OldType = snmp:atl_type()

Result = {ok, OldType} | {error, Reason}

Reason = term()

AgentName = atom()

Changes the run-time Audit Trail log type.

Note that this has no effect on the application configuration as defined by configuration files, so a node restart will revert the config to whatever is in those files.

This function is primarily useful in testing/debugging scenarios.

set_request_limit(NewLimit) ≡ set_request_limit/2

set_request_limit(Agent, NewLimit) -> Result

Types

Agent = pid() | AgentName

NewLimit = OldLimit = infinity | non_neg_integer()

Result = {ok, OldLimit} | {error, Reason}

Reason = term()

AgentName = atom()

Changes the request limit.

Note that this has no effect on the application configuration as defined by configuration files, so a node restart will revert the config to whatever is in those files.

This function is primarily useful in load regulation scenarios.

unload_mib(Mib) ≡ unload_mib/2

(since OTP R16B02)

unload_mib(Agent :: pid() | AgentName, Mib :: string()) -> Result

(since OTP R16B02)

Types

Result = ok | {error, Reason}

Reason = not_loaded | term()

AgentName = atom()

Unload a single Mib from an agent.

unload_mibs(Mibs) ≡ unload_mibs/3

unload_mibs/2 ≡ unload_mibs/3

unload_mibs(Agent, Mibs, Force)

(since OTP R16B02)

-spec unload_mibs(Mibs) -> ok | {error, Reason}
                     when
                         Mibs :: [MibName],
                         MibName :: string(),
                         Reason :: {'unload aborted at', MibName, InternalReason},
                         InternalReason :: not_loaded | term().

-spec unload_mibs(Agent, Mibs) -> ok | {error, Reason}
                     when
                         Agent :: pid() | AgentName,
                         AgentName :: atom(),
                         Mibs :: [MibName],
                         MibName :: string(),
                         Reason :: {'unload aborted at', MibName, InternalReason},
                         InternalReason :: not_loaded | term();
                 (Mibs, Force) -> ok | {error, Reason}
                     when
                         Mibs :: [MibName],
                         MibName :: string(),
                         Force :: boolean(),
                         Reason :: {'unload aborted at', MibName, InternalReason},
                         InternalReason :: not_loaded | term().

-spec unload_mibs(Agent, Mibs, Force) -> ok | {error, Reason}
                     when
                         Agent :: pid() | AgentName,
                         AgentName :: atom(),
                         Mibs :: [MibName],
                         MibName :: string(),
                         Force :: boolean(),
                         Reason :: {'unload aborted at', MibName, InternalReason},
                         InternalReason :: not_loaded | term().

Unload Mibs from an agent. If it cannot unload all MIBs (the default value of the Force argument is false), it will indicate where unloading was aborted.

If Force = true then the agent will continue attempting to unload each mib even after failing to unload a previous mib. Use with care.

unregister_notification_filter(Id) ≡ unregister_notification_filter/2

unregister_notification_filter(Agent, Id) -> Result

Types

Agent = pid() | AgentName

Id = nfilter_id()

Result = ok | {error, Reason}

Reason = term()

AgentName = atom()

Unregister a notification filter.

unregister_subagent(Agent, SubAgentOidOrPid) -> Result

Types

Agent = pid() | AgentName

SubAgentOidOrPid = snmp:oid() | pid()

Result = ok | {error, Reason}

Reason = term()

AgentName = atom()

Unregister a sub-agent. If the second argument is a pid, then that sub-agent will be unregistered from all trees in Agent.

update_mibs_cache_age(Age) ≡ update_mibs_cache_age/2

update_mibs_cache_age(Agent, Age) -> Result

Types

Agent = pid() | AgentName

Age = pos_integer()

Result = ok | {error, Reason}

Reason = term()

AgentName = atom()

Change the mib server cache age property.

update_mibs_cache_gclimit(GcLimit) ≡ update_mibs_cache_gclimit/2

update_mibs_cache_gclimit(Agent, GcLimit) -> Result

Types

Agent = pid() | AgentName

GcLimit = pos_integer()

Result = ok | {error, Reason}

Reason = term()

AgentName = atom()

Change the mib server cache gclimit property.

verbosity(Target, Verbosity) -> snmp:void()

Types

Target = all | LogicalName | PidOrAgentName

Verbosity = SNMPVerb | SubAgent

LogicalName = net_if | note_store | mib_server | symbolic_store | local_db

PidOrAgentName = pid() | master_agent | atom()

SNMPVerb = snmp:verbosity()

SubAgent = {subagents, snmp:verbosity()}

Sets 'verbosity' for the indicated process(s):

all - Sets verbosity for all the agent processes; net_if, note_store, mib_server, symbolic_store, local_db and master_agent (and sub-agents).
net_if - Sets verbosity for the net-if process.
note_store - Sets verbosity for the note store process.
mib_server - Sets verbosity for the mib server process.
symbolic_store - Sets verbosity for the symbolic store process.
local_db - Sets verbosity for the local-db process.
master_agent | pid() when Verbosity = {subagents, snmp:verbosity()} - Sets verbosity for all sub-agent(s) controlled by this (master) agent.
master_agent | pid() | atom() - Sets verbosity for the agent process.

The following text documents expected input-output relations

If Target :: all | net_if | note_store | mib_server | symbolic_store | local_db, then Verbosity :: snmp:verbosity().
If Target :: master_agent, then Verbosity :: {subagents, snmp:verbosity()}
If `Target :: pid() atom()`,
then `Verbosity :: snmp:verbosity() {subagents, snmp:verbosity()}`.

whereis_mib(MibName) ≡ whereis_mib/2

whereis_mib(Agent, MibName) -> Result

Types

Agent = pid() | AgentName

MibName = AgentName = atom()

Result = {ok, MibFile} | {error, Reason}

Reason = term()

MibFile = string()

Get the full path to the (compiled) mib-file.

which_aliasnames() -> AliasNames

Types

AliasNames = [AliasName]

AliasName = atom()

Retrieve all alias-names known to the agent.

which_mibs() ≡ which_mibs/1

which_mibs(Agent :: pid() | AgentName) -> Mibs

Types

Mibs = [{MibName, MibFile}]

MibName = AgentName = atom()

MibFile = string()

Retrieve the list of all the mibs loaded into this agent. Default is the master agent.

which_mibs_cache_size() ≡ which_mibs_cache_size/1

(since OTP R14B)

which_mibs_cache_size(Agent) -> Result

(since OTP R14B)

Types

Agent = pid() | AgentName

Result = {ok, Size} | {error, Reason}

Reason = term()

Size = non_neg_integer()

AgentName = atom()

Retrieve the size of the mib server cache.

which_notification_filter() ≡ which_notification_filter/1

which_notification_filter(Agent :: pid() | AgentName) -> Filters

Types

Filters = [FilterId]

AgentName = atom()

FilterId = nfilter_id()

List all notification filters in an agent.

which_notifications() -> Notifications

Types

Notifications = [{Name, MibName, Info}]

Name = MibName = atom()

Info = term()

Retrieve all notifications (and traps) known to the agent.

which_tables() -> Tables

Types

Tables = [Table]

Table = atom()

Retrieve all tables known to the agent.

which_transports() -> Transports

(since OTP 23.3)

Types

Transports = [Transport]

Kind = transport_kind()

TDomain = snmp:tdomain()

TAddress = {IpAddr, IpPort}

Transport = {TDomain, TAddress} | {TDomain, TAddress, Kind}

IpAddr = inet:ip_address()

IpPort = inet:port_number()

Retrieve all configured transports.

which_variables() -> Variables

Types

Variables = [Variable]

Variable = atom()

Retrieve all variables known to the agent.

If `Target :: pid()	atom()`,
then `Verbosity :: snmp:verbosity()	{subagents, snmp:verbosity()}`.