Added the documentation for the previous request API

(removed by misstake).

1 files changed, 281 insertions, 0 deletions

diff --git a/lib/snmp/doc/src/snmpm.xml b/lib/snmp/doc/src/snmpm.xml
index ff072205bc..b1c8e56721 100644
--- a/lib/snmp/doc/src/snmpm.xml
+++ b/lib/snmp/doc/src/snmpm.xml
@@ -538,6 +538,50 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	<p>For <c>SnmpInfo</c>, see the user callback function 
 	<seealso marker="snmpm_user#handle_report">handle_report</seealso>.</p>
 
+	<marker id="sync_get"></marker>
+      </desc>
+    </func>
+
+   <func>
+      <name>sync_get(UserId, TargetName, Oids) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get(UserId, TargetName, ContextName, Oids) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get(UserId, TargetName, Oids, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get(UserId, TargetName, ContextName, Oids, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get(UserId, TargetName, ContextName, Oids, Timeout, ExtraInfo) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <fsummary>Synchronous <c>get-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>ContextName = string()</v>
+        <v>Oids = [oid()]</v>
+        <v>Timeout = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>SnmpReply = snmp_reply()</v>
+        <v>Remaining = integer()</v>
+        <v>Reason = {send_failed, ReqId, R} | {invalid_sec_info, SecInfo, SnmpInfo} | term()</v>
+        <v>R = term()</v>
+        <v>SecInfo = [sec_info()]</v>
+        <v>sec_info() = {sec_tag(), ExpectedValue, ReceivedValue}</v>
+        <v>sec_tag() = atom()</v>
+        <v>ExpectedValue = ReceivedValue = term()</v>
+        <v>SnmpInfo = term()</v>
+      </type>
+      <desc>
+        <p>Synchronous <c>get-request</c>. </p>
+        <p><c>Remaining</c> is the remaining time of the given or 
+          default timeout time.</p>
+        <p>When <em>Reason</em> is <em>{send_failed, ...}</em> it means that
+          the net_if process failed to send the message. This could happen
+          because of any number of reasons, i.e. encoding error. <em>R</em> 
+          is the actual reason in this case. </p>
+        <p><c>ExtraInfo</c> is an opaque data structure passed on to
+          the net-if process. The net-if process included in this
+          application makes no use of this info, so the only use for it
+          in such a configuration (when using the built in net-if) would
+          be tracing.</p>
+        <p>For <c>SnmpInfo</c>, see the user callback function 
+          <seealso marker="snmpm_user#handle_report">handle_report</seealso>.</p>
+
         <marker id="async_get2"></marker>
       </desc>
     </func>
@@ -578,6 +622,40 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	for <em>this</em> request, they override any configuration done 
 	when the agent was registered. </p>
 
+        <marker id="async_get"></marker>
+      </desc>
+    </func>
+
+    <func>
+      <name>async_get(UserId, TargetName, Oids) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get(UserId, TargetName, ContextName, Oids) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get(UserId, TargetName, Oids, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get(UserId, TargetName, ContextName, Oids, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get(UserId, TargetName, ContextName, Oids, Expire, ExtraInfo) -> {ok, ReqId} | {error, Reason}</name>
+      <fsummary>Asynchronous <c>get-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>ContextName = string()</v>
+        <v>Oids = [oid()]</v>
+        <v>Expire = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>ReqId = term()</v>
+        <v>Reason = term()</v>
+      </type>
+      <desc>
+        <p>Asynchronous <c>get-request</c>.</p>
+        <p>The reply, if it arrives, will be delivered to the user 
+          through a call to the snmpm_user callback function 
+          <c>handle_pdu</c>.</p>
+        <p>The <c>Expire</c> time indicates for how long the request is 
+          valid (after which the manager is free to delete it).</p>
+        <p><c>ExtraInfo</c> is an opaque data structure passed on to
+          the net-if process. The net-if process included in this
+          application makes no use of this info, so the only use for it
+          in such a configuration (when using the built in net-if) would
+          be tracing.</p>
+
         <marker id="sync_get_next2"></marker>
       </desc>
     </func>
@@ -630,6 +708,42 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	<p>For <c>SnmpInfo</c>, see the user callback function 
 	<seealso marker="snmpm_user#handle_report">handle_report</seealso>.</p>
 
+	<marker id="sync_get_next"></marker>
+      </desc>
+    </func>
+
+    <func>
+      <name>sync_get_next(UserId, TargetName, Oids) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_next(UserId, TargetName, ContextName, Oids) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_next(UserId, TargetName, Oids, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_next(UserId, TargetName, ContextName, Oids, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_next(UserId, TargetName, ContextName, Oids, Timeout, ExtraInfo) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <fsummary>Synchronous <c>get-next-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>ContextName = string()</v>
+        <v>Oids = [oid()]</v>
+        <v>Timeout = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>SnmpReply = snmp_reply()</v>
+        <v>Remaining = integer()</v>
+        <v>Reason = {send_failed, ReqId, R} | {invalid_sec_info, SecInfo, SnmpInfo} | term()</v>
+        <v>R = term()</v>
+      </type>
+      <desc>
+        <p>Synchronous <c>get-next-request</c>. </p>
+        <p><c>Remaining</c> time of the given or default timeout time.</p>
+        <p>When <em>Reason</em> is <em>{send_failed, ...}</em> it means that
+          the net_if process failed to send the message. This could happen
+          because of any number of reasons, i.e. encoding error. <em>R</em> 
+          is the actual reason in this case. </p>
+        <p><c>ExtraInfo</c> is an opaque data structure passed on to
+          the net-if process. The net-if process included in this
+          application makes no use of this info, so the only use for it
+          in such a configuration (when using the built in net-if) would
+          be tracing.</p>
+
         <marker id="async_get_next2"></marker>
       </desc>
     </func>
@@ -667,6 +781,34 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	for <em>this</em> request, they override any configuration done 
 	when the agent was registered. </p>
 
+	<marker id="async_get_next"></marker>
+      </desc>
+    </func>
+
+    <func>
+      <name>async_get_next(UserId, TargetName, Oids) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_next(UserId, TargetName, ContextName, Oids) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_next(UserId, TargetName, Oids, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_next(UserId, TargetName, ContextName, Oids, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_next(UserId, TargetName, ContextName, Oids, Expire, ExtraInfo) -> {ok, ReqId} | {error, Reason}</name>
+      <fsummary>Asynchronous <c>get-next-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>ContextName = string()</v>
+        <v>Oids = [oid()]</v>
+        <v>Expire = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>ReqId = integer()</v>
+        <v>Reason = term()</v>
+      </type>
+      <desc>
+        <p>Asynchronous <c>get-next-request</c>. </p>
+        <p>The reply will be delivered to the user through a call
+	to the snmpm_user callback function <c>handle_pdu</c>.</p>
+        <p>The <c>Expire</c> time indicates for how long the request is 
+	valid (after which the manager is free to delete it).</p>
+
         <marker id="sync_set2"></marker>
       </desc>
     </func>
@@ -722,6 +864,44 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	<p>For <c>SnmpInfo</c>, see the user callback function 
 	<seealso marker="snmpm_user#handle_report">handle_report</seealso>.</p>
 
+	<marker id="sync_set"></marker>
+      </desc>
+    </func>
+
+    <func>
+      <name>sync_set(UserId, TargetName, VarsAndVals) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_set(UserId, TargetName, ContextName, VarsAndVals) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_set(UserId, TargetName, VarsAndVals, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_set(UserId, TargetName, ContextName, VarsAndVals, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_set(UserId, TargetName, ContextName, VarsAndVals, Timeout, ExtraInfo) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <fsummary>Synchronous <c>set-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>ContextName = string()</v>
+        <v>VarsAndVals = vars_and_vals()</v>
+        <v>Timeout = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>SnmpReply = snmp_reply()</v>
+        <v>Remaining = integer()</v>
+        <v>Reason = {send_failed, ReqId, ActualReason} | {invalid_sec_info, SecInfo, SnmpInfo} | term()</v>
+        <v>ActualReason = term()</v>
+      </type>
+      <desc>
+        <p>Synchronous <c>set-request</c>. </p>
+        <p><c>Remaining</c> time of the given or default timeout time.</p>
+        <p>When <em>Reason</em> is <em>{send_failed, ...}</em> it means that
+          the net_if process failed to send the message. This could happen
+          because of any number of reasons, i.e. encoding error. <em>R</em> 
+          is the actual reason in this case. </p>
+        <p>When <em>var_and_val()</em> is <em>{oid(), value()}</em>, the
+          manager makes an educated guess based on the loaded mibs. </p>
+        <p><c>ExtraInfo</c> is an opaque data structure passed on to
+          the net-if process. The net-if process included in this
+          application makes no use of this info, so the only use for it
+          in such a configuration (when using the built in net-if) would
+          be tracing.</p>
+
         <marker id="async_set2"></marker>
       </desc>
     </func>
@@ -764,6 +944,40 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	for <em>this</em> request, they override any configuration done 
 	when the agent was registered. </p>
 
+	<marker id="async_set"></marker>
+      </desc>
+    </func>
+
+    <func>
+      <name>async_set(UserId, TargetName, VarsAndVals) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_set(UserId, TargetName, ContextName, VarsAndVals) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_set(UserId, TargetName, VarsAndVals, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_set(UserId, TargetName, ContextName, VarsAndVals, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_set(UserId, TargetName, ContextName, VarsAndVals, Expire, ExtraInfo) -> {ok, ReqId} | {error, Reason}</name>
+      <fsummary>Asynchronous <c>set-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>VarsAndVals = vars_and_vals()</v>
+        <v>Expire = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>ReqId = term()</v>
+        <v>Reason = term()</v>
+      </type>
+      <desc>
+        <p>Asynchronous <c>set-request</c>. </p>
+        <p>The reply will be delivered to the user through a call
+          to the snmpm_user callback function <c>handle_pdu</c>.</p>
+        <p>The <c>Expire</c> time indicates for how long the request is 
+          valid (after which the manager is free to delete it).</p>
+        <p>When <em>var_and_val()</em> is <em>{oid(), value()}</em>, the
+          manager makes an educated guess based on the loaded mibs. </p>
+        <p><c>ExtraInfo</c> is an opaque data structure passed on to
+          the net-if process. The net-if process included in this
+          application makes no use of this info, so the only use for it
+          in such a configuration (when using the built in net-if) would
+          be tracing.</p>
+
         <marker id="sync_get_bulk2"></marker>
       </desc>
     </func>
@@ -818,6 +1032,43 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	<p>For <c>SnmpInfo</c>, see the user callback function 
 	<seealso marker="snmpm_user#handle_report">handle_report</seealso>.</p>
 
+	<marker id="sync_get_bulk"></marker>
+      </desc>
+    </func>
+
+    <func>
+      <name>sync_get_bulk(UserId, TragetName, NonRep, MaxRep, Oids) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_bulk(UserId, TragetName, NonRep, MaxRep, ContextName, Oids) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_bulk(UserId, TragetName, NonRep, MaxRep, Oids, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_bulk(UserId, TragetName, NonRep, MaxRep, ContextName, Oids, Timeout) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <name>sync_get_bulk(UserId, TragetName, NonRep, MaxRep, ContextName, Oids, Timeout, ExtraInfo) -> {ok, SnmpReply, Remaining} | {error, Reason}</name>
+      <fsummary>Synchronous <c>get-bulk-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>NonRep = integer()</v>
+        <v>MaxRep = integer()</v>
+        <v>ContextName = string()</v>
+        <v>Oids = [oid()]</v>
+        <v>Timeout = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>SnmpReply = snmp_reply()</v>
+        <v>Remaining = integer()</v>
+        <v>Reason = {send_failed, ReqId, R} | {invalid_sec_info, SecInfo, SnmpInfo} | term()</v>
+      </type>
+      <desc>
+        <p>Synchronous <c>get-bulk-request</c> (See RFC1905).</p>
+        <p><c>Remaining</c> time of the given or default timeout time.</p>
+        <p>When <em>Reason</em> is <em>{send_failed, ...}</em> it means that
+          the net_if process failed to send the message. This could happen
+          because of any number of reasons, i.e. encoding error. <em>R</em> 
+          is the actual reason in this case. </p>
+        <p><c>ExtraInfo</c> is an opaque data structure passed on to
+          the net-if process. The net-if process included in this
+          application makes no use of this info, so the only use for it
+          in such a configuration (when using the built in net-if) would
+          be tracing.</p>
+
         <marker id="async_get_bulk2"></marker>
       </desc>
     </func>
@@ -859,6 +1110,36 @@ priv_key = [integer()]   (length is 16 if priv = usmDESPrivProtocol | usmAesCfb1
 	for <em>this</em> request, they override any configuration done 
 	when the agent was registered. </p>
 
+	<marker id="async_get_bulk"></marker>
+      </desc>
+    </func>
+
+    <func>
+      <name>async_get_bulk(UserId, TargetName, NonRep, MaxRep, Oids) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_bulk(UserId, TargetName, NonRep, MaxRep, ContextName, Oids) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_bulk(UserId, TargetName, NonRep, MaxRep, Oids, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_bulk(UserId, TargetName, NonRep, MaxRep, ContextName, Oids, Expire) -> {ok, ReqId} | {error, Reason}</name>
+      <name>async_get_bulk(UserId, TargetName, NonRep, MaxRep, ContextName, Oids, Expire, ExtraInfo) -> {ok, ReqId} | {error, Reason}</name>
+      <fsummary>Asynchronous <c>get-bulk-request</c></fsummary>
+      <type>
+        <v>UserId = term()</v>
+        <v>TargetName = target_name()</v>
+        <v>NonRep = integer()</v>
+        <v>MaxRep = integer()</v>
+        <v>ContextName = string()</v>
+        <v>Oids = [oid()]</v>
+        <v>Expire = integer()</v>
+        <v>ExtraInfo = term()</v>
+        <v>ReqId = integer()</v>
+        <v>Reason = term()</v>
+      </type>
+      <desc>
+        <p>Asynchronous <c>get-bulk-request</c> (See RFC1905).</p>
+        <p>The reply will be delivered to the user through a call
+          to the snmpm_user callback function <c>handle_pdu</c>.</p>
+        <p>The <c>Expire</c> time indicates for how long the request is 
+          valid (after which the manager is free to delete it).</p>
+
         <marker id="cancel_async_request"></marker>
       </desc>
     </func>