1SNMP(7)                  Erlang Application Definition                 SNMP(7)
2
3
4

NAME

6       SNMP - The SNMP Application
7

DESCRIPTION

9       This  chapter  describes the snmp application in OTP. The SNMP applica‐
10       tion provides the following services:
11
12         * a multilingual extensible SNMP agent
13
14         * a SNMP manager
15
16         * a MIB compiler
17

CONFIGURATION

19       The following configuration parameters are defined for the SNMP  appli‐
20       cation.  Refer  to application(3) for more information about configura‐
21       tion parameters.
22
23       The snmp part of the config file specifying the  configuration  parame‐
24       ters is basically the following tuple:
25
26             {snmp, snmp_components_config()}
27
28
29       A  minimal  config  file for starting a node with both a manager and an
30       agent:
31
32             [{snmp,
33               [{agent, [{db_dir, "/tmp/snmp/agent/db"},
34                         {config, [{dir, "/tmp/snmp/agent/conf"}]}]},
35                {manager, [{config, [{dir, "/tmp/snmp/manager/conf"},
36                                     {db_dir, "/tmp/snmp/manager/db"}]}]}]}
37               ]
38              }
39             ].
40
41
42       Each snmp component has its own set of configuration  parameters,  even
43       though some of the types are common to both components.
44
45             snmp_components_config() -> [snmp_component_config()]
46             snmp_component_config() -> {agent, agent_options()} | {manager, manager_options()}
47             agent_options() = [agent_option()]
48             agent_option() = {restart_type,     restart_type()}     |
49                              {agent_type,       agent_type()}       |
50                              {agent_verbosity,  verbosity()}        |
51                              {discovery,        agent_discovery()}  |
52                              {versions,         versions()}         |
53                              {gb_max_vbs,       gb_max_vbs()}       |
54                              {priority,         priority()}         |
55                              {multi_threaded,   multi_threaded()}   |
56                              {db_dir,           db_dir()}           |
57                              {db_init_error,    db_init_error()}    |
58                              {local_db,         local_db()}         |
59                              {net_if,           agent_net_if()}     |
60                              {mibs,             mibs()}             |
61                              {mib_storage,      mib_storage()}      |
62                              {mib_server,       mib_server()}       |
63                              {audit_trail_log,  audit_trail_log()}  |
64                              {error_report_mod, error_report_mod()} |
65                              {note_store,       note_store()}       |
66                              {symbolic_store,   symbolic_store()}   |
67                              {target_cache,     target_cache()}     |
68                              {config,           agent_config()}
69             manager_options() = [manager_option()]
70             manager_option() = {restart_type,             restart_type()}    |
71                                {net_if,                   manager_net_if()}  |
72                                {server,                   server()}          |
73                                {note_store,               note_store()}      |
74                                {config,                   manager_config()}  |
75                                {inform_request_behaviour, manager_irb()}     |
76                                {mibs,                     manager_mibs()}    |
77                                {priority,                 priority()}        |
78                                {audit_trail_log,          audit_trail_log()} |
79                                {versions,                 versions()}        |
80                                {def_user_mod,             def_user_module()  |
81                                {def_user_data,            def_user_data()}
82
83
84       Agent specific config options and types:
85
86         agent_type() = master | sub <optional>:
87           If  master,  one  master agent is started. Otherwise, no agents are
88           started.
89
90           Default is master.
91
92         agent_discovery() = [agent_discovery_opt()] <optional>:
93           agent_discovery_opt()  =  {terminating,   agent_terminating_discov‐
94           ery_opts()} | {originating, agent_originating_discovery_opts()}
95
96           The terminating options effects discovery initiated by a manager.
97
98           The originating options effects discovery initiated by this agent.
99
100           For defaults see the options in agent_discovery_opt().
101
102         agent_terminating_discovery_opts()    =    [agent_terminating_discov‐
103         ery_opt()] <optional>:
104           agent_terminating_discovery_opt() = {enable, boolean()} |  {stage2,
105           discovery | plain} | {trigger_username, string()}
106
107           These  are  options  effecting  discovery terminating in this agent
108           (i.e. initiated by a manager).
109
110           The default values for the terminating discovery options are:
111
112           * enable: true
113
114           * stage2: discovery
115
116           * trigger_username: ""
117
118         agent_originating_discovery_opts()    =    [agent_originating_discov‐
119         ery_opt()] <optional>:
120           agent_originating_discovery_opt() = {enable, boolean()}
121
122           These are options effecting discovery originating in this agent.
123
124           The default values for the originating discovery options are:
125
126           * enable: true
127
128         multi_threaded() = bool() | extended <optional>:
129           If true (or extended), the agent is multi-threaded, with one thread
130           for each get request.
131
132           The value extended means that a special 'process' is  also  created
133           intended to handle all notifications.
134
135           * true  -  One  worker  dedicated  to 'set-requests' and one (main)
136             worker for all other requests ('get-request' and notifications).
137
138             If the 'main' worker is busy, a temporary process is  spawned  to
139             handle that job ('get-request' or notification).
140
141           * extended  -  One  worker  dedicated to 'set-requests', one worker
142             dedicated to notifications and one (main) worker for all 'get-re‐
143             quests'.
144
145             If  the  'main' worker is busy, a temporary process is spawned to
146             handle that 'get-request'.
147
148     Note:
149         Even with multi-threaded set to extended there is still  a  risk  for
150         'reorder'  when sending inform-requsts, which require a response (and
151         may therefore require resending).
152
153         Also, there is of course no way to guarantee order once  the  package
154         is on the network.
155
156
157           Default is false.
158
159         db_dir() = string() <mandatory>:
160           Defines where the SNMP agent internal db files are stored.
161
162         gb_max_vbs() = pos_integer() | infinity <optional>:
163           Defines  the  maximum  number of varbinds allowed in a Get-BULK re‐
164           sponse.
165
166           Default is 1000.
167
168         local_db() = [local_db_opt()] <optional>:
169           local_db_opt()   =   {repair,   agent_repair()}    |    {auto_save,
170           agent_auto_save()} | {verbosity, verbosity()}
171
172           Defines options specific for the SNMP agent local database.
173
174           For defaults see the options in local_db_opt().
175
176         agent_repair() = false | true | force <optional>:
177           When  starting  snmpa_local_db  it always tries to open an existing
178           database. If false, and some errors occur, a new database  is  cre‐
179           ated instead. If true, an existing file will be repaired. If force,
180           the table will be repaired even if it was properly closed.
181
182           Default is true.
183
184         agent_auto_save() = integer() | infinity <optional>:
185           The auto save interval. The table is flushed to disk  whenever  not
186           accessed for this amount of time.
187
188           Default is 5000.
189
190         agent_net_if() = [agent_net_if_opt()] <optional>:
191           agent_net_if_opt()  = {module, agent_net_if_module()} | {verbosity,
192           verbosity()} | {options, agent_net_if_options()}
193
194           Defines options specific for the SNMP agent network  interface  en‐
195           tity.
196
197           For defaults see the options in agent_net_if_opt().
198
199         agent_net_if_module() = atom() <optional>:
200           Module which handles the network interface part for the SNMP agent.
201           Must implement the snmpa_network_interface behaviour.
202
203           Default is snmpa_net_if.
204
205         agent_net_if_options() = [agent_net_if_option()] <optional>:
206           agent_net_if_option() = {bind_to, bind_to()} | {sndbuf, sndbuf()} |
207           {recbuf,   recbuf()}   |   {no_reuse,   no_reuse()}  |  {req_limit,
208           req_limit()}  |  {filter,  agent_net_if_filter_options()}  |   {ex‐
209           tra_sock_opts,  extra_socket_options()}  |  {inet_backend,  inet  |
210           socket}
211
212           These options are actually specific to the used  module.  The  ones
213           shown here are applicable to the default agent_net_if_module().
214
215     Note:
216         If  the  user  has configured transports with options then those will
217         take precedence over these options. See agent  information  for  more
218         info.
219
220
221           For defaults see the options in agent_net_if_option().
222
223         req_limit() = integer() | infinity <optional>:
224           Max number of simultaneous requests handled by the agent.
225
226           Default is infinity.
227
228         agent_net_if_filter_options()  =  [agent_net_if_filter_option()] <op‐
229         tional>:
230           agent_net_if_filter_option()  =  {module,  agent_net_if_filter_mod‐
231           ule()}
232
233           These  options  are  actually specific to the used module. The ones
234           shown here are applicable to the  default  agent_net_if_filter_mod‐
235           ule().
236
237           For defaults see the options in agent_net_if_filter_option().
238
239         agent_net_if_filter_module() = atom() <optional>:
240           Module which handles the network interface filter part for the SNMP
241           agent. Must implement the snmpa_network_interface_filter behaviour.
242
243           Default is snmpa_net_if_filter.
244
245         agent_mibs() = [string()] <optional>:
246           Specifies a list of MIBs (including path) that defines  which  MIBs
247           are initially loaded into the SNMP master agent.
248
249           Note that the following mibs will always be loaded:
250
251           * version v1: STANDARD-MIB
252
253           * version v2: SNMPv2
254
255           * version v3: SNMPv2, SNMP-FRAMEWORK-MIB and SNMP-MPD-MIB
256
257           Default is [].
258
259         mib_storage() = [mib_storage_opt()] <optional>:
260           mib_storage_opt()  =  {module,  mib_storage_module()}  |  {options,
261           mib_storage_options()}
262
263           This option specifies how basic mib data is stored. This option  is
264           used  by  two  parts of the snmp agent: The mib-server and the sym‐
265           bolic-store.
266
267           Default is [{module, snmpa_mib_storage_ets}].
268
269         mib_storage_module() = snmpa_mib_data_ets | snmpa_mib_data_dets | sn‐
270         mpa_mib_data_mnesia | module():
271           Defines  the mib storage module of the SNMP agent as defined by the
272           snmpa_mib_storage behaviour.
273
274           Several entities (mib-server via the its data module and  the  sym‐
275           bolic-store)  of  the snmp agent uses this for storage of miscella‐
276           neous mib related data retrieved while loading a mib.
277
278           There are several implementations  provided  with  the  agent:  sn‐
279           mpa_mib_storage_ets,   snmpa_mib_storage_dets  and  snmpa_mib_stor‐
280           age_mnesia.
281
282           Default module is snmpa_mib_storage_ets.
283
284         mib_storage_options() = list() <optional>:
285           This is implementation depended. That is, it depends on the module.
286           For each module a specific set of options are valid. For the module
287           provided with the app, these options are supported:
288
289           * snmpa_mib_storage_ets:  {dir,  filename()}  |  {action,  keep   |
290             clear}, {checksum, boolean()}
291
292             * dir  -  If present, points to a directory where a file to which
293               all data in the ets table is "synced".
294
295               Also, when a table is opened this file is read, if it exists.
296
297               By default, this will not be used.
298
299             * action - Specifies the  behaviour  when  a  non-empty  file  is
300               found: Keep its content or clear it out.
301
302               Default is keep.
303
304             * checksum - Defines if the file is checksummed or not.
305
306               Default is false.
307
308           * snmpa_mib_storage_dets:  {dir,  filename()}  |  {action,  keep  |
309             clear}, {auto_save, default | pos_integer()} | {repair,  force  |
310             boolean()}
311
312             * dir  -  This  mandatory  option  points to a directory where to
313               place the file of a dets table.
314
315             * action - Specifies the  behaviour  when  a  non-empty  file  is
316               found: Keep its content or clear it out.
317
318               Default is keep.
319
320             * auto_save - Defines the dets auto-save frequency.
321
322               Default is default.
323
324             * repair - Defines the dets repair behaviour.
325
326               Default is false.
327
328           * snmpa_mib_storage_mnesia:   {action,   keep   |  clear},  {nodes,
329             [node()]}
330
331             * action - Specifies the behaviour when a non-empty, already  ex‐
332               isting, table: Keep its content or clear it out.
333
334               Default is keep.
335
336             * nodes  -  A list of node names (or an atom describing a list of
337               nodes) defining where to open the table. Its up to the user  to
338               ensure that mnesia is actually running on the specified nodes.
339
340               The following distinct values are recognised:
341
342               * [] - Translated into a list of the own node: [node()]
343
344               * all - erlang:nodes()
345
346               * visible - erlang:nodes(visible)
347
348               * connected - erlang:nodes(connected)
349
350               * db_nodes - mnesia:system_info(db_nodes)
351
352               Default is the result of the call: erlang:nodes().
353
354         mib_server() = [mib_server_opt()] <optional>:
355           mib_server_opt()   =   {mibentry_override,  mibentry_override()}  |
356           {trapentry_override,  trapentry_override()}  |   {verbosity,   ver‐
357           bosity()}     |     {cache,     mibs_cache()}    |    {data_module,
358           mib_server_data_module()}
359
360           Defines options specific for the SNMP agent mib server.
361
362           For defaults see the options in mib_server_opt().
363
364         mibentry_override() = bool() <optional>:
365           If this value is false, then when loading a mib each mib- entry  is
366           checked  prior to installation of the mib. The purpose of the check
367           is to prevent that the same symbolic mibentry name is used for dif‐
368           ferent oid's.
369
370           Default is false.
371
372         trapentry_override() = bool() <optional>:
373           If  this  value  is  false,  then  when  loading a mib each trap is
374           checked prior to installation of the mib. The purpose of the  check
375           is  to prevent that the same symbolic trap name is used for differ‐
376           ent trap's.
377
378           Default is false.
379
380         mib_server_data_module() = snmpa_mib_data_tttn | module() <optional>:
381           Defines the backend data module of the SNMP agent mib-server as de‐
382           fined by the snmpa_mib_data behaviour.
383
384           At  present only the default module is provided with the agent, sn‐
385           mpa_mib_data_tttn.
386
387           Default module is snmpa_mib_data_tttn.
388
389         mibs_cache() = bool() | mibs_cache_opts() <optional>:
390           Shall the agent utilize the mib server lookup cache or not.
391
392           Default is true (in which case the mibs_cache_opts() default values
393           apply).
394
395         mibs_cache_opts() = [mibs_cache_opt()] <optional>:
396           mibs_cache_opt()   =   {autogc,  mibs_cache_autogc()}  |  {gclimit,
397           mibs_cache_gclimit()} | {age, mibs_cache_age()}
398
399           Defines options specific for the SNMP agent mib server cache.
400
401           For defaults see the options in mibs_cache_opt().
402
403         mibs_cache_autogc() = bool() <optional>:
404           Defines if the mib server shall perform cache gc  automatically  or
405           leave it to the user (see gc_mibs_cache/0,1,2,3).
406
407           Default is true.
408
409         mibs_cache_age() = integer() > 0 <optional>:
410           Defines  how old the entries in the cache will be allowed to become
411           before they are GC'ed (assuming GC is performed). Each entry in the
412           cache is "touched" whenever it is accessed.
413
414           The age is defined in milliseconds.
415
416           Default is 10 timutes.
417
418         mibs_cache_gclimit() = infinity | integer() > 0 <optional>:
419           When  performing a GC, this is the max number of cache entries that
420           will be deleted from the cache.
421
422           The reason why its possible to set a limit, is that if the cache is
423           large,  the  GC  can potentially take a long time, during which the
424           agent is "busy". But on a heavily loaded system, we also  risk  not
425           removing  enough  elements in the cache, instead causing it to grow
426           over time. This is the reason the default value is infinity,  which
427           will ensure that all candidates are removed as soon as possible.
428
429           Default is infinity.
430
431         error_report_mod() = atom() <optional>:
432           Defines an error report module, implementing the snmpa_error_report
433           behaviour. Two modules are provided  with  the  toolkit:  snmpa_er‐
434           ror_logger and snmpa_error_io.
435
436           Default is snmpa_error_logger.
437
438         symbolic_store() = [symbolic_store_opt()]:
439           symbolic_store_opt() = {verbosity, verbosity()}
440
441           Defines options specific for the SNMP agent symbolic store.
442
443           For defaults see the options in symbolic_store_opt().
444
445         target_cache() = [target_cache_opt()]:
446           target_cache_opt() = {verbosity, verbosity()}
447
448           Defines options specific for the SNMP agent target cache.
449
450           For defaults see the options in target_cache_opt().
451
452         agent_config() = [agent_config_opt()] <mandatory>:
453           agent_config_opt()   =  {dir,  agent_config_dir()}  |  {force_load,
454           force_load()} | {verbosity, verbosity()}
455
456           Defines specific config related options for the SNMP agent.
457
458           For defaults see the options in agent_config_opt().
459
460         agent_config_dir = dir() <mandatory>:
461           Defines where the SNMP agent configuration files are stored.
462
463         force_load() = bool() <optional>:
464           If true the configuration files are re-read  during  start-up,  and
465           the  contents of the configuration database ignored. Thus, if true,
466           changes to the configuration database are lost upon reboot  of  the
467           agent.
468
469           Default is false.
470
471       Manager specific config options and types:
472
473         server() = [server_opt()] <optional>:
474           server_opt()  =  {timeout,  server_timeout()}  |  {verbosity,  ver‐
475           bosity()} | {cbproxy, server_cbproxy()} | {netif_sup, server_nis()}
476
477           Specifies the options for the manager server process.
478
479           Default is silence.
480
481         server_timeout() = integer() <optional>:
482           Asynchronous request cleanup time. For every requests, some info is
483           stored  internally,  in order to be able to deliver the reply (when
484           it arrives) to the proper destination. If the reply  arrives,  this
485           info  will be deleted. But if there is no reply (in time), the info
486           has to be deleted after the best before time has been passed.  This
487           cleanup  will  be  performed  at  regular intervals, defined by the
488           server_timeout() time. The information will  have  an  best  before
489           time,  defined  by  the  Expire time given when calling the request
490           function (see async_get, async_get_next and async_set).
491
492           Time in milli-seconds.
493
494           Default is 30000.
495
496         server_cbproxy() = temporary (default) | permanent <optional>:
497           This option specifies how the server will handle callback calls.
498
499           temporary (default):
500             A temporary process will be created for each callback call.
501
502           permanent:
503             With this the server will create a permanent (named) process that
504             in effect serializes all callback calls.
505
506           Default is temporary.
507
508         server_nis() = none (default) | {PingTO, PongTO} <optional>:
509           This  option  specifies if the server should actively supervise the
510           net-if process. Note that this will only work if  the  used  net-if
511           process actually supports the protocol. See snmpm_network_interface
512           behaviour for more info.
513
514           none (default):
515             No active supervision of the net-if process.
516
517           {PingTO :: pos_integer(), PongTO :: pos_integer()}:
518             The PingTO time specifies  the  between  a  successful  ping  (or
519             start) and the time when a ping message is to be sent to the net-
520             if process (basically the time between ping).
521
522             The PongTO time specifies how long time the net-if process has to
523             respond to a ping message, with a pong message. Its starts count‐
524             ing when the ping message has been sent.
525
526             Both times are in milli seconds.
527
528           Default is none.
529
530         manager_config() = [manager_config_opt()] <mandatory>:
531           manager_config_opt() = {dir, manager_config_dir()} | {db_dir,  man‐
532           ager_db_dir()}  |  {db_init_error, db_init_error()} | {repair, man‐
533           ager_repair()} |  {auto_save,  manager_auto_save()}  |  {verbosity,
534           verbosity()}
535
536           Defines specific config related options for the SNMP manager.
537
538           For defaults see the options in manager_config_opt().
539
540         manager_config_dir = dir() <mandatory>:
541           Defines where the SNMP manager configuration files are stored.
542
543         manager_db_dir = dir() <mandatory>:
544           Defines where the SNMP manager store persistent data.
545
546         manager_repair() = false | true | force <optional>:
547           Defines  the  repair option for the persistent database (if and how
548           the table is repaired when opened).
549
550           Default is true.
551
552         manager_auto_save() = integer() | infinity <optional>:
553           The auto save interval. The table is flushed to disk  whenever  not
554           accessed for this amount of time.
555
556           Default is 5000.
557
558         manager_irb() = auto | user | {user, integer()} <optional>:
559           This  option defines how the manager will handle the sending of re‐
560           sponse (acknowledgment) to received inform-requests.
561
562           * auto - The manager will autonomously send  response  (acknowledg‐
563             ment> to inform-request messages.
564
565           * {user,  integer()}  - The manager will send response (acknowledg‐
566             ment) to inform-request messages when the handle_inform  function
567             completes.  The  integer  is the time, in milli-seconds, that the
568             manager will consider the stored inform-request info valid.
569
570           * user - Same as {user, integer()}, except that the  default  time,
571             15 seconds (15000), is used.
572
573           See  snmpm_network_interface,  handle_inform  and definition of the
574           manager net if for more info.
575
576           Default is auto.
577
578         manager_mibs() = [string()] <optional>:
579           Specifies a list of MIBs (including path) and  defines  which  MIBs
580           are initially loaded into the SNMP manager.
581
582           Default is [].
583
584         manager_net_if() = [manager_net_if_opt()] <optional>:
585           manager_net_if_opt()  =  {module,  manager_net_if_module()} | {ver‐
586           bosity, verbosity()} | {options, manager_net_if_options()}
587
588           Defines options specific for the SNMP manager network interface en‐
589           tity.
590
591           For defaults see the options in manager_net_if_opt().
592
593         manager_net_if_options() = [manager_net_if_option()] <optional>:
594           manager_net_if_option() = {bind_to, bind_to()} | {sndbuf, sndbuf()}
595           | {recbuf, recbuf()}  |  {no_reuse,  no_reuse()}  |  {filter,  man‐
596           ager_net_if_filter_options()}  | {extra_sock_opts, extra_socket_op‐
597           tions()} | {inet_backend, inet | socket}
598
599           These options are actually specific to the used  module.  The  ones
600           shown here are applicable to the default manager_net_if_module().
601
602           For defaults see the options in manager_net_if_option().
603
604         manager_net_if_module() = atom() <optional>:
605           The  module  which  handles the network interface part for the SNMP
606           manager. It must implement the snmpm_network_interface behaviour.
607
608           Default is snmpm_net_if.
609
610         manager_net_if_filter_options()  =   [manager_net_if_filter_option()]
611         <optional>:
612           manager_net_if_filter_option()   =   {module,   manager_net_if_fil‐
613           ter_module()}
614
615           These options are actually specific to the used  module.  The  ones
616           shown here are applicable to the default manager_net_if_filter_mod‐
617           ule().
618
619           For defaults see the options in manager_net_if_filter_option().
620
621         manager_net_if_filter_module() = atom() <optional>:
622           Module which handles the network interface filter part for the SNMP
623           manager.  Must  implement the snmpm_network_interface_filter behav‐
624           iour.
625
626           Default is snmpm_net_if_filter.
627
628         def_user_module() = atom() <optional>:
629           The module implementing the default user. See the snmpm_user behav‐
630           iour.
631
632           Default is snmpm_user_default.
633
634         def_user_data() = term() <optional>:
635           Data  for  the default user. Passed to the user module when calling
636           the callback functions.
637
638           Default is undefined.
639
640       Common config types:
641
642         restart_type() = permanent | transient | temporary:
643           See supervisor documentation for more info.
644
645           Default is permanent for the agent and transient for the manager.
646
647         db_init_error() = terminate | create | create_db_and_dir:
648           Defines what to do if the agent or manager is unable to open an ex‐
649           isting  database  file. terminate means that the agent/manager will
650           terminate and create means that the agent/manager will  remove  the
651           faulty  file(s)  and  create  new ones, and create_db_and_dir means
652           that the agent/manager will create the database file along with any
653           missing parent directories for the database file.
654
655           Default is terminate.
656
657         priority() = atom() <optional>:
658           Defines the Erlang priority for all SNMP processes.
659
660           Default is normal.
661
662         versions() = [version()] <optional>:
663           version() = v1 | v2 | v3
664
665           Which SNMP versions shall be accepted/used.
666
667           Default is [v1,v2,v3].
668
669         verbosity() = silence | info | log | debug | trace <optional>:
670           Verbosity for a SNMP process. This specifies now much debug info is
671           printed.
672
673           Default is silence.
674
675         bind_to() = bool() <optional>:
676           If true, net_if binds to the IP address. If false,  net_if  listens
677           on any IP address on the host where it is running.
678
679           Default is false.
680
681         no_reuse() = bool() <optional>:
682           If  true,  net_if  does  not  specify  that the IP and port address
683           should be reusable. If false, the address is set to reusable.
684
685           Default is false.
686
687         recbuf() = integer() <optional>:
688           Receive buffer size.
689
690           Default value is defined by gen_udp.
691
692         sndbuf() = integer() <optional>:
693           Send buffer size.
694
695           Default value is defined by gen_udp.
696
697         extra_socket_options() = list() <optional>:
698           A list of arbitrary socket options.
699
700           This list is not inspected by snmp (other then checking that its  a
701           list).  Its the users responsibility to ensure that these are valid
702           options and does not conflict with the "normal" options.
703
704           Default is [].
705
706         note_store() = [note_store_opt()] <optional>:
707           note_store_opt() = {timeout,  note_store_timeout()}  |  {verbosity,
708           verbosity()}
709
710           Specifies the start-up verbosity for the SNMP note store.
711
712           For defaults see the options in note_store_opt().
713
714         note_store_timeout() = integer() <optional>:
715           Note cleanup time. When storing a note in the note store, each note
716           is given lifetime. Every timeout the note_store process performs  a
717           GC to remove the expired note's. Time in milli-seconds.
718
719           Default is 30000.
720
721         audit_trail_log() = [audit_trail_log_opt()] <optional>:
722           audit_trail_log_opt()  =  {type,  atl_type()}  | {dir, atl_dir()} |
723           {size, atl_size()} | {repair, atl_repair()} | {seqno, atl_seqno()}
724
725           If present, this option specifies the options for the  audit  trail
726           logging.  The  disk_log  module  is used to maintain a wrap log. If
727           present, the dir and size options are mandatory.
728
729           If not present, audit trail logging is not used.
730
731         atl_type() = read | write | read_write <optional>:
732           Specifies what type of an audit trail log should be used.  The  ef‐
733           fect  of  the  type is actually different for the the agent and the
734           manager.
735
736           For the agent:
737
738           * If write is specified, only set requests are logged.
739
740           * If read is specified, only get requests are logged.
741
742           * If read_write, all requests are logged.
743
744           For the manager:
745
746           * If write is specified, only sent messages are logged.
747
748           * If read is specified, only received messages are logged.
749
750           * If read_write, both outgoing and incoming messages are logged.
751
752           Default is read_write.
753
754         atl_dir = dir() <mandatory>:
755           Specifies where the audit trail log should be stored.
756
757           If audit_trail_log specifies that logging should take  place,  this
758           parameter must be defined.
759
760         atl_size() = {integer(), integer()} <mandatory>:
761           Specifies  the  size of the audit trail log. This parameter is sent
762           to disk_log.
763
764           If audit_trail_log specifies that logging should take  place,  this
765           parameter must be defined.
766
767         atl_repair() = true | false | truncate | snmp_repair <optional>:
768           Specifies  if  and  how  the audit trail log shall be repaired when
769           opened. Unless this parameter has the value snmp_repair it is  sent
770           to  disk_log. If, on the other hand, the value is snmp_repair, snmp
771           attempts to handle certain faults on its own. And even if it cannot
772           repair  the  file,  it  does  not truncate it directly, but instead
773           moves it aside for later off-line analysis.
774
775           Default is true.
776
777         atl_seqno() = true | false <optional>:
778           Specifies if the audit trail log entries will  be  (sequence)  num‐
779           bered  or  not.  The range of the sequence numbers are according to
780           RFC 5424, i.e. 1 through 2147483647.
781
782           Default is false.
783

SEE ALSO

785       application(3), disk_log(3)
786
787
788
789Ericsson AB                       snmp 5.13.3                          SNMP(7)
Impressum