File 2530-snmp-agent-doc-Updated-doc-for-send_notification2.patch of Package erlang
From 29890c5f91555c075b59023d2a7160eabb9793e2 Mon Sep 17 00:00:00 2001
From: Micael Karlberg <bmk@erlang.org>
Date: Wed, 18 Dec 2019 14:15:56 +0100
Subject: [PATCH 3/3] [snmp|agent|doc] Updated doc for send_notification2
Updated the doc for snmpa:send_notification2/3 with
regard to variable tagging (truncate).
OTP-16360
---
lib/snmp/doc/src/snmpa.xml | 23 +++++++++++++++++++----
1 file changed, 19 insertions(+), 4 deletions(-)
diff --git a/lib/snmp/doc/src/snmpa.xml b/lib/snmp/doc/src/snmpa.xml
index e5ed9d7a2b..6b12c091e2 100644
--- a/lib/snmp/doc/src/snmpa.xml
+++ b/lib/snmp/doc/src/snmpa.xml
@@ -998,7 +998,12 @@ snmp_agent:register_subagent(SA1,[1,2,3], SA2).
<v>Agent = pid() | atom()</v>
<v>Notification = atom()</v>
<v>SendOpts = [send_option()]</v>
- <v>send_option() = {receiver, receiver()} | {name, notify_name()} | {context, context_name()} | {varbinds, varbinds()} | {local_engine_id, string()} | {extra, extra_info()}</v>
+ <v>send_option() = {receiver, receiver()} |
+ {name, notify_name()} |
+ {context, context_name()} |
+ {varbinds, varbinds()} |
+ {local_engine_id, string()} |
+ {extra, extra_info()}</v>
<v>receiver() = no_receiver | {tag(), tag_receiver()} | notification_delivery_info()</v>
<v>tag() = term(()</v>
<v>tag_receiver() = pid() | registered_name() | {Mod, Func, Args}</v>
@@ -1009,8 +1014,12 @@ snmp_agent:register_subagent(SA1,[1,2,3], SA2).
<v>notify_name() = string()</v>
<v>context_name() = string()</v>
<v>varbinds() = [varbind()]</v>
- <v>varbind() = {variable(), value()} | {column(), row_index(), value()} | {oid(), value()}</v>
- <v>variable() = atom()</v>
+ <v>varbind() = {variable(), value()} |
+ {{process_oid(), variable()}, value()} |
+ {column(), row_index(), value()} |</v>
+ <v>variable() = aliasname() | oid()</v>
+ <v>aliasname() = atom()</v>
+ <v>process_oid() = keep (default) | truncate</v>
<v>value() = term()</v>
<v>column() = atom()</v>
<v>row_index() = [int()]</v>
@@ -1094,7 +1103,13 @@ snmp_agent:register_subagent(SA1,[1,2,3], SA2).
</list>
</item>
- </list>
+ </list>
+
+ <p>The 'process oid' "tag" that can be provided with the
+ variable name / oids is indended to be used for oid post
+ processing. The value '<c>keep</c>', which is the default, leaves
+ the oid as is. The value '<c>truncate</c>', will cause the oid
+ to be "truncated". That is, any trailing ".0" will be removed. </p>
<note>
<p>There is a way to exclude a varbind from the notification.
--
2.16.4