diff options
Diffstat (limited to 'docs/libnm/html/NMSettingIPConfig.html')
| -rw-r--r-- | docs/libnm/html/NMSettingIPConfig.html | 680 |
1 files changed, 168 insertions, 512 deletions
diff --git a/docs/libnm/html/NMSettingIPConfig.html b/docs/libnm/html/NMSettingIPConfig.html index 5a9a903e..e19560b5 100644 --- a/docs/libnm/html/NMSettingIPConfig.html +++ b/docs/libnm/html/NMSettingIPConfig.html @@ -16,8 +16,7 @@ <td width="100%" align="left" class="shortcuts"> <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> <a href="#NMSettingIPConfig.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> - <a href="#NMSettingIPConfig.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> - <a href="#NMSettingIPConfig.properties" class="shortcut">Properties</a></span> + <a href="#NMSettingIPConfig.object-hierarchy" class="shortcut">Object Hierarchy</a></span> </td> <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> <td><a accesskey="u" href="ch03.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> @@ -692,6 +691,22 @@ addressing, routing, and name service properties</p> </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"> +<a class="link" href="NMSettingIPConfig.html#nm-ip-routing-rule-get-uid-range" title="nm_ip_routing_rule_get_uid_range ()">nm_ip_routing_rule_get_uid_range</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-ip-routing-rule-set-uid-range" title="nm_ip_routing_rule_set_uid_range ()">nm_ip_routing_rule_set_uid_range</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> +<td class="function_type"> <span class="returnvalue">int</span> </td> <td class="function_name"> @@ -1109,6 +1124,14 @@ addressing, routing, and name service properties</p> </td> </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-get-required-timeout" title="nm_setting_ip_config_get_required_timeout ()">nm_setting_ip_config_get_required_timeout</a> <span class="c_punctuation">()</span> +</td> +</tr> +<tr> <td class="function_type">const <span class="returnvalue">char</span> * </td> <td class="function_name"> @@ -1157,129 +1180,6 @@ addressing, routing, and name service properties</p> </tbody> </table></div> </div> -<div class="refsect1"> -<a name="NMSettingIPConfig.properties"></a><h2>Properties</h2> -<div class="informaltable"><table class="informaltable" border="0"> -<colgroup> -<col width="150px" class="properties_type"> -<col width="300px" class="properties_name"> -<col width="200px" class="properties_flags"> -</colgroup> -<tbody> -<tr> -<td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *</td> -<td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--addresses" title="The “addresses” property">addresses</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<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"> -<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> -<tr> -<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></td> -<td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-hostname-flags" title="The “dhcp-hostname-flags” property">dhcp-hostname-flags</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<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"><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> -<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--dns" title="The “dns” property">dns</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--dns-options" title="The “dns-options” property">dns-options</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<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> -<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--dns-search" title="The “dns-search” property">dns-search</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<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> -<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--ignore-auto-dns" title="The “ignore-auto-dns” property">ignore-auto-dns</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--ignore-auto-routes" title="The “ignore-auto-routes” property">ignore-auto-routes</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--may-fail" title="The “may-fail” property">may-fail</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<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> -<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--never-default" title="The “never-default” property">never-default</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#gint64"><span class="type">gint64</span></a></td> -<td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--route-metric" title="The “route-metric” property">route-metric</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#guint"><span class="type">guint</span></a></td> -<td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--route-table" title="The “route-table” property">route-table</a></td> -<td class="property_flags">Read / Write</td> -</tr> -<tr> -<td class="property_type"> -<a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *</td> -<td class="property_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--routes" title="The “routes” property">routes</a></td> -<td class="property_flags">Read / Write</td> -</tr> -</tbody> -</table></div> -</div> <a name="NMIPAddress"></a><a name="NMIPRoute"></a><a name="NMIPRoutingRule"></a><div class="refsect1"> <a name="NMSettingIPConfig.other"></a><h2>Types and Values</h2> <div class="informaltable"><table class="informaltable" width="100%" border="0"> @@ -1450,6 +1350,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-REQUIRED-TIMEOUT:CAPS" title="NM_SETTING_IP_CONFIG_REQUIRED_TIMEOUT">NM_SETTING_IP_CONFIG_REQUIRED_TIMEOUT</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> <td class="function_name"><a class="link" href="NMSettingIPConfig.html#NM-SETTING-IP-CONFIG-DHCP-IAID:CAPS" title="NM_SETTING_IP_CONFIG_DHCP_IAID">NM_SETTING_IP_CONFIG_DHCP_IAID</a></td> </tr> <tr> @@ -1529,10 +1433,6 @@ addressing, routing, and name service properties</p> <td class="function_name"><a class="link" href="NMSettingIPConfig.html#NM-SETTING-DNS-OPTION-TRUST-AD:CAPS" title="NM_SETTING_DNS_OPTION_TRUST_AD">NM_SETTING_DNS_OPTION_TRUST_AD</a></td> </tr> <tr> -<td class="datatype_keyword"> </td> -<td class="function_name"><a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig-struct" title="NMSettingIPConfig">NMSettingIPConfig</a></td> -</tr> -<tr> <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="NMSettingIPConfig.html#NMDhcpHostnameFlags" title="enum NMDhcpHostnameFlags">NMDhcpHostnameFlags</a></td> </tr> @@ -1549,11 +1449,6 @@ addressing, routing, and name service properties</p> <span class="lineart">├──</span> NMDhcpHostnameFlags <span class="lineart">├──</span> NMIPAddressCmpFlags <span class="lineart">╰──</span> NMIPRoutingRuleAsStringFlags - <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> - <span class="lineart">╰──</span> <a class="link" href="NMSetting.html" title="NMSetting">NMSetting</a> - <span class="lineart">╰──</span> NMSettingIPConfig - <span class="lineart">├──</span> <a class="link" href="NMSettingIP4Config.html" title="NMSettingIP4Config">NMSettingIP4Config</a> - <span class="lineart">╰──</span> <a class="link" href="NMSettingIP6Config.html" title="NMSettingIP6Config">NMSettingIP6Config</a> </pre> </div> <div class="refsect1"> @@ -1819,9 +1714,13 @@ nm_ip_address_dup (<em class="parameter"><code><a class="link" href="NMSettingIP <div class="refsect3"> <a name="nm-ip-address-dup.returns"></a><h4>Returns</h4> <p>a copy of <em class="parameter"><code>address</code></em> -. </p> +</p> +<p>This API was part of public headers before 1.32.0 but +was erroneously not exported in the ABI. It is thus only +usable since 1.32.0. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> +<p class="since">Since: 1.32</p> </div> <hr> <div class="refsect2"> @@ -2416,9 +2315,13 @@ nm_ip_route_dup (<em class="parameter"><code><a class="link" href="NMSettingIPCo <div class="refsect3"> <a name="nm-ip-route-dup.returns"></a><h4>Returns</h4> <p>a copy of <em class="parameter"><code>route</code></em> -. </p> +</p> +<p>This API was part of public headers before 1.32.0 but +was erroneously not exported in the ABI. It is thus only +usable since 1.32.0. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> +<p class="since">Since: 1.32</p> </div> <hr> <div class="refsect2"> @@ -4176,6 +4079,86 @@ unset.</p></td> </div> <hr> <div class="refsect2"> +<a name="nm-ip-routing-rule-get-uid-range"></a><h3>nm_ip_routing_rule_get_uid_range ()</h3> +<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> +nm_ip_routing_rule_get_uid_range (<em class="parameter"><code>const <a class="link" href="NMSettingIPConfig.html#NMIPRoutingRule"><span class="type">NMIPRoutingRule</span></a> *self</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *out_range_start</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> *out_range_end</code></em>);</pre> +<div class="refsect3"> +<a name="nm-ip-routing-rule-get-uid-range.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>self</p></td> +<td class="parameter_description"><p>the <a class="link" href="NMSettingIPConfig.html#NMIPRoutingRule"><span class="type">NMIPRoutingRule</span></a> instance</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>out_range_start</p></td> +<td class="parameter_description"><p>returns the start of the range +or 0 if the range is not set. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td> +</tr> +<tr> +<td class="parameter_name"><p>out_range_end</p></td> +<td class="parameter_description"><p>returns the end of the range +or 0 if the range is not set. </p></td> +<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</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> +</div> +<div class="refsect3"> +<a name="nm-ip-routing-rule-get-uid-range.returns"></a><h4>Returns</h4> +<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if a uid range is set.</p> +</div> +<p class="since">Since: 1.32. Due to a bug, the symbols of this function</p> +</div> +<hr> +<div class="refsect2"> +<a name="nm-ip-routing-rule-set-uid-range"></a><h3>nm_ip_routing_rule_set_uid_range ()</h3> +<pre class="programlisting"><span class="returnvalue">void</span> +nm_ip_routing_rule_set_uid_range (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html#NMIPRoutingRule"><span class="type">NMIPRoutingRule</span></a> *self</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> uid_range_start</code></em>, + <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> uid_range_end</code></em>);</pre> +<p>For a valid range, start must be less or equal to end. +If set to an invalid range, the range gets unset.</p> +<div class="refsect3"> +<a name="nm-ip-routing-rule-set-uid-range.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>self</p></td> +<td class="parameter_description"><p>the <a class="link" href="NMSettingIPConfig.html#NMIPRoutingRule"><span class="type">NMIPRoutingRule</span></a> instance</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>uid_range_start</p></td> +<td class="parameter_description"><p>the uid_range start to set.</p></td> +<td class="parameter_annotations"> </td> +</tr> +<tr> +<td class="parameter_name"><p>uid_range_end</p></td> +<td class="parameter_description"><p>the uid_range start to set.</p></td> +<td class="parameter_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: 1.32. Due to a bug, the symbols of this function</p> +</div> +<hr> +<div class="refsect2"> <a name="nm-ip-routing-rule-cmp"></a><h3>nm_ip_routing_rule_cmp ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> nm_ip_routing_rule_cmp (<em class="parameter"><code>const <a class="link" href="NMSettingIPConfig.html#NMIPRoutingRule"><span class="type">NMIPRoutingRule</span></a> *rule</code></em>, @@ -4363,7 +4346,7 @@ nm_setting_ip_config_get_method (<em class="parameter"><code><a class="link" hre </div> <div class="refsect3"> <a name="nm-setting-ip-config-get-method.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--method" title="The “method” property"><span class="type">“method”</span></a> property of the setting; see +<p> the <a href="NMSettingIPConfig.html#NMSettingIPConfig--method"><span class="type">“method”</span></a> property of the setting; see <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> for details of the methods available with each type.</p> </div> @@ -5402,7 +5385,7 @@ nm_setting_ip_config_clear_routes (<em class="parameter"><code><a class="link" h <a name="nm-setting-ip-config-get-route-metric"></a><h3>nm_setting_ip_config_get_route_metric ()</h3> <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a> nm_setting_ip_config_get_route_metric (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--route-metric" title="The “route-metric” property"><span class="type">“route-metric”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--route-metric"><span class="type">“route-metric”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-route-metric.parameters"></a><h4>Parameters</h4> @@ -5422,7 +5405,7 @@ property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-route-metric.returns"></a><h4>Returns</h4> <p> the route metric that is used for routes that don't explicitly -specify a metric. See <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--route-metric" title="The “route-metric” property"><span class="type">“route-metric”</span></a> for more details.</p> +specify a metric. See <a href="NMSettingIPConfig.html#NMSettingIPConfig--route-metric"><span class="type">“route-metric”</span></a> for more details.</p> </div> </div> <hr> @@ -5430,7 +5413,7 @@ specify a metric. See <a class="link" href="NMSettingIPConfig.html#NMSettingIPCo <a name="nm-setting-ip-config-get-route-table"></a><h3>nm_setting_ip_config_get_route_table ()</h3> <pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a> nm_setting_ip_config_get_route_table (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--route-table" title="The “route-table” property"><span class="type">“route-table”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--route-table"><span class="type">“route-table”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-route-table.parameters"></a><h4>Parameters</h4> @@ -5614,7 +5597,7 @@ nm_setting_ip_config_clear_routing_rules <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_get_ignore_auto_routes (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--ignore-auto-routes" title="The “ignore-auto-routes” property"><span class="type">“ignore-auto-routes”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--ignore-auto-routes"><span class="type">“ignore-auto-routes”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-ignore-auto-routes.parameters"></a><h4>Parameters</h4> @@ -5643,7 +5626,7 @@ ignored.</p> <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_get_ignore_auto_dns (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--ignore-auto-dns" title="The “ignore-auto-dns” property"><span class="type">“ignore-auto-dns”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--ignore-auto-dns"><span class="type">“ignore-auto-dns”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-ignore-auto-dns.parameters"></a><h4>Parameters</h4> @@ -5672,7 +5655,7 @@ should be ignored.</p> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_ip_config_get_dhcp_hostname (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-hostname" title="The “dhcp-hostname” property"><span class="type">“dhcp-hostname”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-hostname"><span class="type">“dhcp-hostname”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-dhcp-hostname.parameters"></a><h4>Parameters</h4> @@ -5700,7 +5683,7 @@ property.</p> <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_get_dhcp_send_hostname (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in 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> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-send-hostname"><span class="type">“dhcp-send-hostname”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-dhcp-send-hostname.parameters"></a><h4>Parameters</h4> @@ -5730,7 +5713,7 @@ update DNS information for this machine.</p> <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_get_never_default (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--never-default" title="The “never-default” property"><span class="type">“never-default”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--never-default"><span class="type">“never-default”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-never-default.parameters"></a><h4>Parameters</h4> @@ -5758,7 +5741,7 @@ connection</p> <a name="nm-setting-ip-config-get-may-fail"></a><h3>nm_setting_ip_config_get_may_fail ()</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_get_may_fail (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--may-fail" title="The “may-fail” property"><span class="type">“may-fail”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--may-fail"><span class="type">“may-fail”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-may-fail.parameters"></a><h4>Parameters</h4> @@ -5803,7 +5786,7 @@ nm_setting_ip_config_get_dad_timeout (<em class="parameter"><code><a class="link </div> <div class="refsect3"> <a name="nm-setting-ip-config-get-dad-timeout.returns"></a><h4>Returns</h4> -<p> the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dad-timeout" title="The “dad-timeout” property"><span class="type">“dad-timeout”</span></a> property.</p> +<p> the <a href="NMSettingIPConfig.html#NMSettingIPConfig--dad-timeout"><span class="type">“dad-timeout”</span></a> property.</p> </div> <p class="since">Since: 1.2</p> </div> @@ -5812,7 +5795,7 @@ nm_setting_ip_config_get_dad_timeout (<em class="parameter"><code><a class="link <a name="nm-setting-ip-config-get-dhcp-timeout"></a><h3>nm_setting_ip_config_get_dhcp_timeout ()</h3> <pre class="programlisting"><span class="returnvalue">int</span> nm_setting_ip_config_get_dhcp_timeout (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-timeout" title="The “dhcp-timeout” property"><span class="type">“dhcp-timeout”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-timeout"><span class="type">“dhcp-timeout”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-dhcp-timeout.parameters"></a><h4>Parameters</h4> @@ -5838,10 +5821,39 @@ the particular kind of device.</p> </div> <hr> <div class="refsect2"> +<a name="nm-setting-ip-config-get-required-timeout"></a><h3>nm_setting_ip_config_get_required_timeout ()</h3> +<pre class="programlisting"><span class="returnvalue">int</span> +nm_setting_ip_config_get_required_timeout + (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> +<p>Returns the value contained in the <span class="type">“required-timeout”</span> +property.</p> +<div class="refsect3"> +<a name="nm-setting-ip-config-get-required-timeout.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> +<div class="refsect3"> +<a name="nm-setting-ip-config-get-required-timeout.returns"></a><h4>Returns</h4> +<p> the required timeout for the address family</p> +</div> +<p class="since">Since: 1.34, 1.32.4</p> +</div> +<hr> +<div class="refsect2"> <a name="nm-setting-ip-config-get-dhcp-iaid"></a><h3>nm_setting_ip_config_get_dhcp_iaid ()</h3> <pre class="programlisting">const <span class="returnvalue">char</span> * nm_setting_ip_config_get_dhcp_iaid (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-iaid" title="The “dhcp-iaid” property"><span class="type">“dhcp-iaid”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-iaid"><span class="type">“dhcp-iaid”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-dhcp-iaid.parameters"></a><h4>Parameters</h4> @@ -5870,7 +5882,7 @@ property.</p> <pre class="programlisting"><a class="link" href="NMSettingIPConfig.html#NMDhcpHostnameFlags" title="enum NMDhcpHostnameFlags"><span class="returnvalue">NMDhcpHostnameFlags</span></a> nm_setting_ip_config_get_dhcp_hostname_flags (<em class="parameter"><code><a class="link" href="NMSettingIPConfig.html" title="NMSettingIPConfig"><span class="type">NMSettingIPConfig</span></a> *setting</code></em>);</pre> -<p>Returns the value contained in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-hostname-flags" title="The “dhcp-hostname-flags” property"><span class="type">“dhcp-hostname-flags”</span></a> +<p>Returns the value contained in the <a href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-hostname-flags"><span class="type">“dhcp-hostname-flags”</span></a> property.</p> <div class="refsect3"> <a name="nm-setting-ip-config-get-dhcp-hostname-flags.parameters"></a><h4>Parameters</h4> @@ -6339,6 +6351,12 @@ rule verfies or fail.</p> </div> <hr> <div class="refsect2"> +<a name="NM-SETTING-IP-CONFIG-REQUIRED-TIMEOUT:CAPS"></a><h3>NM_SETTING_IP_CONFIG_REQUIRED_TIMEOUT</h3> +<pre class="programlisting">#define NM_SETTING_IP_CONFIG_REQUIRED_TIMEOUT "required-timeout" +</pre> +</div> +<hr> +<div class="refsect2"> <a name="NM-SETTING-IP-CONFIG-DHCP-IAID:CAPS"></a><h3>NM_SETTING_IP_CONFIG_DHCP_IAID</h3> <pre class="programlisting">#define NM_SETTING_IP_CONFIG_DHCP_IAID "dhcp-iaid" </pre> @@ -6459,11 +6477,6 @@ rule verfies or fail.</p> </div> <hr> <div class="refsect2"> -<a name="NMSettingIPConfig-struct"></a><h3>NMSettingIPConfig</h3> -<pre class="programlisting">typedef struct _NMSettingIPConfig NMSettingIPConfig;</pre> -</div> -<hr> -<div class="refsect2"> <a name="NMDhcpHostnameFlags"></a><h3>enum NMDhcpHostnameFlags</h3> <p><a class="link" href="NMSettingIPConfig.html#NMDhcpHostnameFlags" title="enum NMDhcpHostnameFlags"><span class="type">NMDhcpHostnameFlags</span></a> describe flags related to the DHCP hostname and FQDN.</p> @@ -6533,363 +6546,6 @@ incompatible with any other FQDN flag.</p> </div> </div> <div class="refsect1"> -<a name="NMSettingIPConfig.property-details"></a><h2>Property Details</h2> -<div class="refsect2"> -<a name="NMSettingIPConfig--addresses"></a><h3>The <code class="literal">“addresses”</code> property</h3> -<pre class="programlisting"> “addresses” <a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *</pre> -<p>Array of IP addresses.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMIPAddress)]</span></p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -</div> -<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” <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 -detection is performed, -1 means the default value (either configuration -ipvx.dad-timeout override or zero). A value greater than zero is a -timeout in milliseconds.</p> -<p>The property is currently implemented only for IPv4.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Allowed values: [-1,30000]</p> -<p>Default value: -1</p> -<p class="since">Since: 1.2</p> -</div> -<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” <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 -cannot be set at the same time.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<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 -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 -<a class="link" href="NMSettingIPConfig.html#NM-DHCP-HOSTNAME-FLAG-FQDN-NO-UPDATE:CAPS"><code class="literal">NM_DHCP_HOSTNAME_FLAG_FQDN_NO_UPDATE</code></a>. When no FQDN flag is set and -<a class="link" href="NMSettingIPConfig.html#NM-DHCP-HOSTNAME-FLAG-FQDN-CLEAR-FLAGS:CAPS"><code class="literal">NM_DHCP_HOSTNAME_FLAG_FQDN_CLEAR_FLAGS</code></a> is set, the DHCP FQDN option will -contain no flag. Otherwise, if no FQDN flag is set and -<a class="link" href="NMSettingIPConfig.html#NM-DHCP-HOSTNAME-FLAG-FQDN-CLEAR-FLAGS:CAPS"><code class="literal">NM_DHCP_HOSTNAME_FLAG_FQDN_CLEAR_FLAGS</code></a> is not set, the standard FQDN flags -are set in the request: -<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> for IPv4 and -<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> for IPv6.</p> -<p>When this property is set to the default value <a class="link" href="NMSettingIPConfig.html#NM-DHCP-HOSTNAME-FLAG-NONE:CAPS"><code class="literal">NM_DHCP_HOSTNAME_FLAG_NONE</code></a>, -a global default is looked up in NetworkManager configuration. If that value -is unset or also <a class="link" href="NMSettingIPConfig.html#NM-DHCP-HOSTNAME-FLAG-NONE:CAPS"><code class="literal">NM_DHCP_HOSTNAME_FLAG_NONE</code></a>, then the standard FQDN flags -described above are sent in the DHCP requests.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: 0</p> -<p class="since">Since: 1.22</p> -</div> -<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” <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 -set to "mac" (or "perm-mac"), the last 4 bytes of the current (or -permanent) MAC address are used as IAID. When set to "ifname", the -IAID is computed by hashing the interface name. The special value -"stable" can be used to generate an IAID based on the stable-id (see -connection.stable-id), a per-host key and the interface name. When -the property is unset, the value from global configuration is used; -if no global default is set then the IAID is assumed to be -"ifname". Note that at the moment this property is ignored for IPv6 -by dhclient, which always derives the IAID from the MAC address.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -<p class="since">Since: 1.22</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. -Some DHCP servers use this hostname to update DNS databases, essentially -providing a static hostname for the computer. If the -<a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--dhcp-hostname" title="The “dhcp-hostname” property"><span class="type">“dhcp-hostname”</span></a> property is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and this property is -<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the current persistent hostname of the computer is sent.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: TRUE</p> -</div> -<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” <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> -<p>Set to 2147483647 (MAXINT32) for infinity.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Allowed values: >= 0</p> -<p>Default value: 0</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--dns"></a><h3>The <code class="literal">“dns”</code> property</h3> -<pre class="programlisting"> “dns” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> -<p>Array of IP addresses of DNS servers.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--dns-options"></a><h3>The <code class="literal">“dns-options”</code> property</h3> -<pre class="programlisting"> “dns-options” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> -<p>Array of DNS options as described in man 5 resolv.conf.</p> -<p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> means that the options are unset and left at the default. -In this case NetworkManager will use default options. This is -distinct from an empty list of properties.</p> -<p>The currently supported options are "attempts", "debug", "edns0", -"inet6", "ip6-bytestring", "ip6-dotint", "ndots", "no-check-names", -"no-ip6-dotint", "no-reload", "no-tld-query", "rotate", "single-request", -"single-request-reopen", "timeout", "trust-ad", "use-vc".</p> -<p>The "trust-ad" setting is only honored if the profile contributes -name servers to resolv.conf, and if all contributing profiles have -"trust-ad" enabled.</p> -<p>When using a caching DNS plugin (dnsmasq or systemd-resolved in -NetworkManager.conf) then "edns0" and "trust-ad" are automatically -added.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p class="since">Since: 1.2</p> -</div> -<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” <span class="type">int</span></pre> -<p>DNS servers priority.</p> -<p>The relative priority for DNS servers specified by this setting. A lower -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 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.</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> -<p class="since">Since: 1.4</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--dns-search"></a><h3>The <code class="literal">“dns-search”</code> property</h3> -<pre class="programlisting"> “dns-search” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre> -<p>Array of DNS search domains. Domains starting with a tilde ('~') -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” <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. -Hence, the gateway property conflicts with <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--never-default" title="The “never-default” property"><span class="type">“never-default”</span></a> and will be -automatically dropped if the IP configuration is set to never-default.</p> -<p>As an alternative to set the gateway, configure a static default route with /0 as prefix -length.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<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 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> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--ignore-auto-routes"></a><h3>The <code class="literal">“ignore-auto-routes”</code> property</h3> -<pre class="programlisting"> “ignore-auto-routes” <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 routes are ignored and only routes -specified in the <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--routes" title="The “routes” property"><span class="type">“routes”</span></a> property, if any, are used.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--may-fail"></a><h3>The <code class="literal">“may-fail”</code> property</h3> -<pre class="programlisting"> “may-fail” <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>, allow overall network configuration to proceed even if the -configuration specified by this property times out. Note that at least -one IP configuration must succeed or overall network configuration will -still fail. For example, in IPv6-only networks, setting this property to -<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on the <a class="link" href="NMSettingIP4Config.html" title="NMSettingIP4Config"><span class="type">NMSettingIP4Config</span></a> allows the overall network configuration -to succeed if IPv4 configuration fails but IPv6 configuration completes -successfully.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: TRUE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--method"></a><h3>The <code class="literal">“method”</code> property</h3> -<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 -documentation for other values.</p> -<p>In general, for the "auto" method, properties such as -<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--routes" title="The “routes” property"><span class="type">“routes”</span></a> specify information -that is added on to the information returned from automatic -configuration. The <a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--ignore-auto-routes" title="The “ignore-auto-routes” property"><span class="type">“ignore-auto-routes”</span></a> and -<a class="link" href="NMSettingIPConfig.html#NMSettingIPConfig--ignore-auto-dns" title="The “ignore-auto-dns” property"><span class="type">“ignore-auto-dns”</span></a> properties modify this behavior.</p> -<p>For methods that imply no upstream network, such as "shared" or -"link-local", these properties must be empty.</p> -<p>For IPv4 method "shared", the IP subnet can be configured by adding one -manual IPv4 address or otherwise 10.42.x.0/24 is chosen. Note that the -shared method must be configured on the interface which shares the internet -to a subnet, not on the uplink which is shared.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: NULL</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--never-default"></a><h3>The <code class="literal">“never-default”</code> property</h3> -<pre class="programlisting"> “never-default” <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>, this connection will never be the default connection for this -IP type, meaning it will never be assigned the default route by -NetworkManager.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: FALSE</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--route-metric"></a><h3>The <code class="literal">“route-metric”</code> property</h3> -<pre class="programlisting"> “route-metric” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a></pre> -<p>The default metric for routes that don't explicitly specify a metric. -The default value -1 means that the metric is chosen automatically -based on the device type. -The metric applies to dynamic routes, manual (static) routes that -don't have an explicit metric setting, address prefix routes, and -the default route. -Note that for IPv6, the kernel accepts zero (0) but coerces it to -1024 (user default). Hence, setting this property to zero effectively -mean setting it to 1024. -For IPv4, zero is a regular value for the metric.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Allowed values: [-1,4294967295]</p> -<p>Default value: -1</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--route-table"></a><h3>The <code class="literal">“route-table”</code> property</h3> -<pre class="programlisting"> “route-table” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a></pre> -<p>Enable policy routing (source routing) and set the routing table used when adding routes.</p> -<p>This affects all routes, including device-routes, IPv4LL, DHCP, SLAAC, default-routes -and static routes. But note that static routes can individually overwrite the setting -by explicitly specifying a non-zero routing table.</p> -<p>If the table setting is left at zero, it is eligible to be overwritten via global -configuration. If the property is zero even after applying the global configuration -value, policy routing is disabled for the address family of this connection.</p> -<p>Policy routing disabled means that NetworkManager will add all routes to the main -table (except static routes that explicitly configure a different table). Additionally, -NetworkManager will not delete any extraneous routes from tables except the main table. -This is to preserve backward compatibility for users who manage routing tables outside -of NetworkManager.</p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -<p>Default value: 0</p> -<p class="since">Since: 1.10</p> -</div> -<hr> -<div class="refsect2"> -<a name="NMSettingIPConfig--routes"></a><h3>The <code class="literal">“routes”</code> property</h3> -<pre class="programlisting"> “routes” <a href="https://developer.gnome.org/glib/unstable/glib-Pointer-Arrays.html#GPtrArray"><span class="type">GPtrArray</span></a> *</pre> -<p>Array of IP routes.</p> -<p><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> GPtrArray(NMIPRoute)]</span></p> -<p>Owner: NMSettingIPConfig</p> -<p>Flags: Read / Write</p> -</div> -</div> -<div class="refsect1"> <a name="NMSettingIPConfig.see-also"></a><h2>See Also</h2> <p><a class="link" href="NMSettingIP4Config.html" title="NMSettingIP4Config"><span class="type">NMSettingIP4Config</span></a>, <a class="link" href="NMSettingIP6Config.html" title="NMSettingIP6Config"><span class="type">NMSettingIP6Config</span></a></p> </div> |