diff options
Diffstat (limited to 'docs/libnm/html/NMSettingIP6Config.html')
| -rw-r--r-- | docs/libnm/html/NMSettingIP6Config.html | 144 |
1 files changed, 135 insertions, 9 deletions
diff --git a/docs/libnm/html/NMSettingIP6Config.html b/docs/libnm/html/NMSettingIP6Config.html index 0b3633d9..8d733c14 100644 --- a/docs/libnm/html/NMSettingIP6Config.html +++ b/docs/libnm/html/NMSettingIP6Config.html @@ -7,7 +7,7 @@ <link rel="home" href="index.html" title="libnm Reference Manual"> <link rel="up" href="ch03.html" title="Connection and Setting API Reference"> <link rel="prev" href="NMSettingIP4Config.html" title="NMSettingIP4Config"> -<link rel="next" href="NMSettingOlpcMesh.html" title="NMSettingOlpcMesh"> +<link rel="next" href="NMSettingIPConfig.html" title="NMSettingIPConfig"> <meta name="generator" content="GTK-Doc V1.24 (XML mode)"> <link rel="stylesheet" href="style.css" type="text/css"> </head> @@ -22,7 +22,7 @@ <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> <td><a accesskey="p" href="NMSettingIP4Config.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> -<td><a accesskey="n" href="NMSettingOlpcMesh.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> +<td><a accesskey="n" href="NMSettingIPConfig.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> </tr></table> <div class="refentry"> <a name="NMSettingIP6Config"></a><div class="titlepage"></div> @@ -57,6 +57,14 @@ <a class="link" href="NMSettingIP6Config.html#nm-setting-ip6-config-get-ip6-privacy" title="nm_setting_ip6_config_get_ip6_privacy ()">nm_setting_ip6_config_get_ip6_privacy</a> <span class="c_punctuation">()</span> </td> </tr> +<tr> +<td class="function_type"> +<a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigAddrGenMode" title="enum NMSettingIP6ConfigAddrGenMode"><span class="returnvalue">NMSettingIP6ConfigAddrGenMode</span></a> +</td> +<td class="function_name"> +<a class="link" href="NMSettingIP6Config.html#nm-setting-ip6-config-get-addr-gen-mode" title="nm_setting_ip6_config_get_addr_gen_mode ()">nm_setting_ip6_config_get_addr_gen_mode</a> <span class="c_punctuation">()</span> +</td> +</tr> </tbody> </table></div> </div> @@ -68,11 +76,18 @@ <col width="300px" class="properties_name"> <col width="200px" class="properties_flags"> </colgroup> -<tbody><tr> +<tbody> +<tr> +<td class="property_type"><span class="type">gint</span></td> +<td class="property_name"><a class="link" href="NMSettingIP6Config.html#NMSettingIP6Config--addr-gen-mode" title="The “addr-gen-mode” property">addr-gen-mode</a></td> +<td class="property_flags">Read / Write / Construct</td> +</tr> +<tr> <td class="property_type"><a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigPrivacy" title="enum NMSettingIP6ConfigPrivacy"><span class="type">NMSettingIP6ConfigPrivacy</span></a></td> <td class="property_name"><a class="link" href="NMSettingIP6Config.html#NMSettingIP6Config--ip6-privacy" title="The “ip6-privacy” property">ip6-privacy</a></td> <td class="property_flags">Read / Write / Construct</td> -</tr></tbody> +</tr> +</tbody> </table></div> </div> <div class="refsect1"> @@ -93,6 +108,10 @@ </tr> <tr> <td class="define_keyword">#define</td> +<td class="function_name"><a class="link" href="NMSettingIP6Config.html#NM-SETTING-IP6-CONFIG-ADDR-GEN-MODE:CAPS" title="NM_SETTING_IP6_CONFIG_ADDR_GEN_MODE">NM_SETTING_IP6_CONFIG_ADDR_GEN_MODE</a></td> +</tr> +<tr> +<td class="define_keyword">#define</td> <td class="function_name"><a class="link" href="NMSettingIP6Config.html#NM-SETTING-IP6-CONFIG-METHOD-IGNORE:CAPS" title="NM_SETTING_IP6_CONFIG_METHOD_IGNORE">NM_SETTING_IP6_CONFIG_METHOD_IGNORE</a></td> </tr> <tr> @@ -119,12 +138,17 @@ <td class="datatype_keyword">enum</td> <td class="function_name"><a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigPrivacy" title="enum NMSettingIP6ConfigPrivacy">NMSettingIP6ConfigPrivacy</a></td> </tr> +<tr> +<td class="datatype_keyword">enum</td> +<td class="function_name"><a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigAddrGenMode" title="enum NMSettingIP6ConfigAddrGenMode">NMSettingIP6ConfigAddrGenMode</a></td> +</tr> </tbody> </table></div> </div> <div class="refsect1"> <a name="NMSettingIP6Config.object-hierarchy"></a><h2>Object Hierarchy</h2> -<pre class="screen"> GEnum +<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-Enumeration-and-Flag-Types.html">GEnum</a> + <span class="lineart">├──</span> NMSettingIP6ConfigAddrGenMode <span class="lineart">╰──</span> NMSettingIP6ConfigPrivacy GObject <span class="lineart">╰──</span> <a class="link" href="NMSetting.html" title="NMSetting">NMSetting</a> @@ -157,7 +181,7 @@ supported.</p> nm_setting_ip6_config_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre> <p>Creates a new <a class="link" href="NMSettingIP6Config.html" title="NMSettingIP6Config"><span class="type">NMSettingIP6Config</span></a> object with default values.</p> <div class="refsect3"> -<a name="id-1.4.19.8.2.5"></a><h4>Returns</h4> +<a name="id-1.4.18.8.2.5"></a><h4>Returns</h4> <p> the new empty <a class="link" href="NMSettingIP6Config.html" title="NMSettingIP6Config"><span class="type">NMSettingIP6Config</span></a> object. </p> <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p> </div> @@ -170,7 +194,7 @@ nm_setting_ip6_config_get_ip6_privacy (<em class="parameter"><code><a class="lin <p>Returns the value contained in the <a class="link" href="NMSettingIP6Config.html#NMSettingIP6Config--ip6-privacy" title="The “ip6-privacy” property"><span class="type">“ip6-privacy”</span></a> property.</p> <div class="refsect3"> -<a name="id-1.4.19.8.3.5"></a><h4>Parameters</h4> +<a name="id-1.4.18.8.3.5"></a><h4>Parameters</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="150px" class="parameters_name"> @@ -185,10 +209,39 @@ property.</p> </table></div> </div> <div class="refsect3"> -<a name="id-1.4.19.8.3.6"></a><h4>Returns</h4> +<a name="id-1.4.18.8.3.6"></a><h4>Returns</h4> <p> IPv6 Privacy Extensions configuration value (<a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigPrivacy" title="enum NMSettingIP6ConfigPrivacy"><span class="type">NMSettingIP6ConfigPrivacy</span></a>).</p> </div> </div> +<hr> +<div class="refsect2"> +<a name="nm-setting-ip6-config-get-addr-gen-mode"></a><h3>nm_setting_ip6_config_get_addr_gen_mode ()</h3> +<pre class="programlisting"><a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigAddrGenMode" title="enum NMSettingIP6ConfigAddrGenMode"><span class="returnvalue">NMSettingIP6ConfigAddrGenMode</span></a> +nm_setting_ip6_config_get_addr_gen_mode + (<em class="parameter"><code><a class="link" href="NMSettingIP6Config.html" title="NMSettingIP6Config"><span class="type">NMSettingIP6Config</span></a> *setting</code></em>);</pre> +<p>Returns the value contained in the <a class="link" href="NMSettingIP6Config.html#NMSettingIP6Config--addr-gen-mode" title="The “addr-gen-mode” property"><span class="type">“addr-gen-mode”</span></a> +property.</p> +<div class="refsect3"> +<a name="id-1.4.18.8.4.5"></a><h4>Parameters</h4> +<div class="informaltable"><table 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="NMSettingIP6Config.html" title="NMSettingIP6Config"><span class="type">NMSettingIP6Config</span></a></p></td> +<td class="parameter_annotations"> </td> +</tr></tbody> +</table></div> +</div> +<div class="refsect3"> +<a name="id-1.4.18.8.4.6"></a><h4>Returns</h4> +<p> IPv6 Address Generation Mode.</p> +</div> +<p class="since">Since: 1.2</p> +</div> </div> <div class="refsect1"> <a name="NMSettingIP6Config.other_details"></a><h2>Types and Values</h2> @@ -205,6 +258,12 @@ property.</p> </div> <hr> <div class="refsect2"> +<a name="NM-SETTING-IP6-CONFIG-ADDR-GEN-MODE:CAPS"></a><h3>NM_SETTING_IP6_CONFIG_ADDR_GEN_MODE</h3> +<pre class="programlisting">#define NM_SETTING_IP6_CONFIG_ADDR_GEN_MODE "addr-gen-mode" +</pre> +</div> +<hr> +<div class="refsect2"> <a name="NM-SETTING-IP6-CONFIG-METHOD-IGNORE:CAPS"></a><h3>NM_SETTING_IP6_CONFIG_METHOD_IGNORE</h3> <pre class="programlisting">#define NM_SETTING_IP6_CONFIG_METHOD_IGNORE "ignore" </pre> @@ -263,7 +322,7 @@ supported for IPv6)</p> <p><a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigPrivacy" title="enum NMSettingIP6ConfigPrivacy"><span class="type">NMSettingIP6ConfigPrivacy</span></a> values indicate if and how IPv6 Privacy Extensions are used (RFC4941).</p> <div class="refsect3"> -<a name="id-1.4.19.9.10.4"></a><h4>Members</h4> +<a name="id-1.4.18.9.11.4"></a><h4>Members</h4> <div class="informaltable"><table width="100%" border="0"> <colgroup> <col width="300px" class="enum_members_name"> @@ -305,10 +364,74 @@ are enabled and temporary addresses are preferred over public addresses</p> </table></div> </div> </div> +<hr> +<div class="refsect2"> +<a name="NMSettingIP6ConfigAddrGenMode"></a><h3>enum NMSettingIP6ConfigAddrGenMode</h3> +<p><a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigAddrGenMode" title="enum NMSettingIP6ConfigAddrGenMode"><span class="type">NMSettingIP6ConfigAddrGenMode</span></a> controls how the the Interface Identifier for +RFC4862 Stateless Address Autoconfiguration is created.</p> +<div class="refsect3"> +<a name="id-1.4.18.9.12.4"></a><h4>Members</h4> +<div class="informaltable"><table width="100%" border="0"> +<colgroup> +<col width="300px" class="enum_members_name"> +<col class="enum_members_description"> +<col width="200px" class="enum_members_annotations"> +</colgroup> +<tbody> +<tr> +<td class="enum_member_name"><p><a name="NM-SETTING-IP6-CONFIG-ADDR-GEN-MODE-EUI64:CAPS"></a>NM_SETTING_IP6_CONFIG_ADDR_GEN_MODE_EUI64</p></td> +<td class="enum_member_description"> +<p>The Interface Identifier is derived +from the interface hardware address.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="NM-SETTING-IP6-CONFIG-ADDR-GEN-MODE-STABLE-PRIVACY:CAPS"></a>NM_SETTING_IP6_CONFIG_ADDR_GEN_MODE_STABLE_PRIVACY</p></td> +<td class="enum_member_description"> +<p>The Interface Identifier +is created by using a cryptographically secure hash of a secret host-specific +key along with the connection identification and the network address as +specified by RFC7217.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +</tbody> +</table></div> +</div> +<p class="since">Since: 1.2</p> +</div> </div> <div class="refsect1"> <a name="NMSettingIP6Config.property-details"></a><h2>Property Details</h2> <div class="refsect2"> +<a name="NMSettingIP6Config--addr-gen-mode"></a><h3>The <code class="literal">“addr-gen-mode”</code> property</h3> +<pre class="programlisting"> “addr-gen-mode” <span class="type">gint</span></pre> +<p>Configure method for creating the address for use with RFC4862 IPv6 +Stateless Address Autoconfiguration. The permitted values are: "eui64", +"stable-privacy" or unset.</p> +<p>If the property is set to "eui64", the addresses will be generated +using the interface tokens derived from hardware address. This makes +the host part of the address to stay constant, making it possible +to track host's presence when it changes networks. The address changes +when the interface hardware is replaced.</p> +<p>The value of "stable-privacy" enables use of cryptographically +secure hash of a secret host-specific key along with the connection +identification and the network address as specified by RFC7217. +This makes it impossible to use the address track host's presence, +and makes the address stable when the network interface hardware is +replaced.</p> +<p>Leaving this unset causes a default that could be subject to change +in future versions to be used.</p> +<p>Note that this setting is distinct from the Privacy Extensions as +configured by "ip6-privacy" property and it does not affect the +temporary addresses configured with this option.</p> +<p>Flags: Read / Write / Construct</p> +<p>Default value: 1</p> +<p class="since">Since: 1.2</p> +</div> +<hr> +<div class="refsect2"> <a name="NMSettingIP6Config--ip6-privacy"></a><h3>The <code class="literal">“ip6-privacy”</code> property</h3> <pre class="programlisting"> “ip6-privacy” <a class="link" href="NMSettingIP6Config.html#NMSettingIP6ConfigPrivacy" title="enum NMSettingIP6ConfigPrivacy"><span class="type">NMSettingIP6ConfigPrivacy</span></a></pre> <p>Configure IPv6 Privacy Extensions for SLAAC, described in RFC4941. If @@ -322,6 +445,9 @@ addresses).</p> global configuration "ipv6.ip6-privacy".</p> <p>If also global configuration is unspecified or set to "-1", fallback to read "/proc/sys/net/ipv6/conf/default/use_tempaddr".</p> +<p>Note that this setting is distinct from the Stable Privacy addresses +that can be enabled with the "addr-gen-mode" property's "stable-privacy" +setting as another way of avoiding host tracking with IPv6 addresses.</p> <p>Flags: Read / Write / Construct</p> <p>Default value: NM_SETTING_IP6_CONFIG_PRIVACY_UNKNOWN</p> </div> |