## 1 SNMP Release Notes

### 1.1 SNMP Development Toolkit v4.1.1

Version 4.1.1 supports code replacement in runtime from/to version 4.1.
When performing a downgrade, make sure the verbosity of the manager server process is silence, or else the process will crash (due to a bug in version 4.0.4) and be restarted by it's supervisor.

#### 1.1.1 Improvements and new features

-

#### 1.1.2 Reported Fixed Bugs and Malfunctions

- [manager] Manager synchronous get-function with timeout erroneous. Results in a function clause.
  Own Id: OTP-5364
- Replace in decoder fun's of the "old style" fun format, {atom(), atom()}, with a proper fun, e.g. "fun the_function/1".
  Own Id: OTP-5365
- [manager] Register agent using the config file agents.conf failed due to incorrect function guard.
  Own Id: OTP-5367

#### 1.1.3 Incompatibilities

-

### 1.2 SNMP Development Toolkit v4.1.0

Version 4.1.0 supports code replacement in runtime from/to version 4.0.4.
When performing a downgrade, make sure the verbosity of the manager server process is silence, or else the process will crash (due to a bug in version 4.0.4) and be restarted by it's supervisor.

#### 1.2.1 Improvements and new features

- [manager] Added possibility to monitor a registered user. See snmpm:register_user_monitor.
  Own Id: OTP-5286
- [agent] Improved symbolic store. Alias and Oids where stored with similar key's (seperated by types: atom() and lists() respectively). Also added new function: snmpa:which_aliasnames.
  Own Id: OTP-5298
- [agent] The agent local_db volatile storage method uses an ets-table which is private. This table has been made protected in order to make it easier to bedug and test the snmp agent.
  Own Id: OTP-5308

#### 1.2.2 Reported Fixed Bugs and Malfunctions

- Misspelled deprecated function. Non-existent function snmp:is_constistent/1 was marked as depricated. Should have been snmp:is_consistent/1).
  Own Id: OTP-5273
- [agent] Unclear documentation for function snmpa:send_notification. The Recv argument (specifically the {M,F,A} variant).
  Own Id: OTP-5281
- [manager] It was never documented how the default user behaviour could be overriden (default user is the module snmpm_user_default). See application configuration or configuration params.
  Own Id: OTP-5299
- [manager] The server process contained a bug that caused it to crash, if it received an exit message from it's gct (GC timer) process and it's verbosity was log or higher.
  This also effects the application dowgrade.
  Own Id: OTP-5306
- [agent] The agent config file, target_addr.conf, was incorrectly described in the Target Address Definitions chapter of the User's Guide. The EngineId option was left out.
  Own Id: OTP-5307
  Aux Id: Seq 9689
- [manager] When a InformRequest is received, the manager sends a response message. This did not include the varbinds of the original message.
  See RFC 3416, chapter 4.2.7.
  Own Id: OTP-5314
- [manager] Erroneous function guards made it possible to update some agent info (that should be "static").
  Own Id: OTP-5315

#### 1.2.3 Incompatibilities

-

### 1.3 SNMP Development Toolkit v4.0.4

Version 4.0.4 supports code replacement in runtime from/to version 4.0.3, 4.0.2, 4.0.1 and 4.0.

#### 1.3.1 Improvements and new features

-

#### 1.3.2 Reported Fixed Bugs and Malfunctions

- [manager] The timeout calculation for the request gc timer incorrect.
  Own Id: OTP-5267

#### 1.3.3 Incompatibilities

-

### 1.4 SNMP Development Toolkit v4.0.3

Version 4.0.3 supports code replacement in runtime from/to version 4.0.2, 4.0.1 and 4.0.

#### 1.4.1 Improvements and new features

-

#### 1.4.2 Reported Fixed Bugs and Malfunctions

- [manager] Some basic SNMP types where not handled when performing set-requests (snmpm:s and snmpm:as): 'BITS' (b), 'IpAddress' (ip), 'Opaque' (op), 'Counter32' (c32), 'Counter64' (c64) and 'TimeTicks' (tt).
  Own Id: OTP-5256
- [manager] Unnecessary error message when receiving trap from unregistered agent or agent using other port then the request port for trap-sending.
  Own Id: OTP-5258

#### 1.4.3 Incompatibilities

-

### 1.5 SNMP Development Toolkit v4.0.2

Version 4.0.2 supports code replacement in runtime from/to version 4.0.1 and 4.0.

#### 1.5.1 Improvements and new features

- [manager] When the net_if process failed to send a message, for whatever reason, this is just dropped. And the user is "left hanging". Now, if the request is syncroneous, it will return with a proper reason (see snmpm:g, snmpm:gn and snmpm:s), and if the request was asynchroneous, the new callback function, handle_error (see snmpm_user) is called.
  Own Id: OTP-5242

#### 1.5.2 Reported Fixed Bugs and Malfunctions

- [manager] The arguments CtxName and Port was swapped in the function snmpm:g/6.
  Own Id: OTP-5225
- [manager] TRAP receive failes for unknown agent due to failing message size calculation.
  Own Id: OTP-5241

#### 1.5.3 Incompatibilities

- [manager] Introduced a new callback function in the behaviour snmpm_user.
  Own Id: OTP-5242

### 1.6 SNMP Development Toolkit v4.0.1

Version 4.0.1 supports code replacement in runtime from/to version 4.0.

#### 1.6.1 Improvements and new features

- [agent] Added functions to get a list of all mibs loaded into an agent (see snmpa:which_mibs) and to get the (full path) file name of a loaded mib (see snmpa:whereis_mib).
  Own Id: OTP-5187

#### 1.6.2 Reported Fixed Bugs and Malfunctions

- [manager] The wrong default value (1024) was used for the net-if option recbuf. If no value is specified, then the OS default shall be used.
  Own Id: OTP-5196

#### 1.6.3 Incompatibilities

-

### 1.7 SNMP Development Toolkit v4.0

#### 1.7.1 Improvements and new features

- [manager] Added a proper snmp manager.
  Major restructure of the application in order to incorporate the new manager.
- [agent] Add a `snmpa:get/3` with an extra `Context` argument. Also added similar `snmpa:get_next/2,3` functions. See snmpa:get and snmpa:get_next.
  Martin Björklund
  Own Id: OTP-5054
- [agent] Add notification filters. See snmpa_notification_filter, register_notification_filter, unregister_notification_filter and which_notification_filter.
  Own Id: OTP-5055
- [agent] Added two mib lookup functions, me_of and mib_of.
  Own Id: OTP-5082
  Aux Id: Seq 8848
- [compiler] The MIB compiler is now (source code) independent of the rest of the application (and vice versa).
- [compiler] DISPLAY-HINT and UNITS included in the compiled mib.
  Own Id: OTP-5053
- [compiler] Added compiler options `imports` and `module_identity` to include the imports list and module identity (only SMIv2) info in the compiled mib, see snmpc.
- [compiler] Added the MIB compiler option `+no_defs`, see snmpc.
  Martin Björklund
- [compiler] Added the MIB compiler option `+'{module, atom()}'`, see snmpc.
  Martin Björklund

#### 1.7.2 Reported Fixed Bugs and Malfunctions

- [agent] Failing MIB configure/reconfigure was difficult to diagnose. Added better error handling and verbosity.
- [compiler] Added "default value" for INTEGER with enumeration without a DEFVAL clause. The lowest valid integer value is choosen for the variable_info defval.
  Own Id: OTP-5124
  Aux Id: Seq 8738
- [compiler] Unnecssarily reserved words in the mib compiler can cause some enumeration definitions to fail.
  Martin Björklund
  Own Id: OTP-5066

#### 1.7.3 Incompatibilities

- New sys configuration format. Allthough the old configuration format still works (if only the agent is used), it is no longer documented and will eventually be eliminated. See application configuration or configuration params for more info.
- Three new interface modules have been introduced. One for each of the individual parts of the application:
  - [agent] `snmpa`
  - [manager] `snmpm`
  - [compiler] `snmpc`
  The primary interface module, `snmp`, still exist. It contains the application generic functions. The agent specific stuff still exist (for backward compatibillity reasons), but has been deprecated and will eventually be removed.
  Some previously already deprecated functions has been removed (since they in turn was dependent on deprecated functions, see calendar).
- [agent] The agent network interface api has changed. See snmp agent net if,
- [agent] The default agent audit trail log name has changed.
- [compiler] Mib format has changed (see OTP-5053 above).

### 1.8 Release notes history

For information about older versions see release notes history.

Copyright © 1991-2005 Ericsson AB