SNMP Release Notes

## 1 SNMP Release Notes

### 1.1 SNMP Development Toolkit 4.12

Version 4.12 supports code replacement in runtime from/to version 4.11.2, 4.11.1 and 4.11.

#### 1.1.1 Improvements and new features

- [agent] A simple lookup cache has been added to improve the mib server lookup performance.
  This can be disabled with the mib_server cache option.
  Own Id: OTP-7346
- [agent] Improvement of the inform reporting. It was previously not certain how many acks an application received, 0, 1 or 2. This has now been fixed, so that only 1 (one) ack is issued.
  Per Hedeland
  Own Id: OTP-7525

#### 1.1.2 Reported Fixed Bugs and Malfunctions

-

#### 1.1.3 Incompatibilities

-

### 1.2 SNMP Development Toolkit 4.11.2

Version 4.11.2 supports code replacement in runtime from/to version 4.11.1 and 4.11.

#### 1.2.1 Improvements and new features

-

#### 1.2.2 Reported Fixed Bugs and Malfunctions

- [manager] Erroneous engine-id check when receiving version 3 informs.
  Own Id: OTP-7570
  Aux Id: Seq 11060
- Receiving an snmp message with a very large version number could cause the erlang node to run out of memory and consequently crash.
  The standard specifies the snmp version as an (unlimited) INTEGER, but today only 0 (version 1), 1 (version 2) and 3 (version 3) is actually used. So, when decoding a message, a limit has been put on the snmp version integer in order to not allow this kind of a problem.
  Own Id: OTP-7575
  Aux Id: Seq 11064

#### 1.2.3 Incompatibilities

-

### 1.3 SNMP Development Toolkit 4.11.1

Version 4.11.1 supports code replacement in runtime from/to version 4.11.

#### 1.3.1 Improvements and new features

- [compiler] The MIB compiler did not retreive the REFERENCE part of a SNMP MIB definition.
  This problem has been partly solved. For SNMP tables, the assocList field of the tables mib-entry record now contains this info (as {reference, string()}), if the MIB was compiled with the compiler option +reference.
  This solution is temporary, until such time as a permanent solution (and probably not backward compatible) is devised, which retreives and stores all REFERENCE part(s) of a MIB.
  See the compiler options for more info.
  Serge Aleynikov
  Own Id: OTP-7426
- Added utility functions for transforming DateAndTime as [int()] to strings; date_and_time_to_string/2 and date_and_time_to_string2/1.
  Also added new validation function validate_date_and_time/2.
  Own Id: OTP-7412
  Aux Id: Seq 10987

#### 1.3.2 Reported Fixed Bugs and Malfunctions

- [manager] Encryption error when attempting to send version 3 inform-requests.
  Own Id: OTP-7432
  Aux Id: Seq 10966

#### 1.3.3 Incompatibilities

-

### 1.4 SNMP Development Toolkit 4.11

Version 4.11 supports code replacement in runtime from/to version 4.10.3, 4.10.2, 4.10.1 and 4.10.

#### 1.4.1 Improvements and new features

- [agent] Performance improvements in the case when an SNMP manager performs an snmpwalk.
  Martin Björklund
  Own Id: OTP-7201
- The API for sending inform(s) has been improved. Also the documentation has been corrected and updated. See snmpa:send_notification and snmpa_notification_delivery_info_receiver for more info.
  Own Id: OTP-7287
  Aux Id: Seq 10926
- [agent] Performance of the internal database (local-db) has been improved.
  Own Id: OTP-7319
  Aux Id: Seq 10942
- [agent] Added utility functions, snmpa:restart_worker/0,1 and snmpa:restart_set_worker/0,1, for restarting the agent worker processes (in case the agent is multi-threaded).
  Own Id: OTP-7369
- Add utility function to read a compiled mib.
  Own Id: OTP-7371

#### 1.4.2 Reported Fixed Bugs and Malfunctions

- [manager] Encryption error when attempting to send version 3 inform-requests.
  Own Id: OTP-7377
  Aux Id: Seq 10966

#### 1.4.3 Incompatibilities

-

### 1.5 SNMP Development Toolkit 4.10.3

Version 4.10.3 supports code replacement in runtime from/to version 4.10.2, 4.10.1 and 4.10.

#### 1.5.1 Improvements and new features

-

#### 1.5.2 Reported Fixed Bugs and Malfunctions

- [manager] The configuration option inform_request_behaviour was not properly parsed, which caused the manager to revert to the default value, auto.
  Own Id: OTP-7219

#### 1.5.3 Incompatibilities

-

### 1.6 SNMP Development Toolkit 4.10.2

Version 4.10.2 supports code replacement in run-time from/to version 4.10.1 and 4.10

#### 1.6.1 Improvements and new features

- [compiler] The MIB-compiler did not recognize well-known-names as top parents. The names 'ccitt' (0) , 'iso' (1) and 'joint-iso-ccitt' (2) is now also recognized by the MIB compiler.
  Ola Samuelsson
  Own Id: OTP-7160
- [compiler] The MIB-compiler did not suppport a name assignment which was sequence of numbers, only a parent object name followed by a sequence of numbers.
  Ola Samuelsson
  Own Id: OTP-7158

#### 1.6.2 Reported Fixed Bugs and Malfunctions

- [agent] Invalid variable value causes crashing agent worker process when sending traps.
  Own Id: OTP-7159
- [agent] When sending a trap, the order of the variable bindings not provided by the trap-sender, could be mangled by the agent.
  Ola Samuelsson
  Own Id: OTP-7157
- [agent] Uninstalling MEs when unloading mibs incorrect and therefor never done.
  Own Id: OTP-7153
- [agent] snmp_generic:table_set_cols/3 did not handle unexpected return values correctly when setting column values.
  Serge Aleynikov
  Own Id: OTP-7152

#### 1.6.3 Incompatibilities

-

### 1.7 SNMP Development Toolkit 4.10.1

Version 4.10.1 supports code replacement in run-time from/to version 4.10

#### 1.7.1 Improvements and new features

-

#### 1.7.2 Reported Fixed Bugs and Malfunctions

- [manager] Fixed usage of inet:gethostname/1.
  Dialyzer
  Own Id: OTP-7123
- [agent] Remeoved invalid guard. There was an invalid guard on the start function of the top agent supervisor.
  Dialyzer
  Own Id: OTP-7121
- [compiler] Old style fun cleanup in the MIB compiler.
  Dialyzer
  Own Id: OTP-7119
- Corrected usage of function file:open/2 (the Modes argument is a list).
  Own Id: OTP-7110
- The SNMP application contains some (previously undocumented) simple utility functions for function tracing (using dbg), see enable_trace, disable_trace, set_trace/1, reset_trace and set_trace/2 for more info. These functions are intended to make it easy to enable tracing on individual functions. There where some minor errors, which has now been corrected.
  Own Id: OTP-7109
- There is a bug in snmp_pdus:enc_oct_str_tag/1. All the enc_* functions are supposed to return a flat list, but the second clause of this function does not. If it gets a binary it returns a deep list.
  Martin Björklund
  Own Id: OTP-7083

#### 1.7.3 Incompatibilities

-

### 1.8 SNMP Development Toolkit 4.10

#### 1.8.1 Improvements and new features

- Added buffer sizes (both receive and send) of the udp socket(s) info when calling the agent info and manager info function(s).
  Own Id: OTP-6945
- [agent] Added the ability to change the request limit in run-time, see set_request_limit for more info.
  Own Id: OTP-6898
- Added the ability to change the audit trail log type in run-time (both agent and manager), see function(s) [manager] set_log_type and [agent] set_log_type for more info.
  Own Id: OTP-6841
- [agent] Added support for message filtering in the network interface module provided with the application. The component that actually make the filter decisions is the network interface filter module. This module must implement the network interface filter behaviour. See also the Configuring the application chapter of the User's Guide to see how to configure this feature.
  Own Id: OTP-6649

#### 1.8.2 Reported Fixed Bugs and Malfunctions

-

#### 1.8.3 Incompatibilities

-

### 1.9 SNMP Development Toolkit 4.9.6

Version 4.9.6 supports code replacement in run-time from/to version 4.9.5, 4.9.4, 4.9.3, 4.9.2, 4.9.1 and 4.9.

#### 1.9.1 Improvements and new features

-

#### 1.9.2 Reported Fixed Bugs and Malfunctions

- [compiler] The MIB compiler did not handle import of the macro from the MIB RFC1155-SMI.
  Own Id: OTP-6840
  Aux Id: Seq 10726
- Bad length check (i.e. none) when decoding AuthenticationParameters.
  Own Id: OTP-6843

#### 1.9.3 Incompatibilities

-

### 1.10 SNMP Development Toolkit 4.9.5

Version 4.9.5 supports code replacement in run-time from/to version 4.9.4, 4.9.3, 4.9.2, 4.9.1 and 4.9.

#### 1.10.1 Improvements and new features

-

#### 1.10.2 Reported Fixed Bugs and Malfunctions

- [agent] The order in which the processes in the snmp agent where terminated was incorrect. This could, in some case's, lead to incoming request(s) being processed during the application termination phase. This, in turn, could lead to various process crashes (when expected resources where no longer available).
  Own Id: OTP-6805
  Aux Id: Seq 10717
- [agent] In version 4.9.4 some requests could be handled single threaded regardless of the value of the multi_thread config option.
  Own Id: OTP-6815
  Aux Id: Seq 10724

#### 1.10.3 Incompatibilities

-

### 1.11 SNMP Development Toolkit 4.9.4

Version 4.9.4 supports code replacement in run-time from/to version 4.9.3, 4.9.2, 4.9.1 and 4.9.

#### 1.11.1 Improvements and new features

- The snmp documentation source has been converted from SGML to XML.
  Own Id: OTP-6771

#### 1.11.2 Reported Fixed Bugs and Malfunctions

- [agent] Unexpected worker process termination. When the agent is multi-threaded (multi_thread = true), sending a request to the agent with an invalid context could lead to an unexpected worker process termination. This is a non-fatal problem since the master-agent would simply create a new worker process.
  Own Id: OTP-6784
  Aux Id: Seq 10689

#### 1.11.3 Incompatibilities

-

### 1.12 SNMP Development Toolkit 4.9.3

Version 4.9.3 supports code replacement in run-time from/to version 4.9.2, 4.9.1 and 4.9.

#### 1.12.1 Improvements and new features

-

#### 1.12.2 Reported Fixed Bugs and Malfunctions

- [agent] Changing own [usm] pass-phrase when agent is multi-threaded did not work.
  Scott Lystig Fritchie
  Martin Björklund
  Own Id: OTP-6712

#### 1.12.3 Incompatibilities

-

### 1.13 SNMP Development Toolkit 4.9.2

Version 4.9.2 supports code replacement in run-time from/to version 4.9.1, 4.9 & 4.8.4.

#### 1.13.1 Improvements and new features

-

#### 1.13.2 Reported Fixed Bugs and Malfunctions

- [agent] Incorrect default verbosity (trace) for target cache.
  Own Id: OTP-6571
  Aux Id: Seq 10437

#### 1.13.3 Incompatibilities

-

### 1.14 SNMP Development Toolkit 4.9.1

Version 4.9.1 supports code replacement in run-time from/to version 4.9 & 4.8.4.

#### 1.14.1 Improvements and new features

-

#### 1.14.2 Reported Fixed Bugs and Malfunctions

- [agent] Used wrong DEFVAL for vacmAccessStorageType (volatile instead of nonVolatile) in SNMP-VIEW-BASED-ACM-MIB.
  Martin Björklund
  Own Id: OTP-6569

#### 1.14.3 Incompatibilities

-

### 1.15 SNMP Development Toolkit 4.9

Version 4.9 supports code replacement in run-time from/to version 4.8.4, 4.8.3, 4.8.2, 4.8.1 and 4.8.

#### 1.15.1 Improvements and new features

- Added documentation for snmp:passwd2localized_key/3.
  Own Id: OTP-6540
- The snmp:config/0 utility function assumes by default current working dir as the directory to write config files. This is a problem since there are two files that share the same name, usm.conf, one for the agent and the other for the manager. Some extra checks has been added to be able warn the user about this possible conflict.
  Own Id: OTP-6532
- Minor documentation improvement for module snmp_generic.
  Own Id: OTP-6518
- [agent] Improve error handling of missing target params config.
  Own Id: OTP-6487
- Minor improvement to the mnesia snmp indexing.
  Own Id: OTP-6415
- Include the INET-ADDRESS-MIB mib in the SNMP application.
  Own Id: OTP-6383
- Added utility modules to read, write and update the config files of the agent and manager.
  Own Id: OTP-6318
- [agent] Improve behaviour during massive trap- sending. This is done in two way's:
  - Improving performance of the target(s) cache (which is used during trap/notification sending).
  - A slightly better flow control, making it more difficult to actually overload the agent.
  Own Id: OTP-6317
  Aux Id: Seq 10437

#### 1.15.2 Reported Fixed Bugs and Malfunctions

- Incorrect handling of decrypt failure resulting in incorrect error reporting. Applies to both the agent and the manager. Detected by dialyzer.
  Own Id: OTP-6533
- [manager] Invalid guard on function snmpm:agn/5 made it impossible to reach this particular clause. Detected by dialyzer.
  Own Id: OTP-6529
- Miscellaneous minor corrections, such as removing "dead code". Detected by dialyzer.
  Own Id: OTP-6515

#### 1.15.3 Incompatibilities

-

### 1.16 Release notes history

For information about older versions see release notes history.

snmp 4.12
Copyright © 1991-2008 Ericsson AB