diff options
Diffstat (limited to 'docs/libnm/html/NMSettingIPConfig.html')
| -rw-r--r-- | docs/libnm/html/NMSettingIPConfig.html | 374 |
1 files changed, 266 insertions, 108 deletions
diff --git a/docs/libnm/html/NMSettingIPConfig.html b/docs/libnm/html/NMSettingIPConfig.html index f78f2186..0d3a340d 100644 --- a/docs/libnm/html/NMSettingIPConfig.html +++ b/docs/libnm/html/NMSettingIPConfig.html @@ -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> @@ -1172,6 +1195,11 @@ 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-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> @@ -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> @@ -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> @@ -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> @@ -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> @@ -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>, @@ -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="Don't free data after the code is done."><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> @@ -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 @@ -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. @@ -6550,30 +6690,44 @@ name servers to resolv.conf, and if all contributing profiles have <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> <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,6 +6741,10 @@ 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> @@ -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> |