19962012 Ericsson AB. All Rights Reserved. The contents of this file are subject to the Erlang Public License, Version 1.1, (the "License"); you may not use this file except in compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. SNMP Release Notes notes.xml
SNMP Development Toolkit 4.22

Version 4.22 supports code replacement in runtime from/to version 4.21.7 4.21.6 4.21.5, 4.21.4, 4.21.3, 4.21.2, 4.21.1 and 4.21.

Improvements and new features

[manager] Introduced a new transport module, snmpm_net_if_mt, which handles all incomming and outgoing traffic in newly created processes. The message/request is processed and then the process exits.

Own Id: OTP-9876

Fixed Bugs and Malfunctions

-

Incompatibilities

-

SNMP Development Toolkit 4.21.5

Version 4.21.5 supports code replacement in runtime from/to version 4.21.4, 4.21.3, 4.21.2, 4.21.1, 4.21, 4.20.1 and 4.20.

Improvements and new features

[agent] Removed (more) use of old style tuple funs.

Own Id: OTP-9783

Fixed Bugs and Malfunctions

[agent] Repeated vacm table dumping fails due to file name conflict. When dumping the vacm table to disk, a temoporary file with a fixed name was used. If the table dumping (snmpa_vacm:dump_table/0) was initiated from several different processes in rapid succesion, the dumping could fail because the different processes was simultaniously trying to write to the same file. This problem has been eliminated by creating a unique name for the temporary file.

Own Id: OTP-9851

Aux Id: Seq 11980

Incompatibilities

-

SNMP Development Toolkit 4.21.4

This version has never been released for R14B.

Version 4.21.4 supports code replacement in runtime from/to version 4.21.3, 4.21.2, 4.21.1, 4.21, 4.20.1, 4.20 and 4.19.

Improvements and new features

-

Fixed Bugs and Malfunctions

[agent] Removed use of old style tuple funs.

Own Id: OTP-9779

Incompatibilities

-

SNMP Development Toolkit 4.21.3

Version 4.21.3 supports code replacement in runtime from/to version 4.21.2, 4.21.1, 4.21, 4.20.1, 4.20 and 4.19.

Improvements and new features

[compiler] Improved version info printout from the MIB compiler frontend escript.

Own Id: OTP-9618

Fixed Bugs and Malfunctions

[agent] Version 4.20 introduced a change that broke trap sending from subagents. Due to a bug in the test code, this was not discovered, until that bug was fixed.

Own Id: OTP-9745

[agent] When sending an error message (reply) regarding snmpUnknownPDUHandlers, the agent used the wrong OID.

Own Id: OTP-9747

[compiler] Fix the --warnings/--W option parsing in the snmpc wrapper (e)script. The short warning option was incorrectly --w, instead of as documented --W. This has now been corrected.

*** POTENTIAL INCOMPATIBILITY ***

Tuncer Ayaz

Own Id: OTP-9718

Incompatibilities

[compiler] The short warning option has been changed from --w to --W to comply with the documentation.

Tuncer Ayaz

Own Id: OTP-9718

SNMP Development Toolkit 4.21.2

Version 4.21.2 supports code replacement in runtime from/to version 4.21.1, 4.21, 4.20.1, 4.20 and 4.19.

Improvements and new features

-

Fixed Bugs and Malfunctions

Bad note store GC timer deactivation. Wrong field in the state record was set (timeout instead active).

Stefan Grundmann

Own Id: OTP-9690

Incompatibilities

-

SNMP Development Toolkit 4.21.1

Version 4.21.1 supports code replacement in runtime from/to version 4.20.1, 4.20 and 4.19.

Improvements and new features

[compiler] Used wrong variable name (for warnings-as-errors variable), which caused the compiler to crash when using the snmpc (e)script.

Also added the option --Werror for the SNMP MIB compiler (escript) frontend (to mimic erlc), which specifies whether warnings should be treated as errors.

Own Id: OTP-9447

[agent] Some very minor debugging improvements.

Own Id: OTP-9446

Fixed Bugs and Malfunctions

-

Incompatibilities

-

SNMP Development Toolkit 4.21

Version 4.21 supports code replacement in runtime from/to version 4.20.1, 4.20 and 4.19.

Improvements and new features

[manager] There was no way to specify transport domain. The transport domains was assumed to be IPv4 (transportDomainUdpIpv4). This has now been changed so that it can also be IPv6 (transportDomainUdpIpv6). To facilitate this, the transport domain, tdomain, is now a (new) valid option when registering a new agent (and updating agent info).

This also mean that the transport behaviour has changed.

Own Id: OTP-9305

Aux Id: Seq 11847

[compiler] Added the option warnings_as_errors (for the SNMP MIB compiler (escript) frontend, the option --wae is used) which specifies whether warnings should be treated as errors.

Tuncer Ayaz

Own Id: OTP-9437

Fixed Bugs and Malfunctions

The snmp config tool could not handle (manager) audit trail config because the option seqno was not handled.

Own Id: OTP-9354

[agent] The SNMP ACM cache was not properly updated when changes where made to the VACM security-to-group, access and view-tree-family tables.

Own Id: OTP-9367

Aux Id: Seq 11858

Fixed install directory typo for man3.

Peter Lemenkov

Hans Ulrich Niedermann

Own Id: OTP-9442

Incompatibilities

-

SNMP Development Toolkit 4.20.1

Version 4.20.1 supports code replacement in runtime from/to version 4.20, 4.19 and 4.18.

Improvements and new features

-

Fixed Bugs and Malfunctions

[agent] Did not handle transport domains properly in some cases, for instance trap sending.

Own Id: OTP-9400

[agent] Wrong default transport domain, snmpUDPDomain, instead of transportDomainUdpIpv4.

Own Id: OTP-9425

Aux Id: Seq 11874

Incompatibilities

-

SNMP Development Toolkit 4.20

Version 4.20 supports code replacement in runtime from/to version 4.19 and 4.18.

Improvements and new features

[agent] Added support for sending traps to IPv6 targets.

See the target address config file, the target_addr_entry/11 function or add_addr/11 for more info.

Own Id: OTP-9088

Aux Id: Seq 11790

[agent] To be able to handle multiple engine-id(s) when sending trap(s), the function add_community/6 has been added.

Own Id: OTP-9119

Aux Id: Seq 11792

[manager] The API for snmp requests has been augmented to allow the caller to override some configuration.

This has been done by introducing a new set of API functions, see sync_get2/3,4, async_get2/3,4, sync_get_next2/3,4, async_get_next2/3,4, sync_get_bulk2/5,6, async_get_bulk2/5,6, sync_set2/3,4 and async_set2/3,4 for more info.

Own Id: OTP-9162

[manager] The old API functions (for get and set requests: snmpm:g/3,4,5,6,7, snmpm:ag/3,4,5,6,7, snmpm:gn/3,4,5,6,7, snmpm:agn/3,4,5,6,7, snmpm:s/3,4,5,6,7, snmpm:s/3,4,5,6,7, snmpm:gb/5,6,7,8,9 and snmpm:agb/5,6,7,8,9) are now officially deprecated. They will be removed as of R16B.

Own Id: OTP-9174

[agent] Pass extra info through the agent to the net-if process when sending notifications.

See snmpa:send_notification2/3 for more info. See also the incomming net-if messages when sending a trap (send_pdu message) and notification (send_pdu_req message).

Own Id: OTP-9183

Aux Id: Seq 11817

Added type specs for functions that do not return.

Kostis Sagonas

Own Id: OTP-9208

Fixed Bugs and Malfunctions

Fixed endode/decode of values of type Counter32.

This type (Counter32) is an unsigned integer 32, but is actually encoded as an signed integer 32. The encode/decode functions however, treated it as if it was encodeded as an unsigned integer 32.

Own Id: OTP-9022

Incompatibilities

-

SNMP Development Toolkit 4.19

Version 4.19 supports code replacement in runtime from/to version 4.18.

Improvements and new features

[compiler] Added support for textual convention AGENT-CAPABILITIES and "full" support for textual convention MODULE-COMPLIANCE, both defined by the SNMPv2-CONF mib.

The reference and modules part(s) are stored in the assocList of the mib-entry (me) record. Only handled if the option(s) agent_capabilities and module_compliance (respectively) are provided to the compiler.

See compile/2 for more info.

For backward compatibillity, the MIBs provided with this application are not compiled with these options.

Own Id: OTP-8966

[agent] Added a "complete" set of (snmp) table and variable print functions, for each mib handled by the SNMP (agent) application. This will be usefull when debugging a running agent.

See print_mib_info/0, print_mib_tables/0 and print_mib_variables/0 for more info.

Own Id: OTP-8977

[compiler] Added a MIB compiler (frontend) escript, snmpc.

Own Id: OTP-9004

Fixed Bugs and Malfunctions

[agent] For the table vacmAccessTable, when performing the is_set_ok and set operation(s), all values of the vacmAccessSecurityModel column was incorrectly translated to any.

Own Id: OTP-8980

[agent] When calling snmp_view_based_acm_mib:reconfigure/1 on a running node, the table vacmAccessTable was not properly cleaned. This meant that if some entries in the vacm.conf file was removed (compared to the current config), while others where modified and/or added, the removed entrie(s) would still exist in the vacmAccessTable table.

Own Id: OTP-8981

Aux Id: Seq 11750

Incompatibilities

-

SNMP Development Toolkit 4.18

Version 4.18 supports code replacement in runtime from/to version 4.17.1 and 4.17.

Improvements and new features

Prepared for R14B release.

Fixed Bugs and Malfunctions

-

Incompatibilities

-

SNMP Development Toolkit 4.17.1

Version 4.17.1 supports code replacement in runtime from/to version 4.17, 4.16.2, 4.16.1, 4.16, 4.15, 4.14 and 4.13.5.

Improvements and new features

-

Reported Fixed Bugs and Malfunctions

When the function FilterMod:accept_recv/2 returned false the SNMP agent stopped collecting messages from UDP.

Own Id: OTP-8761

Incompatibilities

-

SNMP Development Toolkit 4.17

Version 4.17 supports code replacement in runtime from/to version 4.16.2, 4.16.1, 4.16, 4.15, 4.14 and 4.13.5.

Improvements and new features

[agent] Added very basic support for multiple SNMPv3 EngineIDs in a single agent. See send_notification/7, process_packet/7, generate_response_msg/6 or generate_msg/6 for more info.

Own Id: OTP-8478

Reported Fixed Bugs and Malfunctions

-

Incompatibilities

-

SNMP Development Toolkit 4.16.2

Version 4.16.2 supports code replacement in runtime from/to version 4.16.1, 4.16, 4.15, 4.14 and 4.13.5.

Improvements and new features

[compiler] The SMI specifies that a table row OID should be named: { <tableIdentifier> "1" }.

A new option has been introduced, relaxed_row_name_assign_check, that allows for a more liberal numbering scheme

Own Id: OTP-8574

[agent|manager] Changes to make snmp (forward) compatible with the new version of the crypto application (released in R14). As of R14, crypto is implemented using NIFs. Also, the API is more strict.

Own Id: OTP-8594

Auto [agent] Changed default value for the MIB server cache. GC is now on by default.

Own Id: OTP-8648

Reported Fixed Bugs and Malfunctions

Encode/decode of Counter64 values larger than 16#7fffffffffffffff (9223372036854775807) failed.

Own Id: OTP-8563

[compiler] Fails to compile non-contiguous BITS.

Per Hedeland

Own Id: OTP-8595

[manager] Raise condition causing the manager server process to crash. Unregistering an agent while traffic (set/get-operations) is ongoing could cause a crash in the manager server process (raise condition).

Own Id: OTP-8646

Aux Id: Seq 11585

Incompatibilities

-

SNMP Development Toolkit 4.16.1

Version 4.16.1 supports code replacement in runtime from/to version 4.16, 4.15, 4.14 and 4.13.5.

Improvements and new features

-

Reported Fixed Bugs and Malfunctions

[manager] Fixed an upgrade/downgrade problem.

Upgrade/downgrade from/to 4.13.5 did not work for the net-if process. This has now been fixed.

Own Id: OTP-8481

[agent] A minor mnesia related performance improvement.

Own Id: OTP-8480

Incompatibilities

-

SNMP Development Toolkit 4.16

Version 4.16 supports code replacement in runtime from/to version 4.15, 4.14 and 4.13.5.

Improvements and new features

[agent|manager] Entries in the audit trail log can now be augmented by a sequence number.

This is enabled by the seqno option, which is part of the Audit Trail Log config option.

See the reference manual or the Configuring the application chapter of the User's Guide for further info.

Own Id: OTP-8395

Reported Fixed Bugs and Malfunctions

[manager] Registration of agents using the config file, agents.conf, does not work. This has now been corrected.

Per Hedeland

Own Id: OTP-8442

The config utility (snmp:config/0) generated a default notify.conf with a bad name for the standard trap entry (was "stadard trap", but should have been "standard trap"). This has been corrected.

Kenji Rikitake

Own Id: OTP-8433

Incompatibilities

-

SNMP Development Toolkit 4.15

Version 4.15 supports code replacement in runtime from/to version 4.14 and 4.13.5.

Improvements and new features

The documentation is now built with open source tools (xsltproc and fop) that exists on most platforms. One visible change is that the frames are removed.

Own Id: OTP-8249

Reported Fixed Bugs and Malfunctions

[manager] When information from an unknown agent is received, it was previously delivered to the default user via calls to all the functions of the callback API depending on the info type (pdu, trap, report or inform). The problem was that the TargetName argument was useless in this case (only an already known agent has a known/valid TargetName, but the TargetName used in these calls was generated "on the fly").

This has now been changed so that when a message is received from an unknown agent, then only handle_agent (for the default user) is called, but now this call also has a Type argument, which is pdu | trap | report | inform, depending on what kind of message was actually received, thus making it possible for the user to properly analyze the data received.

To handle this, the snmpm_user behaviour has been updated.

*** POTENTIAL INCOMPATIBILITY ***

Own Id: OTP-8229