From 8c78ac1382f089167afbf8d794cb9eff834577bd Mon Sep 17 00:00:00 2001
From: Micael Karlberg 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. [compiler] The SMI specifies that a table row OID should be
+ named: { <tableIdentifier> "1" }. A new option has been introduced,
+ 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 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 - Version 4.16.1 supports code replacement in runtime from/to
diff --git a/lib/snmp/doc/src/notes_history.xml b/lib/snmp/doc/src/notes_history.xml
index 8739400773..934df87866 100644
--- a/lib/snmp/doc/src/notes_history.xml
+++ b/lib/snmp/doc/src/notes_history.xml
@@ -4,7 +4,7 @@
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
+ (due to a bug in version 4.0.4) and be restarted by its
supervisor.
+
+
+
+
+
+
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 + (due to a bug in version 4.0.4) and be restarted by its supervisor.
[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.
+ to crash, if it received an exit message from its gct (GC timer) + process and its verbosity was log or higher.This also effects the application downgrade.
Own Id: OTP-5306
Each snmp component has it's own set of configuration parameters, +
Each snmp component has its own set of configuration parameters, even though some of the types are common to both components.
@@ -346,7 +346,7 @@Defines if the mib server shall perform cache gc automatically or leave it to the user (see
-gc_mibs_cache/0,1,2,3 ).Default is
+false .Default is
true .@@ -693,7 +693,7 @@ 0 ]]> Specifies if and how the audit trail log shall be repaired when opened. Unless this parameter has the value
diff --git a/lib/snmp/doc/src/snmp_config.xml b/lib/snmp/doc/src/snmp_config.xml index 6fc9cc49f2..769b908adc 100644 --- a/lib/snmp/doc/src/snmp_config.xml +++ b/lib/snmp/doc/src/snmp_config.xml @@ -343,7 +343,7 @@snmp_repair it is sent todisk_log . If, on the other hand, the value is -snmp_repair , snmp attempts to handle certain faults on it's +snmp_repair , snmp attempts to handle certain faults on its own. And even if it cannot repair the file, it does not truncate it directly, but instead moves it aside for later off-line analysis.Defines if the mib server shall perform cache gc automatically or leave it to the user (see
-gc_mibs_cache/0,1,2,3 ).Default is
+false .Default is
true .@@ -704,7 +704,7 @@ 0 ]]> Specifies if and how the audit trail log shall be repaired when opened. Unless this parameter has the value
diff --git a/lib/snmp/doc/src/snmpa.xml b/lib/snmp/doc/src/snmpa.xml index b3661ae9b0..69fe6d62f4 100644 --- a/lib/snmp/doc/src/snmpa.xml +++ b/lib/snmp/doc/src/snmpa.xml @@ -4,7 +4,7 @@snmp_repair it is sent todisk_log . If, on the other hand, the value is -snmp_repair , snmp attempts to handle certain faults on it's +snmp_repair , snmp attempts to handle certain faults on its own. And even if it cannot repair the file, it does not truncate it directly, but instead moves it aside for later off-line analysis.- 2004 2009 +2004 2010 Ericsson AB. All Rights Reserved. @@ -13,12 +13,12 @@ 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. - + snmpa @@ -648,6 +648,20 @@ notification_delivery_info() = #snmpa_notification_delivery_info{}+ + + Disable the mib server cache.
++ + diff --git a/lib/snmp/doc/src/snmpa_network_interface_filter.xml b/lib/snmp/doc/src/snmpa_network_interface_filter.xml index d625fd3e4a..10419517dd 100644 --- a/lib/snmp/doc/src/snmpa_network_interface_filter.xml +++ b/lib/snmp/doc/src/snmpa_network_interface_filter.xml @@ -4,7 +4,7 @@which_mibs_cache_size() -> void() +which_mibs_cache_size(Agent) -> void() +The size of the mib server cache ++ +Agent = pid() | atom() ++ Retreive the size of the mib server cache.
+- 2007 2009 +2007 2010 Ericsson AB. All Rights Reserved. @@ -13,12 +13,12 @@ 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. - + snmpa_network_interface_filter @@ -153,7 +153,7 @@ pdu_type() = 'get-request' | 'get-next-request' | 'get-response' | 'set-request'For the message to be discarded all together, the function must return false.
Note that it is possible for this function to filter out targets - (but not add it's own) by returning an updated + (but not add its own) by returning an updated
diff --git a/lib/snmp/doc/src/snmpc.xml b/lib/snmp/doc/src/snmpc.xml index 48d63d6c91..fbd0950c69 100644 --- a/lib/snmp/doc/src/snmpc.xml +++ b/lib/snmp/doc/src/snmpc.xml @@ -4,7 +4,7 @@Targets list (NewTargets ).- 2004 2009 +2004 2010 Ericsson AB. All Rights Reserved. @@ -13,12 +13,12 @@ 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. - + snmpc @@ -47,9 +47,10 @@File = string() Options = [opt()] -opt() = db() | deprecated() | description() | reference() | group_check() | i() | il() | imports() | module() | module_identity() | outdir() | no_defs() | verbosity() | warnings() +opt() = db() | relaxed_row_name_assign_check() | deprecated() | description() | reference() | group_check() | i() | il() | imports() | module() | module_identity() | outdir() | no_defs() | verbosity() | warnings() db() = {db, volatile|persistent|mnesia} deprecated() = {deprecated, bool()} +relaxed_row_name_assign_check() = relaxed_row_name_assign_check description() = description reference() = reference group_check() = {group_check, bool()} @@ -71,75 +72,104 @@ compiled fileBinFileName is called.bin]]> .-
- The option
db specifies which database should - be used for the default instrumentation. Default is -volatile . +- +
+The option
+db specifies which database should + be used for the default instrumentation.Default is
+volatile .- +
-The option
+deprecated specifies if a deprecated + definition should be kept or not. If the option is + false the MIB compiler will ignore all deprecated + definitions.Default is
true .- The option
deprecated specifies if a deprecated - definition should be kept or not. If the option is - false the MIB compiler will ignore all deprecated - definitions. Default istrue . +- +
-The option
+relaxed_row_name_assign_check , if present, + specifies that the row name assign check shall not be done + strictly according to the SMI (which allows only the value 1). + With this option, all values greater than zero is allowed + (>= 1). This means that the error will be converted to a + warning.By default it is not included, but if this option is present + it will be.
- The option
description specifies if the text - of the DESCRIPTION field will be included or not. By default - it is not included, but if this option is present it will - be. +- +
-The option
+description specifies if the text + of the DESCRIPTION field will be included or not.By default it is not included, but if this option is + present it will be.
- The option
reference specifies if the text - of the REFERENCE field, when found in a table definition, - will be included or not. By default - it is not included, but if this option is present it will - be. The reference text will be placed in the allocList field - of the mib-entry record (#me{}) for the table. +- +
-The option
+reference specifies if the text + of the REFERENCE field, when found in a table definition, + will be included or not.By default it is not included, but if this option is present + it will be. The reference text will be placed in the allocList + field of the mib-entry record (#me{}) for the table.
- The option
group_check specifies whether the - mib compiler should check the OBJECT-GROUP macro and - the NOTIFICATION-GROUP macro for correctness or not. - Default istrue . +- +
-The option
+group_check specifies whether the + mib compiler should check the OBJECT-GROUP macro and + the NOTIFICATION-GROUP macro for correctness or not.Default is
true .- The option
i specifies the path to search for - imported (compiled) MIB files. The directories should be - strings with a trailing directory delimiter. Default is -["./"] . +- +
-The option
+i specifies the path to search for + imported (compiled) MIB files. The directories should be + strings with a trailing directory delimiter.Default is
["./"] .- The option
il (include_lib) also specifies a - list of directories to search for imported MIBs. It - assumes that the first element in the directory name - corresponds to an OTP application. The compiler will find - the current installed version. For example, the value - ["snmp/mibs/"] will be replaced by ["snmp-3.1.1/mibs/"] - (or what the current version may be in the system). The - current directory and the/priv/mibs/]]> - are always listed last in the include path. +- +
-The option
il (include_lib) also specifies a + list of directories to search for imported MIBs. It + assumes that the first element in the directory name + corresponds to an OTP application. The compiler will find + the current installed version. For example, the value + ["snmp/mibs/"] will be replaced by ["snmp-3.1.1/mibs/"] + (or what the current version may be in the system). The + current directory and the +/priv/mibs/]]> + are always listed last in the include path.- The option
imports , if present, specifies that the - IMPORT statement of the MIB shall be included in the compiled mib. +- +
-The option
imports , if present, specifies that + the IMPORT statement of the MIB shall be included in the + compiled mib.- The option
module , if present, specifies the - name of a module which implements all instrumentation - functions for the MIB. The name of all instrumentation - functions must be the same as the corresponding managed - object it implements. +- +
-The option
+module , if present, specifies the + name of a module which implements all instrumentation + functions for the MIB.The name of all instrumentation + functions must be the same as the corresponding managed + object it implements.
- The option
module_identity , if present, specifies - that the info part of the MODULE-IDENTITY statement of the MIB - shall be included in the compiled mib. +- +
-The option
module_identity , if present, specifies + that the info part of the MODULE-IDENTITY statement of the MIB + shall be included in the compiled mib.- The option
no_defs , if present, specifies - that if a managed object does not have an instrumentation - function, the default instrumentation function should NOT - be used, instead this is reported as an error, and the - compilation aborts. +- +
-The option
no_defs , if present, specifies + that if a managed object does not have an instrumentation + function, the default instrumentation function should NOT + be used, instead this is reported as an error, and the + compilation aborts.- The option
verbosity specifies the verbosity of - the SNMP mib compiler. I.e. if warning, info, log, debug - and trace messages shall be shown. Default issilence . - Note that if the optionwarnings istrue and the - optionverbosity issilence , warning messages will - still be shown. +- +
-The option
+verbosity specifies the verbosity of + the SNMP mib compiler. I.e. if warning, info, log, debug + and trace messages shall be shown.Default is
+silence .Note that if the option
warnings istrue and the + optionverbosity issilence , warning messages will + still be shown.- The option
warnings specifies whether warning - messages should be shown. Default istrue . +- +
The option
+warnings specifies whether warning + messages should be shown.Default is
true .The MIB compiler understands both SMIv1 and SMIv2 MIBs. It diff --git a/lib/snmp/doc/src/snmpm.xml b/lib/snmp/doc/src/snmpm.xml index 9e7ac75daf..1ee391d9ba 100644 --- a/lib/snmp/doc/src/snmpm.xml +++ b/lib/snmp/doc/src/snmpm.xml @@ -4,7 +4,7 @@
- 2004 2009 +2004 2010 Ericsson AB. All Rights Reserved. @@ -13,12 +13,12 @@ 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. - + snmpm @@ -920,7 +920,7 @@ priv_key = [integer()] (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1Oids = [oid()] - Transform a alias-name to it's oid.
+Transform a alias-name to its oid.
Note that an alias-name is only unique within the mib, so when loading several mib's into a manager, there might be several instances of the same aliasname.
@@ -938,7 +938,7 @@ priv_key = [integer()] (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1Reason = term() - -- cgit v1.2.3Transform a oid to it's aliasname.
+Transform a oid to its aliasname.