Merge branch 'debian/master' into ubuntu/master

author: Sebastien Bacher <seb128@ubuntu.com> 2021-01-11 18:07:03 +0100
committer: Sebastien Bacher <seb128@ubuntu.com> 2021-01-11 18:15:57 +0100
commit: 2567f558da3eb9911678227d4aeb15162e707d89 (patch)
tree: 13c80b0e091c8ba585b14b966cda998f95f1936d /docs/libnm/html/NMSettingIPConfig.html
parent: 02d99ffd62ede29cffcb45fcbe33d044b7406d3a (diff)
parent: f54032b30e1ddd84f10a339e0caf493772e049a7 (diff)
1 files changed, 306 insertions, 148 deletions
diff --git a/docs/libnm/html/NMSettingIPConfig.html b/docs/libnm/html/NMSettingIPConfig.html
index f78f2186..06bb11e3 100644
--- a/docs/libnm/html/NMSettingIPConfig.html
+++ b/docs/libnm/html/NMSettingIPConfig.html
@@ -8,7 +8,7 @@
 <link rel="up" href="ch03.html" title="Connection and Setting API Reference">
 <link rel="prev" href="NMSettingIP6Config.html" title="NMSettingIP6Config">
 <link rel="next" href="NMSettingIPTunnel.html" title="NMSettingIPTunnel">
-<meta name="generator" content="GTK-Doc V1.32 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -848,14 +848,6 @@ addressing, routing, and name service properties</p>
 </tr>
 <tr>
 <td class="function_type">
-<span class="returnvalue">int</span>
-</td>
-<td class="function_name">
-<a class="link" href="NMSettingIPConfig.html#nm-setting-ip-config-next-valid-dns-option" title="nm_setting_ip_config_next_valid_dns_option ()">nm_setting_ip_config_next_valid_dns_option</a> <span class="c_punctuation">()</span>
-</td>
-</tr>
-<tr>
-<td class="function_type">
 <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 </td>
 <td class="function_name">
@@ -1131,6 +1123,37 @@ addressing, routing, and name service properties</p>
 <a class="link" href="NMSettingIPConfig.html#nm-setting-ip-config-get-dhcp-hostname-flags" title="nm_setting_ip_config_get_dhcp_hostname_flags ()">nm_setting_ip_config_get_dhcp_hostname_flags</a> <span class="c_punctuation">()</span>
 </td>
 </tr>
+<tr>
+<td class="function_type">const <span class="returnvalue">char</span> *const *
+</td>
+<td class="function_name">
+<a class="link" href="NMSettingIPConfig.html#nm-setting-ip-config-get-dhcp-reject-servers" title="nm_setting_ip_config_get_dhcp_reject_servers ()">nm_setting_ip_config_get_dhcp_reject_servers</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="NMSettingIPConfig.html#nm-setting-ip-config-add-dhcp-reject-server" title="nm_setting_ip_config_add_dhcp_reject_server ()">nm_setting_ip_config_add_dhcp_reject_server</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="NMSettingIPConfig.html#nm-setting-ip-config-remove-dhcp-reject-server" title="nm_setting_ip_config_remove_dhcp_reject_server ()">nm_setting_ip_config_remove_dhcp_reject_server</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="function_type">
+<span class="returnvalue">void</span>
+</td>
+<td class="function_name">
+<a class="link" href="NMSettingIPConfig.html#nm-setting-ip-config-clear-dhcp-reject-servers" title="nm_setting_ip_config_clear_dhcp_reject_servers ()">nm_setting_ip_config_clear_dhcp_reject_servers</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -1150,13 +1173,13 @@ addressing, routing, and name service properties</p>
 <td class="property_flags">Read / Write</td>
 </tr>
 <tr>
-<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
+<td class="property_type"><span class="type">int</span></td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dad-timeout" title="The “dad-timeout” property">dad-timeout</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
 <tr>
 <td class="property_type">
-<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">char</span> *</td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-hostname" title="The “dhcp-hostname” property">dhcp-hostname</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
@@ -1167,17 +1190,22 @@ addressing, routing, and name service properties</p>
 </tr>
 <tr>
 <td class="property_type">
-<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">char</span> *</td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-iaid" title="The “dhcp-iaid” property">dhcp-iaid</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
 <tr>
+<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td>
+<td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-reject-servers" title="The “dhcp-reject-servers” property">dhcp-reject-servers</a></td>
+<td class="property_flags">Read / Write</td>
+</tr>
+<tr>
 <td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-send-hostname" title="The “dhcp-send-hostname” property">dhcp-send-hostname</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
 <tr>
-<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
+<td class="property_type"><span class="type">int</span></td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-timeout" title="The “dhcp-timeout” property">dhcp-timeout</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
@@ -1192,7 +1220,7 @@ addressing, routing, and name service properties</p>
 <td class="property_flags">Read / Write</td>
 </tr>
 <tr>
-<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td>
+<td class="property_type"><span class="type">int</span></td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dns-priority" title="The “dns-priority” property">dns-priority</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
@@ -1203,7 +1231,7 @@ addressing, routing, and name service properties</p>
 </tr>
 <tr>
 <td class="property_type">
-<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">char</span> *</td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--gateway" title="The “gateway” property">gateway</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
@@ -1224,7 +1252,7 @@ addressing, routing, and name service properties</p>
 </tr>
 <tr>
 <td class="property_type">
-<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
+<span class="type">char</span> *</td>
 <td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--method" title="The “method” property">method</a></td>
 <td class="property_flags">Read / Write</td>
 </tr>
@@ -1426,6 +1454,10 @@ addressing, routing, and name service properties</p>
 </tr>
 <tr>
 <td class="define_keyword">#define</td>
+<td class="function_name"><a class="link" href="NMSettingIPConfig.html#NM-SETTING-IP-CONFIG-DHCP-REJECT-SERVERS:CAPS" title="NM_SETTING_IP_CONFIG_DHCP_REJECT_SERVERS">NM_SETTING_IP_CONFIG_DHCP_REJECT_SERVERS</a></td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
 <td class="function_name"><a class="link" href="NMSettingIPConfig.html#NM-SETTING-IP-CONFIG-ROUTING-RULES:CAPS" title="NM_SETTING_IP_CONFIG_ROUTING_RULES">NM_SETTING_IP_CONFIG_ROUTING_RULES</a></td>
 </tr>
 <tr>
@@ -1581,7 +1613,7 @@ nm_ip_address_new (<em class="parameter"><code><span class="type">int</span> fam
 <div class="refsect3">
 <a name="nm-ip-address-new.returns"></a><h4>Returns</h4>
 <p>the new <a class="link" href="NMSettingIPConfig.html#NMIPAddress"><span class="type">NMIPAddress</span></a> object, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -1632,7 +1664,7 @@ correct size for <em class="parameter"><code>family</code></em>
 <div class="refsect3">
 <a name="nm-ip-address-new-binary.returns"></a><h4>Returns</h4>
 <p>the new <a class="link" href="NMSettingIPConfig.html#NMIPAddress"><span class="type">NMIPAddress</span></a> object, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -1788,7 +1820,7 @@ nm_ip_address_dup (<em class="parameter"><code><a class="link" href="NMSettingIP
 <a name="nm-ip-address-dup.returns"></a><h4>Returns</h4>
 <p>a copy of <em class="parameter"><code>address</code></em>
 . </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2028,7 +2060,7 @@ nm_ip_address_get_attribute_names (<em class="parameter"><code><a class="link" h
 <div class="refsect3">
 <a name="nm-ip-address-get-attribute-names.returns"></a><h4>Returns</h4>
 <p>a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of attribute names,. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2069,7 +2101,7 @@ on
 <em class="parameter"><code>address</code></em>
 , or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>address</code></em>
 has no such attribute. </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2103,7 +2135,7 @@ nm_ip_address_set_attribute (<em class="parameter"><code><a class="link" href="N
 <tr>
 <td class="parameter_name"><p>value</p></td>
 <td class="parameter_description"><p>the value. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -2166,7 +2198,7 @@ nm_ip_route_new (<em class="parameter"><code><span class="type">int</span> famil
 <div class="refsect3">
 <a name="nm-ip-route-new.returns"></a><h4>Returns</h4>
 <p>the new <a class="link" href="NMSettingIPConfig.html#NMIPRoute"><span class="type">NMIPRoute</span></a> object, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2230,7 +2262,7 @@ point to buffers of the correct size for <em class="parameter"><code>family</cod
 <div class="refsect3">
 <a name="nm-ip-route-new-binary.returns"></a><h4>Returns</h4>
 <p>the new <a class="link" href="NMSettingIPConfig.html#NMIPRoute"><span class="type">NMIPRoute</span></a> object, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2345,7 +2377,7 @@ to.</p></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>cmp_flags</p></td>
-<td class="parameter_description"><p>tune how to compare attributes. Currently only
+<td class="parameter_description"><p>tune how to compare attributes. Currently, only
 NM_IP_ROUTE_EQUAL_CMP_FLAGS_NONE (0) and NM_IP_ROUTE_EQUAL_CMP_FLAGS_WITH_ATTRS (1)
 is supported.</p></td>
 <td class="parameter_annotations"> </td>
@@ -2385,7 +2417,7 @@ nm_ip_route_dup (<em class="parameter"><code><a class="link" href="NMSettingIPCo
 <a name="nm-ip-route-dup.returns"></a><h4>Returns</h4>
 <p>a copy of <em class="parameter"><code>route</code></em>
 . </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2820,7 +2852,7 @@ nm_ip_route_get_attribute_names (<em class="parameter"><code><a class="link" hre
 <div class="refsect3">
 <a name="nm-ip-route-get-attribute-names.returns"></a><h4>Returns</h4>
 <p>a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of attribute names. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2861,7 +2893,7 @@ on
 <em class="parameter"><code>route</code></em>
 , or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>route</code></em>
 has no such attribute. </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -2895,7 +2927,7 @@ nm_ip_route_set_attribute (<em class="parameter"><code><a class="link" href="NMS
 <tr>
 <td class="parameter_name"><p>value</p></td>
 <td class="parameter_description"><p>the value. </p></td>
-<td class="parameter_annotations"><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 </tr>
 </tbody>
 </table></div>
@@ -2992,7 +3024,7 @@ nm_ip_routing_rule_new (<em class="parameter"><code><span class="type">int</span
 <a name="nm-ip-routing-rule-new.returns"></a><h4>Returns</h4>
 <p>a newly created rule instance with the
 provided address family. The instance is unsealed. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -3022,7 +3054,7 @@ nm_ip_routing_rule_new_clone (<em class="parameter"><code>const <a class="link"
 the same settings as <em class="parameter"><code>rule</code></em>
 . Note that the instance will
 always be unsealred. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -3053,7 +3085,7 @@ This is not thread-safe.</p>
 <p>the <em class="parameter"><code>self</code></em>
 argument with incremented
 reference count. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -3709,7 +3741,7 @@ nm_ip_routing_rule_get_from (<em class="parameter"><code>const <a class="link" h
 <a name="nm-ip-routing-rule-get-from.returns"></a><h4>Returns</h4>
 <p>the set from/src parameter or
 <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, if no value is set. </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -3802,7 +3834,7 @@ nm_ip_routing_rule_get_to (<em class="parameter"><code>const <a class="link" hre
 <a name="nm-ip-routing-rule-get-to.returns"></a><h4>Returns</h4>
 <p>the set to/dst parameter or
 <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, if no value is set. </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -3870,7 +3902,7 @@ nm_ip_routing_rule_get_iifname (<em class="parameter"><code>const <a class="link
 <div class="refsect3">
 <a name="nm-ip-routing-rule-get-iifname.returns"></a><h4>Returns</h4>
 <p>the set iifname or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if unset. </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -3931,7 +3963,7 @@ nm_ip_routing_rule_get_oifname (<em class="parameter"><code>const <a class="link
 <div class="refsect3">
 <a name="nm-ip-routing-rule-get-oifname.returns"></a><h4>Returns</h4>
 <p>the set oifname or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if unset. </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -4242,7 +4274,7 @@ string conversion.</p></td>
 <tr>
 <td class="parameter_name"><p>extra_args</p></td>
 <td class="parameter_description"><p>extra arguments for controlling the string
-conversion. Currently not extra arguments are supported. </p></td>
+conversion. Currently, not extra arguments are supported. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 </tr>
 <tr>
@@ -4256,7 +4288,7 @@ conversion. Currently not extra arguments are supported. </p></td>
 <div class="refsect3">
 <a name="nm-ip-routing-rule-from-string.returns"></a><h4>Returns</h4>
 <p>the new <a class="link" href="NMSettingIPConfig.html#NMIPRoutingRule"><span class="type">NMIPRoutingRule</span></a> or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -4291,7 +4323,7 @@ string conversion.</p></td>
 <tr>
 <td class="parameter_name"><p>extra_args</p></td>
 <td class="parameter_description"><p>extra arguments for controlling the string
-conversion. Currently not extra arguments are supported. </p></td>
+conversion. Currently, not extra arguments are supported. </p></td>
 <td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
 </tr>
 <tr>
@@ -4305,7 +4337,7 @@ conversion. Currently not extra arguments are supported. </p></td>
 <div class="refsect3">
 <a name="nm-ip-routing-rule-to-string.returns"></a><h4>Returns</h4>
 <p>the string representation or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p>
-<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -4799,43 +4831,6 @@ nm_setting_ip_config_get_dns_option (<em class="parameter"><code><a class="link"
 </div>
 <hr>
 <div class="refsect2">
-<a name="nm-setting-ip-config-next-valid-dns-option"></a><h3>nm_setting_ip_config_next_valid_dns_option ()</h3>
-<pre class="programlisting"><span class="returnvalue">int</span>
-nm_setting_ip_config_next_valid_dns_option
-                               (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>,
-                                <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> idx</code></em>);</pre>
-<div class="refsect3">
-<a name="nm-setting-ip-config-next-valid-dns-option.parameters"></a><h4>Parameters</h4>
-<div class="informaltable"><table class="informaltable" width="100%" border="0">
-<colgroup>
-<col width="150px" class="parameters_name">
-<col class="parameters_description">
-<col width="200px" class="parameters_annotations">
-</colgroup>
-<tbody>
-<tr>
-<td class="parameter_name"><p>setting</p></td>
-<td class="parameter_description"><p>the <a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a></p></td>
-<td class="parameter_annotations"> </td>
-</tr>
-<tr>
-<td class="parameter_name"><p>idx</p></td>
-<td class="parameter_description"><p>index to start the search from</p></td>
-<td class="parameter_annotations"> </td>
-</tr>
-</tbody>
-</table></div>
-</div>
-<div class="refsect3">
-<a name="nm-setting-ip-config-next-valid-dns-option.returns"></a><h4>Returns</h4>
-<p> the index, greater or equal than <em class="parameter"><code>idx</code></em>
-, of the first valid
-DNS option, or -1 if no valid option is found</p>
-</div>
-<p class="since">Since: 1.2</p>
-</div>
-<hr>
-<div class="refsect2">
 <a name="nm-setting-ip-config-add-dns-option"></a><h3>nm_setting_ip_config_add_dns_option ()</h3>
 <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 nm_setting_ip_config_add_dns_option (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>,
@@ -5056,7 +5051,7 @@ nm_setting_ip_config_get_address (<em class="parameter"><code><a class="link" hr
 <a name="nm-setting-ip-config-get-address.returns"></a><h4>Returns</h4>
 <p>the address at index <em class="parameter"><code>idx</code></em>
 . </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -5267,7 +5262,7 @@ nm_setting_ip_config_get_route (<em class="parameter"><code><a class="link" href
 <a name="nm-setting-ip-config-get-route.returns"></a><h4>Returns</h4>
 <p>the route at index <em class="parameter"><code>idx</code></em>
 . </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 </div>
 <hr>
@@ -5517,7 +5512,7 @@ nm_setting_ip_config_get_routing_rule (<em class="parameter"><code><a class="lin
 <a name="nm-setting-ip-config-get-routing-rule.returns"></a><h4>Returns</h4>
 <p>the routing rule at index <em class="parameter"><code>idx</code></em>
 . </p>
-<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
+<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
 </div>
 <p class="since">Since: 1.18</p>
 </div>
@@ -5898,12 +5893,138 @@ property.</p>
 </div>
 <p class="since">Since: 1.22</p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="nm-setting-ip-config-get-dhcp-reject-servers"></a><h3>nm_setting_ip_config_get_dhcp_reject_servers ()</h3>
+<pre class="programlisting">const <span class="returnvalue">char</span> *const *
+nm_setting_ip_config_get_dhcp_reject_servers
+                               (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>,
+                                <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *out_len</code></em>);</pre>
+<div class="refsect3">
+<a name="nm-setting-ip-config-get-dhcp-reject-servers.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>setting</p></td>
+<td class="parameter_description"><p>the <a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>out_len</p></td>
+<td class="parameter_description"><p>the number of returned elements. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="nm-setting-ip-config-get-dhcp-reject-servers.returns"></a><h4>Returns</h4>
+<p>A <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated array of DHCP reject servers. Even if no reject
+servers are configured, this always returns a non <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value. </p>
+<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=out_len zero-terminated=1][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
+</div>
+<p class="since">Since: 1.28</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="nm-setting-ip-config-add-dhcp-reject-server"></a><h3>nm_setting_ip_config_add_dhcp_reject_server ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+nm_setting_ip_config_add_dhcp_reject_server
+                               (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>,
+                                <em class="parameter"><code>const <span class="type">char</span> *server</code></em>);</pre>
+<p>Adds a new DHCP reject server to the setting.</p>
+<div class="refsect3">
+<a name="nm-setting-ip-config-add-dhcp-reject-server.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>setting</p></td>
+<td class="parameter_description"><p>the <a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>server</p></td>
+<td class="parameter_description"><p>the DHCP reject server to add</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: 1.28</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="nm-setting-ip-config-remove-dhcp-reject-server"></a><h3>nm_setting_ip_config_remove_dhcp_reject_server ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+nm_setting_ip_config_remove_dhcp_reject_server
+                               (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>,
+                                <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> idx</code></em>);</pre>
+<p>Removes the DHCP reject server at index <em class="parameter"><code>idx</code></em>
+.</p>
+<div class="refsect3">
+<a name="nm-setting-ip-config-remove-dhcp-reject-server.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>setting</p></td>
+<td class="parameter_description"><p>the <a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>idx</p></td>
+<td class="parameter_description"><p>index number of the DHCP reject server</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<p class="since">Since: 1.28</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="nm-setting-ip-config-clear-dhcp-reject-servers"></a><h3>nm_setting_ip_config_clear_dhcp_reject_servers ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>
+nm_setting_ip_config_clear_dhcp_reject_servers
+                               (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre>
+<p>Removes all configured DHCP reject servers.</p>
+<div class="refsect3">
+<a name="nm-setting-ip-config-clear-dhcp-reject-servers.parameters"></a><h4>Parameters</h4>
+<div class="informaltable"><table class="informaltable" width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>setting</p></td>
+<td class="parameter_description"><p>the <a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<p class="since">Since: 1.28</p>
+</div>
 </div>
 <div class="refsect1">
 <a name="NMSettingIPConfig.other_details"></a><h2>Types and Values</h2>
 <div class="refsect2">
 <a name="NM-IP-ADDRESS-ATTRIBUTE-LABEL:CAPS"></a><h3>NM_IP_ADDRESS_ATTRIBUTE_LABEL</h3>
-<pre class="programlisting">#define NM_IP_ADDRESS_ATTRIBUTE_LABEL        "label"
+<pre class="programlisting">#define NM_IP_ADDRESS_ATTRIBUTE_LABEL "label"
 </pre>
 </div>
 <hr>
@@ -5945,103 +6066,103 @@ the return value merely indicates equality (zero) or inequality.</p>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-CWND:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_CWND</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_CWND           "cwnd"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_CWND          "cwnd"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-FROM:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_FROM</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_FROM           "from"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_FROM          "from"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-INITCWND:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_INITCWND</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_INITCWND       "initcwnd"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_INITCWND      "initcwnd"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-INITRWND:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_INITRWND</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_INITRWND       "initrwnd"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_INITRWND      "initrwnd"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-LOCK-CWND:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_LOCK_CWND</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_CWND      "lock-cwnd"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_CWND     "lock-cwnd"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-LOCK-INITCWND:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_LOCK_INITCWND</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_INITCWND  "lock-initcwnd"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_INITCWND "lock-initcwnd"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-LOCK-INITRWND:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_LOCK_INITRWND</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_INITRWND  "lock-initrwnd"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_INITRWND "lock-initrwnd"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-LOCK-MTU:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_LOCK_MTU</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_MTU       "lock-mtu"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_MTU      "lock-mtu"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-LOCK-WINDOW:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_LOCK_WINDOW</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_WINDOW    "lock-window"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_LOCK_WINDOW   "lock-window"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-MTU:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_MTU</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_MTU            "mtu"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_MTU           "mtu"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-ONLINK:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_ONLINK</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_ONLINK         "onlink"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_ONLINK        "onlink"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-SCOPE:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_SCOPE</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_SCOPE          "scope"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_SCOPE         "scope"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-SRC:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_SRC</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_SRC            "src"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_SRC           "src"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-TABLE:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_TABLE</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_TABLE          "table"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_TABLE         "table"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-TOS:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_TOS</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_TOS            "tos"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_TOS           "tos"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-TYPE:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_TYPE</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_TYPE           "type"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_TYPE          "type"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-IP-ROUTE-ATTRIBUTE-WINDOW:CAPS"></a><h3>NM_IP_ROUTE_ATTRIBUTE_WINDOW</h3>
-<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_WINDOW         "window"
+<pre class="programlisting">#define NM_IP_ROUTE_ATTRIBUTE_WINDOW        "window"
 </pre>
 </div>
 <hr>
@@ -6099,7 +6220,7 @@ rule verfies or fail.</p>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-IP-CONFIG-DAD-TIMEOUT-MAX:CAPS"></a><h3>NM_SETTING_IP_CONFIG_DAD_TIMEOUT_MAX</h3>
-<pre class="programlisting">#define NM_SETTING_IP_CONFIG_DAD_TIMEOUT_MAX     30000
+<pre class="programlisting">#define NM_SETTING_IP_CONFIG_DAD_TIMEOUT_MAX 30000
 </pre>
 </div>
 <hr>
@@ -6224,110 +6345,116 @@ rule verfies or fail.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="NM-SETTING-IP-CONFIG-DHCP-REJECT-SERVERS:CAPS"></a><h3>NM_SETTING_IP_CONFIG_DHCP_REJECT_SERVERS</h3>
+<pre class="programlisting">#define NM_SETTING_IP_CONFIG_DHCP_REJECT_SERVERS "dhcp-reject-servers"
+</pre>
+</div>
+<hr>
+<div class="refsect2">
 <a name="NM-SETTING-IP-CONFIG-ROUTING-RULES:CAPS"></a><h3>NM_SETTING_IP_CONFIG_ROUTING_RULES</h3>
-<pre class="programlisting">#define NM_SETTING_IP_CONFIG_ROUTING_RULES      "routing-rules"
+<pre class="programlisting">#define NM_SETTING_IP_CONFIG_ROUTING_RULES "routing-rules"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-DEBUG:CAPS"></a><h3>NM_SETTING_DNS_OPTION_DEBUG</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_DEBUG                     "debug"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_DEBUG                 "debug"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-NDOTS:CAPS"></a><h3>NM_SETTING_DNS_OPTION_NDOTS</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NDOTS                     "ndots"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NDOTS                 "ndots"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-TIMEOUT:CAPS"></a><h3>NM_SETTING_DNS_OPTION_TIMEOUT</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_TIMEOUT                   "timeout"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_TIMEOUT               "timeout"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-ATTEMPTS:CAPS"></a><h3>NM_SETTING_DNS_OPTION_ATTEMPTS</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_ATTEMPTS                  "attempts"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_ATTEMPTS              "attempts"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-ROTATE:CAPS"></a><h3>NM_SETTING_DNS_OPTION_ROTATE</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_ROTATE                    "rotate"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_ROTATE                "rotate"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-NO-CHECK-NAMES:CAPS"></a><h3>NM_SETTING_DNS_OPTION_NO_CHECK_NAMES</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_CHECK_NAMES            "no-check-names"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_CHECK_NAMES        "no-check-names"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-INET6:CAPS"></a><h3>NM_SETTING_DNS_OPTION_INET6</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_INET6                     "inet6"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_INET6                 "inet6"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-IP6-BYTESTRING:CAPS"></a><h3>NM_SETTING_DNS_OPTION_IP6_BYTESTRING</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_IP6_BYTESTRING            "ip6-bytestring"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_IP6_BYTESTRING        "ip6-bytestring"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-IP6-DOTINT:CAPS"></a><h3>NM_SETTING_DNS_OPTION_IP6_DOTINT</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_IP6_DOTINT                "ip6-dotint"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_IP6_DOTINT            "ip6-dotint"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-NO-IP6-DOTINT:CAPS"></a><h3>NM_SETTING_DNS_OPTION_NO_IP6_DOTINT</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_IP6_DOTINT             "no-ip6-dotint"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_IP6_DOTINT         "no-ip6-dotint"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-EDNS0:CAPS"></a><h3>NM_SETTING_DNS_OPTION_EDNS0</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_EDNS0                     "edns0"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_EDNS0                 "edns0"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-SINGLE-REQUEST:CAPS"></a><h3>NM_SETTING_DNS_OPTION_SINGLE_REQUEST</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_SINGLE_REQUEST            "single-request"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_SINGLE_REQUEST        "single-request"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-SINGLE-REQUEST-REOPEN:CAPS"></a><h3>NM_SETTING_DNS_OPTION_SINGLE_REQUEST_REOPEN</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_SINGLE_REQUEST_REOPEN     "single-request-reopen"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_SINGLE_REQUEST_REOPEN "single-request-reopen"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-NO-TLD-QUERY:CAPS"></a><h3>NM_SETTING_DNS_OPTION_NO_TLD_QUERY</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_TLD_QUERY              "no-tld-query"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_TLD_QUERY          "no-tld-query"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-USE-VC:CAPS"></a><h3>NM_SETTING_DNS_OPTION_USE_VC</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_USE_VC                    "use-vc"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_USE_VC                "use-vc"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-NO-RELOAD:CAPS"></a><h3>NM_SETTING_DNS_OPTION_NO_RELOAD</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_RELOAD                 "no-reload"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_NO_RELOAD             "no-reload"
 </pre>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NM-SETTING-DNS-OPTION-TRUST-AD:CAPS"></a><h3>NM_SETTING_DNS_OPTION_TRUST_AD</h3>
-<pre class="programlisting">#define NM_SETTING_DNS_OPTION_TRUST_AD                  "trust-ad"
+<pre class="programlisting">#define NM_SETTING_DNS_OPTION_TRUST_AD              "trust-ad"
 </pre>
 </div>
 <hr>
@@ -6418,7 +6545,7 @@ incompatible with any other FQDN flag.</p>
 <hr>
 <div class="refsect2">
 <a name="NMSettingIPConfig--dad-timeout"></a><h3>The <code class="literal">“dad-timeout”</code> property</h3>
-<pre class="programlisting">  “dad-timeout”              <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
+<pre class="programlisting">  “dad-timeout”              <span class="type">int</span></pre>
 <p>Timeout in milliseconds used to check for the presence of duplicate IP
 addresses on the network.  If an address conflict is detected, the
 activation will fail.  A zero value means that no duplicate address
@@ -6435,7 +6562,7 @@ timeout in milliseconds.</p>
 <hr>
 <div class="refsect2">
 <a name="NMSettingIPConfig--dhcp-hostname"></a><h3>The <code class="literal">“dhcp-hostname”</code> property</h3>
-<pre class="programlisting">  “dhcp-hostname”            <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting">  “dhcp-hostname”            <span class="type">char</span> *</pre>
 <p>If the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-send-hostname" title="The “dhcp-send-hostname” property"><span class="type">“dhcp-send-hostname”</span></a> property is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then the
 specified name will be sent to the DHCP server when acquiring a lease.
 This property and <a class="link" href="NMSettingIP4Config.html#NMSettingIP4Config--dhcp-fqdn" title="The “dhcp-fqdn” property"><span class="type">“dhcp-fqdn”</span></a> are mutually exclusive and
@@ -6449,7 +6576,7 @@ cannot be set at the same time.</p>
 <a name="NMSettingIPConfig--dhcp-hostname-flags"></a><h3>The <code class="literal">“dhcp-hostname-flags”</code> property</h3>
 <pre class="programlisting">  “dhcp-hostname-flags”      <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre>
 <p>Flags for the DHCP hostname and FQDN.</p>
-<p>Currently this property only includes flags to control the FQDN flags
+<p>Currently, this property only includes flags to control the FQDN flags
 set in the DHCP FQDN option. Supported FQDN flags are
 <a class="link" href="NMSettingIPConfig.html#NM-DHCP-HOSTNAME-FLAG-FQDN-SERV-UPDATE:CAPS"><code class="literal">NM_DHCP_HOSTNAME_FLAG_FQDN_SERV_UPDATE</code></a>,
 <a class="link" href="NMSettingIPConfig.html#NM-DHCP-HOSTNAME-FLAG-FQDN-ENCODED:CAPS"><code class="literal">NM_DHCP_HOSTNAME_FLAG_FQDN_ENCODED</code></a> and
@@ -6473,7 +6600,7 @@ described above are sent in the DHCP requests.</p>
 <hr>
 <div class="refsect2">
 <a name="NMSettingIPConfig--dhcp-iaid"></a><h3>The <code class="literal">“dhcp-iaid”</code> property</h3>
-<pre class="programlisting">  “dhcp-iaid”                <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting">  “dhcp-iaid”                <span class="type">char</span> *</pre>
 <p>A string containing the "Identity Association Identifier" (IAID) used
 by the DHCP client. The property is a 32-bit decimal value or a
 special value among "mac", "perm-mac", "ifname" and "stable". When
@@ -6493,6 +6620,19 @@ by dhclient, which always derives the IAID from the MAC address.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="NMSettingIPConfig--dhcp-reject-servers"></a><h3>The <code class="literal">“dhcp-reject-servers”</code> property</h3>
+<pre class="programlisting">  “dhcp-reject-servers”      <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre>
+<p>Array of servers from which DHCP offers must be rejected. This property
+is useful to avoid getting a lease from misconfigured or rogue servers.</p>
+<p>For DHCPv4, each element must be an IPv4 address, optionally
+followed by a slash and a prefix length (e.g. "192.168.122.0/24").</p>
+<p>This property is currently not implemented for DHCPv6.</p>
+<p>Owner: NMSettingIPConfig</p>
+<p>Flags: Read / Write</p>
+<p class="since">Since: 1.28</p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="NMSettingIPConfig--dhcp-send-hostname"></a><h3>The <code class="literal">“dhcp-send-hostname”</code> property</h3>
 <pre class="programlisting">  “dhcp-send-hostname”       <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
 <p>If <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, a hostname is sent to the DHCP server when acquiring a lease.
@@ -6507,7 +6647,7 @@ providing a static hostname for the computer.  If the
 <hr>
 <div class="refsect2">
 <a name="NMSettingIPConfig--dhcp-timeout"></a><h3>The <code class="literal">“dhcp-timeout”</code> property</h3>
-<pre class="programlisting">  “dhcp-timeout”             <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
+<pre class="programlisting">  “dhcp-timeout”             <span class="type">int</span></pre>
 <p>A timeout for a DHCP transaction in seconds. If zero (the default), a
 globally configured default is used. If still unspecified, a device specific
 timeout is used (usually 45 seconds).</p>
@@ -6547,33 +6687,47 @@ name servers to resolv.conf, and if all contributing profiles have
 <hr>
 <div class="refsect2">
 <a name="NMSettingIPConfig--dns-priority"></a><h3>The <code class="literal">“dns-priority”</code> property</h3>
-<pre class="programlisting">  “dns-priority”             <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre>
+<pre class="programlisting">  “dns-priority”             <span class="type">int</span></pre>
 <p>DNS servers priority.</p>
 <p>The relative priority for DNS servers specified by this setting.  A lower
-value is better (higher priority). Zero selects a globally configured
-default value. If the latter is missing or zero too, it defaults to
-50 for VPNs (including WireGuard) and 100 for other connections.</p>
+numerical value is better (higher priority).</p>
+<p>Negative values have the special effect of excluding other configurations
+with a greater numerical priority value; so in presence of at least one negative
+priority, only DNS servers from connections with the lowest priority value will be used.
+To avoid all DNS leaks, set the priority of the profile that should be used
+to the most negative value of all active connections profiles.</p>
+<p>Zero selects a globally configured default value. If the latter is missing
+or zero too, it defaults to 50 for VPNs (including WireGuard) and 100 for
+other connections.</p>
 <p>Note that the priority is to order DNS settings for multiple active
 connections.  It does not disambiguate multiple DNS servers within the
 same connection profile.</p>
-<p>When using dns=default, servers with higher priority will be on top of
-resolv.conf.  To prioritize a given server over another one within the
-same connection, just specify them in the desired order.  When multiple
-devices have configurations with the same priority, VPNs will be
+<p>When multiple devices have configurations with the same priority, VPNs will be
 considered first, then devices with the best (lowest metric) default
-route and then all other devices.  Negative values have the special
-effect of excluding other configurations with a greater priority value;
-so in presence of at least one negative priority, only DNS servers from
-connections with the lowest priority value will be used.</p>
-<p>When using a DNS resolver that supports Conditional Forwarding as dns=dnsmasq or
-dns=systemd-resolved, each connection is used to query domains in its
-search list.  Queries for domains not present in any search list are
-routed through connections having the '~.' special wildcard domain, which
-is added automatically to connections with the default route (or can be
-added manually).  When multiple connections specify the same domain, the
-one with the highest priority (lowest numerical value) wins.  If a
-connection specifies a domain which is subdomain of another domain with a
-negative DNS priority value, the subdomain is ignored.</p>
+route and then all other devices.</p>
+<p>When using dns=default, servers with higher priority will be on top of
+resolv.conf. To prioritize a given server over another one within the
+same connection, just specify them in the desired order.
+Note that commonly the resolver tries name servers in /etc/resolv.conf
+in the order listed, proceeding with the next server in the list
+on failure. See for example the "rotate" option of the dns-options setting.
+If there are any negative DNS priorities, then only name servers from
+the devices with that lowest priority will be considered.</p>
+<p>When using a DNS resolver that supports Conditional Forwarding or
+Split DNS (with dns=dnsmasq or dns=systemd-resolved settings), each connection
+is used to query domains in its search list. The search domains determine which
+name servers to ask, and the DNS priority is used to prioritize
+name servers based on the domain.  Queries for domains not present in any
+search list are routed through connections having the '~.' special wildcard
+domain, which is added automatically to connections with the default route
+(or can be added manually).  When multiple connections specify the same domain, the
+one with the best priority (lowest numerical value) wins.  If a sub domain
+is configured on another interface it will be accepted regardless the priority,
+unless parent domain on the other interface has a negative priority, which causes
+the sub domain to be shadowed.
+With Split DNS one can avoid undesired DNS leaks by properly configuring
+DNS priorities and the search domains, so that only name servers of the desired
+interface are configured.</p>
 <p>Owner: NMSettingIPConfig</p>
 <p>Flags: Read / Write</p>
 <p>Default value: 0</p>
@@ -6587,13 +6741,17 @@ negative DNS priority value, the subdomain is ignored.</p>
 are considered 'routing' domains and are used only to decide the
 interface over which a query must be forwarded; they are not used
 to complete unqualified host names.</p>
+<p>When using a DNS plugin that supports Conditional Forwarding or
+Split DNS, then the search domains specify which name servers to
+query. This makes the behavior different from running with plain
+/etc/resolv.conf. For more information see also the dns-priority setting.</p>
 <p>Owner: NMSettingIPConfig</p>
 <p>Flags: Read / Write</p>
 </div>
 <hr>
 <div class="refsect2">
 <a name="NMSettingIPConfig--gateway"></a><h3>The <code class="literal">“gateway”</code> property</h3>
-<pre class="programlisting">  “gateway”                  <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting">  “gateway”                  <span class="type">char</span> *</pre>
 <p>The gateway associated with this configuration. This is only meaningful
 if <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--addresses" title="The “addresses” property"><span class="type">“addresses”</span></a> is also set.</p>
 <p>The gateway's main purpose is to control the next hop of the standard default route on the device.
@@ -6610,8 +6768,8 @@ length.</p>
 <a name="NMSettingIPConfig--ignore-auto-dns"></a><h3>The <code class="literal">“ignore-auto-dns”</code> property</h3>
 <pre class="programlisting">  “ignore-auto-dns”          <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
 <p>When <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--method" title="The “method” property"><span class="type">“method”</span></a> is set to "auto" and this property to
-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, automatically configured nameservers and search domains are
-ignored and only nameservers and search domains specified in the
+<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, automatically configured name servers and search domains are
+ignored and only name servers and search domains specified in the
 <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dns" title="The “dns” property"><span class="type">“dns”</span></a> and <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dns-search" title="The “dns-search” property"><span class="type">“dns-search”</span></a> properties, if
 any, are used.</p>
 <p>Owner: NMSettingIPConfig</p>
@@ -6647,7 +6805,7 @@ successfully.</p>
 <hr>
 <div class="refsect2">
 <a name="NMSettingIPConfig--method"></a><h3>The <code class="literal">“method”</code> property</h3>
-<pre class="programlisting">  “method”                   <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
+<pre class="programlisting">  “method”                   <span class="type">char</span> *</pre>
 <p>IP configuration method.</p>
 <p><a class="link" href="NMSettingIP4Config.html" title="NMSettingIP4Config"><span class="type">NMSettingIP4Config</span></a> and <a class="link" href="NMSettingIP6Config.html" title="NMSettingIP6Config"><span class="type">NMSettingIP6Config</span></a> both support "disabled",
 "auto", "manual", and "link-local". See the subclass-specific
@@ -6734,6 +6892,6 @@ of NetworkManager.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.32</div>
+<hr>Generated by GTK-Doc V1.33.1</div>
 </body>
 </html>
\ No newline at end of file
author	Sebastien Bacher <seb128@ubuntu.com>	2021-01-11 18:07:03 +0100
committer	Sebastien Bacher <seb128@ubuntu.com>	2021-01-11 18:15:57 +0100
commit	2567f558da3eb9911678227d4aeb15162e707d89 (patch)
tree	13c80b0e091c8ba585b14b966cda998f95f1936d /docs/libnm/html/NMSettingIPConfig.html
parent	02d99ffd62ede29cffcb45fcbe33d044b7406d3a (diff)
parent	f54032b30e1ddd84f10a339e0caf493772e049a7 (diff)