[snmp|doc] Updated documentation with new net-if option

Updated the documentation with info for the new agent net-if
option; open_err_filters
Note that this is of course only supported for the net-if
provided with the application.

OTO-18422 (ERIERL-873)

2 files changed, 58 insertions, 18 deletions

diff --git a/lib/snmp/doc/src/snmp_app.xml b/lib/snmp/doc/src/snmp_app.xml
index 87002e8189..9728b6e93a 100644
--- a/lib/snmp/doc/src/snmp_app.xml
+++ b/lib/snmp/doc/src/snmp_app.xml
@@ -4,7 +4,7 @@
 <appref>
   <header>
     <copyright>
-      <year>1997</year><year>2021</year>
+      <year>1997</year><year>2023</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -295,14 +295,15 @@ in the snmp_config file!
         <c><![CDATA[agent_net_if_options() = [agent_net_if_option()] <optional>]]></c></tag>
       <item>
 	<p><c>agent_net_if_option() =
-	{bind_to,         bind_to()} |  
-	{sndbuf,          sndbuf()} |  
-	{recbuf,          recbuf()} |  
-	{no_reuse,        no_reuse()} |  
-	{req_limit,       req_limit()} |
-	{filter,          agent_net_if_filter_options()} |
-	{extra_sock_opts, extra_socket_options()} |
-	{inet_backend,    inet | socket}</c></p>
+	{bind_to,          bind_to()} |  
+	{sndbuf,           sndbuf()} |  
+	{recbuf,           recbuf()} |  
+	{no_reuse,         no_reuse()} |  
+	{req_limit,        req_limit()} |
+	{filter,           agent_net_if_filter_options()} |
+	{open_err_filters, agent_net_if_open_err_filters()} |
+	{extra_sock_opts,  extra_socket_options()} |
+	{inet_backend,     inet | socket}</c></p>
 	<p>These options are actually specific to the used module.
 	The ones shown here are applicable to the default 
 	<c>agent_net_if_module()</c>.</p>
@@ -343,6 +344,25 @@ in the snmp_config file!
 	<p>Default is <c>snmpa_net_if_filter</c>.</p>
       </item>
 
+      <tag><marker id="agent_ni_open_err_filters"></marker>
+        <c><![CDATA[agent_net_if_open_err_filters() = [agent_net_if_open_err_filter()] <optional>]]></c></tag>
+      <item>
+	<p><c>agent_net_if_open_err_filter() = atom()</c></p>
+	<p>During agent initiation, the transports UDP sockets are opened.
+	If this operation fails, the net-if (and the agent) fails to start
+	(crash). This (filter) list contains error (reasons) that will
+	make net-if fail "nicely".
+	This (filter) list, is supposed to contain errors that can be
+	returned by
+	<seemfa marker="kernel:gen_udp#open/1">gen_udp:open/1,2</seemfa>.
+	The effect is that any error returned by
+	<seemfa marker="kernel:gen_udp#open/1">gen_udp:open</seemfa>
+	which *are* in this list, will be considered
+	"non-fatal" and will only result in an info message, rather than
+	an error message. Net If, and the agent, will still crash,
+	but will produce a less obnoxious message. </p>
+      </item>
+
       <tag><marker id="agent_mibs"></marker>
         <c><![CDATA[agent_mibs() = [string()] <optional>]]></c></tag>
       <item>
diff --git a/lib/snmp/doc/src/snmp_config.xml b/lib/snmp/doc/src/snmp_config.xml
index 4f3dcb6f02..c1c312a56e 100644
--- a/lib/snmp/doc/src/snmp_config.xml
+++ b/lib/snmp/doc/src/snmp_config.xml
@@ -4,7 +4,7 @@
 <chapter>
   <header>
     <copyright>
-      <year>1997</year><year>2021</year>
+      <year>1997</year><year>2023</year>
       <holder>Ericsson AB. All Rights Reserved.</holder>
     </copyright>
     <legalnotice>
@@ -281,14 +281,15 @@
         <c><![CDATA[agent_net_if_options() = [agent_net_if_option()] <optional>]]></c></tag>
       <item>
 	<p><c>agent_net_if_option() =
-	{bind_to,         bind_to()} |  
-	{sndbuf,          sndbuf()} |  
-	{recbuf,          recbuf()} |  
-	{no_reuse,        no_reuse()} | 
-	{req_limit,       req_limit()} |
-	{filter,          agent_net_if_filter_options()} |
-	{extra_sock_opts, extra_socket_options()} |
-	{inet_backend,    inet | socket}</c></p>
+	{bind_to,          bind_to()} |  
+	{sndbuf,           sndbuf()} |  
+	{recbuf,           recbuf()} |  
+	{no_reuse,         no_reuse()} | 
+	{req_limit,        req_limit()} |
+	{filter,           agent_net_if_filter_options()} |
+	{extra_sock_opts,  extra_socket_options()} |
+	{open_err_filters, agent_net_if_open_err_filters()} |
+	{inet_backend,     inet | socket}</c></p>
         <p>These options are actually specific to the used module.
 	The ones shown here are applicable to the default 
 	<c>agent_net_if_module()</c>.</p>
@@ -329,6 +330,25 @@
 	<p>Default is <c>snmpa_net_if_filter</c>.</p>
       </item>
 
+      <tag><marker id="agent_ni_open_err_filters"></marker>
+        <c><![CDATA[agent_net_if_open_err_filters() = [agent_net_if_open_err_filter()] <optional>]]></c></tag>
+      <item>
+	<p><c>agent_net_if_open_err_filter() = atom()</c></p>
+	<p>During agent initiation, the transports UDP sockets are opened.
+	If this operation fails, the net-if (and the agent) fails to start
+	(crash). This (filter) list contains error (reasons) that will
+	make net-if fail "nicely".
+	This (filter) list, is supposed to contain errors that can be
+	returned by
+	<seemfa marker="kernel:gen_udp#open/1">gen_udp:open/1,2</seemfa>.
+	The effect is that any error returned by
+	<seemfa marker="kernel:gen_udp#open/1">gen_udp:open</seemfa>
+	which *are* in this list, will be considered
+	"non-fatal" and will only result in an info message, rather than
+	an error message. Net If, and the agent, will still crash,
+	but will produce a less obnoxious message. </p>
+      </item>
+
       <tag><marker id="agent_mibs"></marker>
         <c><![CDATA[agent_mibs() = [string()] <optional>]]></c></tag>
       <item>