diff options
| author | Michael Biebl <biebl@debian.org> | 2022-08-26 20:36:29 +0200 |
|---|---|---|
| committer | Michael Biebl <biebl@debian.org> | 2022-08-26 20:36:29 +0200 |
| commit | ab0efddcdb48d800e2f938da54cfe3074640792e (patch) | |
| tree | 88b67be9bb4a4ecc2b6e4d1766dc11bb43a13601 /docs | |
| parent | 0018d1f3cf71d680d7b6bceda55a5717244d8b26 (diff) | |
New upstream version 1.40.0 upstream/1.40.0
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/api/html/NetworkManager.conf.html | 2 | ||||
| -rw-r--r-- | docs/api/html/NetworkManager.devhelp2 | 13 | ||||
| -rw-r--r-- | docs/api/html/index.html | 2 | ||||
| -rw-r--r-- | docs/api/html/nm-dbus-types.html | 23 | ||||
| -rw-r--r-- | docs/api/html/nm-settings-dbus.html | 18 | ||||
| -rw-r--r-- | docs/api/html/nm-settings-nmcli.html | 17 | ||||
| -rw-r--r-- | docs/api/version.xml | 2 | ||||
| -rw-r--r-- | docs/libnm/html/NMRemoteConnection.html | 11 | ||||
| -rw-r--r-- | docs/libnm/html/NMVpnConnection.html | 8 | ||||
| -rw-r--r-- | docs/libnm/html/NMVpnPluginOld.html | 12 | ||||
| -rw-r--r-- | docs/libnm/html/NMVpnServicePlugin.html | 6 | ||||
| -rw-r--r-- | docs/libnm/html/api-index-full.html | 8 | ||||
| -rw-r--r-- | docs/libnm/html/index.html | 2 | ||||
| -rw-r--r-- | docs/libnm/html/libnm-nm-dbus-interface.html | 35 | ||||
| -rw-r--r-- | docs/libnm/html/libnm.devhelp2 | 5 | ||||
| -rw-r--r-- | docs/libnm/html/object-tree.html | 8 | ||||
| -rw-r--r-- | docs/libnm/html/usage.html | 2 | ||||
| -rw-r--r-- | docs/libnm/version.xml | 2 |
18 files changed, 108 insertions, 68 deletions
diff --git a/docs/api/html/NetworkManager.conf.html b/docs/api/html/NetworkManager.conf.html index e2bd8c54..34063973 100644 --- a/docs/api/html/NetworkManager.conf.html +++ b/docs/api/html/NetworkManager.conf.html @@ -818,7 +818,7 @@ ipv6.ip6-privacy=0 </tr> <tr> <td><p><span class="term"><code class="varname">connection.mptcp-flags</code></span></p></td> -<td><p>If unspecified, the fallback is either 0 (<code class="literal">"disabled"</code>) or 0x22 (<code class="literal">"enabled-on-global-iface,subflow"</code>), depending on <code class="literal">/proc/sys/net/mptcp/enabled</code>.</p></td> +<td><p>If unspecified, the fallback is 0x22 (<code class="literal">"enabled,subflow"</code>). Note that if sysctl <code class="literal">/proc/sys/net/mptcp/enabled</code> is disabled, NetworkManager will still not configure endpoints.</p></td> </tr> <tr> <td><p><span class="term"><code class="varname">connection.dns-over-tls</code></span></p></td> diff --git a/docs/api/html/NetworkManager.devhelp2 b/docs/api/html/NetworkManager.devhelp2 index 7fd00dea..257f6bde 100644 --- a/docs/api/html/NetworkManager.devhelp2 +++ b/docs/api/html/NetworkManager.devhelp2 @@ -852,12 +852,13 @@ <keyword type="constant" name="NM_RADIO_FLAG_WWAN_AVAILABLE" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.35.4.2.1.4.3.1.1id-1.4.17.2.35.4.2.1.4.3.1.2"/> <keyword type="constant" name="NM_MPTCP_FLAGS_NONE" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.1.1.1id-1.4.17.2.36.4.2.1.4.1.1.2"/> <keyword type="constant" name="NM_MPTCP_FLAGS_DISABLED" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.2.1.1id-1.4.17.2.36.4.2.1.4.2.1.2"/> - <keyword type="constant" name="NM_MPTCP_FLAGS_ENABLED_ON_GLOBAL_IFACE" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.3.1.1id-1.4.17.2.36.4.2.1.4.3.1.2"/> - <keyword type="constant" name="NM_MPTCP_FLAGS_ENABLED" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.4.1.1id-1.4.17.2.36.4.2.1.4.4.1.2"/> - <keyword type="constant" name="NM_MPTCP_FLAGS_SIGNAL" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.5.1.1id-1.4.17.2.36.4.2.1.4.5.1.2"/> - <keyword type="constant" name="NM_MPTCP_FLAGS_SUBFLOW" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.6.1.1id-1.4.17.2.36.4.2.1.4.6.1.2"/> - <keyword type="constant" name="NM_MPTCP_FLAGS_BACKUP" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.7.1.1id-1.4.17.2.36.4.2.1.4.7.1.2"/> - <keyword type="constant" name="NM_MPTCP_FLAGS_FULLMESH" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.8.1.1id-1.4.17.2.36.4.2.1.4.8.1.2"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_ENABLED" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.3.1.1id-1.4.17.2.36.4.2.1.4.3.1.2"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_ALSO_WITHOUT_SYSCTL" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.4.1.1id-1.4.17.2.36.4.2.1.4.4.1.2"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_ALSO_WITHOUT_DEFAULT_ROUTE" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.5.1.1id-1.4.17.2.36.4.2.1.4.5.1.2"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_SIGNAL" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.6.1.1id-1.4.17.2.36.4.2.1.4.6.1.2"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_SUBFLOW" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.7.1.1id-1.4.17.2.36.4.2.1.4.7.1.2"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_BACKUP" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.8.1.1id-1.4.17.2.36.4.2.1.4.8.1.2"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_FULLMESH" link="nm-dbus-types.htmlnm-dbus-types.html#id-1.4.17.2.36.4.2.1.4.9.1.1id-1.4.17.2.36.4.2.1.4.9.1.2"/> <keyword type="constant" name="NM_VPN_SERVICE_STATE_UNKNOWN" link="nm-vpn-dbus-types.htmlnm-vpn-dbus-types.html#id-1.6.3.2.3.4.2.1.4.1.1.1id-1.6.3.2.3.4.2.1.4.1.1.2"/> <keyword type="constant" name="NM_VPN_SERVICE_STATE_INIT" link="nm-vpn-dbus-types.htmlnm-vpn-dbus-types.html#id-1.6.3.2.3.4.2.1.4.2.1.1id-1.6.3.2.3.4.2.1.4.2.1.2"/> <keyword type="constant" name="NM_VPN_SERVICE_STATE_SHUTDOWN" link="nm-vpn-dbus-types.htmlnm-vpn-dbus-types.html#id-1.6.3.2.3.4.2.1.4.3.1.1id-1.6.3.2.3.4.2.1.4.3.1.2"/> diff --git a/docs/api/html/index.html b/docs/api/html/index.html index 89e8f738..e753eef1 100644 --- a/docs/api/html/index.html +++ b/docs/api/html/index.html @@ -16,7 +16,7 @@ <div> <div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">NetworkManager Reference Manual</p></th></tr></table></div> <div><p class="releaseinfo"> - for NetworkManager 1.39.90 + for NetworkManager 1.40.0 The latest version of this documentation can be found on-line at <a class="ulink" href="https://networkmanager.dev/docs/api/latest/" target="_top">https://networkmanager.dev/docs/api/latest/</a>. diff --git a/docs/api/html/nm-dbus-types.html b/docs/api/html/nm-dbus-types.html index 9935f48c..46152667 100644 --- a/docs/api/html/nm-dbus-types.html +++ b/docs/api/html/nm-dbus-types.html @@ -5366,7 +5366,7 @@ </tr> <tr> <td class="enum_member_name"> -<p>NM_MPTCP_FLAGS_ENABLED_ON_GLOBAL_IFACE</p> +<p>NM_MPTCP_FLAGS_ENABLED</p> <p></p> </td> <td class="enum_member_value"> @@ -5374,14 +5374,14 @@ <p></p> </td> <td class="enum_member_description"> -<p>MPTCP handling is enabled or disabled depending on whether a /0 default route (either IPv4 or IPv6) is configured in the main routing table.</p> +<p>MPTCP is enabled and endpoints will be configured. This flag is implied if any of the other flags indicate that MPTCP is enabled and therefore in most cases unnecessary. Note that if "/proc/sys/net/mptcp/enabled" sysctl is disabled, MPTCP handling is disabled despite this flag. This can be overruled with the "also-without-sysctl" flag. Note that by default interfaces that don't have a default route are excluded from having MPTCP endpoints configured. This can be overruled with the "also-without-default-route" and this affects endpoints per address family.</p> <p></p> </td> <td class="auto-generated"> </td> </tr> <tr> <td class="enum_member_name"> -<p>NM_MPTCP_FLAGS_ENABLED</p> +<p>NM_MPTCP_FLAGS_ALSO_WITHOUT_SYSCTL</p> <p></p> </td> <td class="enum_member_value"> @@ -5389,7 +5389,22 @@ <p></p> </td> <td class="enum_member_description"> -<p>MPTCP is enabled and endpoints will be configured. This flag is implied if any of the other flags indicate that MPTCP is enabled and therefore in most cases unnecessary.</p> +<p>even if MPTCP handling is enabled via the "enabled" flag, it is ignored unless "/proc/sys/net/mptcp/enabled" is on. With this flag, MPTCP endpoints will be configured regardless of the sysctl setting.</p> +<p></p> +</td> +<td class="auto-generated"> </td> +</tr> +<tr> +<td class="enum_member_name"> +<p>NM_MPTCP_FLAGS_ALSO_WITHOUT_DEFAULT_ROUTE</p> +<p></p> +</td> +<td class="enum_member_value"> +<p>= <code class="literal">0x8</code></p> +<p></p> +</td> +<td class="enum_member_description"> +<p>even if MPTCP handling is enabled via the "enabled" flag, it is ignored per-address family unless NetworkManager configures a default route. With this flag, NetworkManager will also configure MPTCP endpoints if there is no default route. This takes effect per-address family.</p> <p></p> </td> <td class="auto-generated"> </td> diff --git a/docs/api/html/nm-settings-dbus.html b/docs/api/html/nm-settings-dbus.html index f0aed252..0903c329 100644 --- a/docs/api/html/nm-settings-dbus.html +++ b/docs/api/html/nm-settings-dbus.html @@ -245,13 +245,15 @@ If "disabled" (0x1), MPTCP handling for the interface is disabled and no endpoints are registered. - The flag "enabled-on-global-iface" (0x2) means that MPTCP handling is enabled if the interface configures a default route in the main routing table. This choice is per-address family, for example if there is an IPv4 default route 0.0.0.0/0, IPv4 endpoints are configured. + The "enabled" (0x2) flag means that MPTCP handling is enabled. This flag can also be implied from the presence of other flags. - The "enabled" (0x4) flag means that MPTCP handling is explicitly enabled. This flag can also be implied from the presence of other flags. + Even when enabled, MPTCP handling will by default still be disabled unless "/proc/sys/net/mptcp/enabled" sysctl is on. NetworkManager does not change the sysctl and this is up to the administrator or distribution. To configure endpoints even if the sysctl is disabled, "also-without-sysctl" (0x4) flag can be used. In that case, NetworkManager doesn't look at the sysctl and configures endpoints regardless. - If MPTCP handling is enabled, then endpoints will be configured with the specified address flags "signal" (0x10), "subflow" (0x20), "backup" (0x40), "fullmesh" (0x80). See ip-mptcp(8) manual for additional information about the flags. + Even when enabled, NetworkManager will only configure MPTCP endpoints for a certain address family, if there is a unicast default route (0.0.0.0/0 or ::/0) in the main routing table. The flag "also-without-default-route" (0x8) can override that. - If the flags are zero, the global connection default from NetworkManager.conf is honored. If still unspecified, the fallback is either "disabled" or "enabled-on-global-iface,subflow" depending on "/proc/sys/net/mptcp/enabled". + When MPTCP handling is enabled then endpoints are configured with the specified address flags "signal" (0x10), "subflow" (0x20), "backup" (0x40), "fullmesh" (0x80). See ip-mptcp(8) manual for additional information about the flags. + + If the flags are zero (0x0), the global connection default from NetworkManager.conf is honored. If still unspecified, the fallback is "enabled,subflow". Note that this means that MPTCP is by default done depending on the "/proc/sys/net/mptcp/enabled" sysctl. NetworkManager does not change the MPTCP limits nor enable MPTCP via "/proc/sys/net/mptcp/enabled". That is a host configuration which the admin can change via sysctl and ip-mptcp. @@ -1805,9 +1807,9 @@ <td align="left"> </td> <td> The gateway associated with this configuration. This is only meaningful if "addresses" is also set. - 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 "never-default" and will be automatically dropped if the IP configuration is set to never-default. + Setting the gateway causes NetworkManager to configure a standard default route with the gateway as next hop. This is ignored if "never-default" is set. An alternative is to configure the default route explicitly with a manual route and /0 as prefix length. - As an alternative to set the gateway, configure a static default route with /0 as prefix length.</td> + Note that the gateway usually conflicts with routing that NetworkManager configures for WireGuard interfaces, so usually it should not be set in that case. See "ip4-auto-default-route".</td> </tr> <tr> <td align="left"> @@ -2099,9 +2101,9 @@ <td align="left"> </td> <td> The gateway associated with this configuration. This is only meaningful if "addresses" is also set. - 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 "never-default" and will be automatically dropped if the IP configuration is set to never-default. + Setting the gateway causes NetworkManager to configure a standard default route with the gateway as next hop. This is ignored if "never-default" is set. An alternative is to configure the default route explicitly with a manual route and /0 as prefix length. - As an alternative to set the gateway, configure a static default route with /0 as prefix length.</td> + Note that the gateway usually conflicts with routing that NetworkManager configures for WireGuard interfaces, so usually it should not be set in that case. See "ip4-auto-default-route".</td> </tr> <tr> <td align="left"> diff --git a/docs/api/html/nm-settings-nmcli.html b/docs/api/html/nm-settings-nmcli.html index 672f9e43..6968e035 100644 --- a/docs/api/html/nm-settings-nmcli.html +++ b/docs/api/html/nm-settings-nmcli.html @@ -217,10 +217,11 @@ <td> <p> Whether to configure MPTCP endpoints and the address flags. If MPTCP is enabled in NetworkManager, it will configure the addresses of the interface as MPTCP endpoints. Note that IPv4 loopback addresses (127.0.0.0/8), IPv4 link local addresses (169.254.0.0/16), the IPv6 loopback address (::1), IPv6 link local addresses (fe80::/10), IPv6 unique local addresses (ULA, fc00::/7) and IPv6 privacy extension addresses (rfc3041, ipv6.ip6-privacy) will be excluded from being configured as endpoints.</p> <p> If "disabled" (0x1), MPTCP handling for the interface is disabled and no endpoints are registered.</p> -<p> The flag "enabled-on-global-iface" (0x2) means that MPTCP handling is enabled if the interface configures a default route in the main routing table. This choice is per-address family, for example if there is an IPv4 default route 0.0.0.0/0, IPv4 endpoints are configured.</p> -<p> The "enabled" (0x4) flag means that MPTCP handling is explicitly enabled. This flag can also be implied from the presence of other flags.</p> -<p> If MPTCP handling is enabled, then endpoints will be configured with the specified address flags "signal" (0x10), "subflow" (0x20), "backup" (0x40), "fullmesh" (0x80). See ip-mptcp(8) manual for additional information about the flags.</p> -<p> If the flags are zero, the global connection default from NetworkManager.conf is honored. If still unspecified, the fallback is either "disabled" or "enabled-on-global-iface,subflow" depending on "/proc/sys/net/mptcp/enabled".</p> +<p> The "enabled" (0x2) flag means that MPTCP handling is enabled. This flag can also be implied from the presence of other flags.</p> +<p> Even when enabled, MPTCP handling will by default still be disabled unless "/proc/sys/net/mptcp/enabled" sysctl is on. NetworkManager does not change the sysctl and this is up to the administrator or distribution. To configure endpoints even if the sysctl is disabled, "also-without-sysctl" (0x4) flag can be used. In that case, NetworkManager doesn't look at the sysctl and configures endpoints regardless.</p> +<p> Even when enabled, NetworkManager will only configure MPTCP endpoints for a certain address family, if there is a unicast default route (0.0.0.0/0 or ::/0) in the main routing table. The flag "also-without-default-route" (0x8) can override that.</p> +<p> When MPTCP handling is enabled then endpoints are configured with the specified address flags "signal" (0x10), "subflow" (0x20), "backup" (0x40), "fullmesh" (0x80). See ip-mptcp(8) manual for additional information about the flags.</p> +<p> If the flags are zero (0x0), the global connection default from NetworkManager.conf is honored. If still unspecified, the fallback is "enabled,subflow". Note that this means that MPTCP is by default done depending on the "/proc/sys/net/mptcp/enabled" sysctl.</p> <p> NetworkManager does not change the MPTCP limits nor enable MPTCP via "/proc/sys/net/mptcp/enabled". That is a host configuration which the admin can change via sysctl and ip-mptcp.</p> <p> Strict reverse path filtering (rp_filter) breaks many MPTCP use cases, so when MPTCP handling for IPv4 addresses on the interface is enabled, NetworkManager would loosen the strict reverse path filtering (1) to the loose setting (2).</p> <p> @@ -2156,8 +2157,8 @@ <p> Alias: gw4</p> <p> The gateway associated with this configuration. This is only meaningful if "addresses" 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 "never-default" 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> Setting the gateway causes NetworkManager to configure a standard default route with the gateway as next hop. This is ignored if "never-default" is set. An alternative is to configure the default route explicitly with a manual route and /0 as prefix length.</p> +<p> Note that the gateway usually conflicts with routing that NetworkManager configures for WireGuard interfaces, so usually it should not be set in that case. See "ip4-auto-default-route".</p> <p> Format: string</p> </td> @@ -2453,8 +2454,8 @@ Example: <code class="literal">priority 5 from 192.167.4.0/24 table 45</code> <p> Alias: gw6</p> <p> The gateway associated with this configuration. This is only meaningful if "addresses" 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 "never-default" 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> Setting the gateway causes NetworkManager to configure a standard default route with the gateway as next hop. This is ignored if "never-default" is set. An alternative is to configure the default route explicitly with a manual route and /0 as prefix length.</p> +<p> Note that the gateway usually conflicts with routing that NetworkManager configures for WireGuard interfaces, so usually it should not be set in that case. See "ip4-auto-default-route".</p> <p> Format: string</p> </td> diff --git a/docs/api/version.xml b/docs/api/version.xml index d3781d71..32b7211c 100644 --- a/docs/api/version.xml +++ b/docs/api/version.xml @@ -1 +1 @@ -1.39.90 +1.40.0 diff --git a/docs/libnm/html/NMRemoteConnection.html b/docs/libnm/html/NMRemoteConnection.html index fbb6a70b..dedf951f 100644 --- a/docs/libnm/html/NMRemoteConnection.html +++ b/docs/libnm/html/NMRemoteConnection.html @@ -803,10 +803,6 @@ nm_remote_connection_get_secrets (<em class="parameter"><code><a class="link" hr <em class="parameter"><code>const <span class="type">char</span> *setting_name</code></em>, <em class="parameter"><code><a href="https://developer.gnome.org/gio/unstable/GCancellable.html#GCancellable-struct"><span class="type">GCancellable</span></a> *cancellable</code></em>, <em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre> -<div class="warning"> -<p><code class="literal">nm_remote_connection_get_secrets</code> has been deprecated since version 1.22 and should not be used in newly-written code.</p> -<p>Use <a class="link" href="NMRemoteConnection.html#nm-remote-connection-get-secrets-async" title="nm_remote_connection_get_secrets_async ()"><code class="function">nm_remote_connection_get_secrets_async()</code></a> or GDBusConnection.</p> -</div> <p>Request the connection's secrets. Note that this is a blocking D-Bus call, not a simple property accessor.</p> <div class="refsect3"> @@ -845,7 +841,12 @@ not a simple property accessor.</p> <a name="nm-remote-connection-get-secrets.returns"></a><h4>Returns</h4> <p>a <a href="https://developer.gnome.org/glib/unstable/glib-GVariant.html#GVariant"><span class="type">GVariant</span></a> of type <code class="literal">NM_VARIANT_TYPE_CONNECTION</code> containing <em class="parameter"><code>connection</code></em> -'s secrets, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error. </p> +'s secrets, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.</p> +<p>Warning: NMClient contains a cache of objects on D-Bus. This cache gets updated +with D-Bus signals when iterating the GMainContext. This function performs a +(pseudo) blocking D-Bus call. Aside blocking, the result will not be in sync +and not be ordered with the content of the NMClient cache. +This function used to be deprecated between 1.22 and 1.38 releases. </p> <p><span class="annotation">[<acronym title="The caller owns the data, and is responsible for free it."><span class="acronym">transfer full</span></acronym>]</span></p> </div> </div> diff --git a/docs/libnm/html/NMVpnConnection.html b/docs/libnm/html/NMVpnConnection.html index 6dfe6f8b..1aeca777 100644 --- a/docs/libnm/html/NMVpnConnection.html +++ b/docs/libnm/html/NMVpnConnection.html @@ -44,7 +44,7 @@ <tbody> <tr> <td class="function_type"> -<span class="returnvalue">NMVpnConnectionState</span> +<a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionState"><span class="returnvalue">NMVpnConnectionState</span></a> </td> <td class="function_name"> <a class="link" href="NMVpnConnection.html#nm-vpn-connection-get-vpn-state" title="nm_vpn_connection_get_vpn_state ()">nm_vpn_connection_get_vpn_state</a> <span class="c_punctuation">()</span> @@ -76,7 +76,7 @@ <td class="property_flags">Read</td> </tr> <tr> -<td class="property_type"><span class="type">NMVpnConnectionState</span></td> +<td class="property_type"><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionState"><span class="type">NMVpnConnectionState</span></a></td> <td class="property_name"><a class="link" href="NMVpnConnection.html#NMVpnConnection--vpn-state" title="The “vpn-state” property">vpn-state</a></td> <td class="property_flags">Read</td> </tr> @@ -136,7 +136,7 @@ <a name="NMVpnConnection.functions_details"></a><h2>Functions</h2> <div class="refsect2"> <a name="nm-vpn-connection-get-vpn-state"></a><h3>nm_vpn_connection_get_vpn_state ()</h3> -<pre class="programlisting"><span class="returnvalue">NMVpnConnectionState</span> +<pre class="programlisting"><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionState"><span class="returnvalue">NMVpnConnectionState</span></a> nm_vpn_connection_get_vpn_state (<em class="parameter"><code><a class="link" href="NMVpnConnection.html" title="NMVpnConnection"><span class="type">NMVpnConnection</span></a> *vpn</code></em>);</pre> <p>Gets the current <a class="link" href="NMVpnConnection.html" title="NMVpnConnection"><span class="type">NMVpnConnection</span></a> state.</p> <div class="refsect3"> @@ -219,7 +219,7 @@ string used by the connection, and must not be modified.</p> <hr> <div class="refsect2"> <a name="NMVpnConnection--vpn-state"></a><h3>The <code class="literal">“vpn-state”</code> property</h3> -<pre class="programlisting"> “vpn-state” <span class="type">NMVpnConnectionState</span></pre> +<pre class="programlisting"> “vpn-state” <a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionState"><span class="type">NMVpnConnectionState</span></a></pre> <p>The VPN state of the active VPN connection.</p> <p>Owner: NMVpnConnection</p> <p>Flags: Read</p> diff --git a/docs/libnm/html/NMVpnPluginOld.html b/docs/libnm/html/NMVpnPluginOld.html index 4d623fe2..bf6a322c 100644 --- a/docs/libnm/html/NMVpnPluginOld.html +++ b/docs/libnm/html/NMVpnPluginOld.html @@ -53,7 +53,7 @@ </tr> <tr> <td class="function_type"> -<span class="returnvalue">NMVpnServiceState</span> +<a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState"><span class="returnvalue">NMVpnServiceState</span></a> </td> <td class="function_name"> <a class="link" href="NMVpnPluginOld.html#nm-vpn-plugin-old-get-state" title="nm_vpn_plugin_old_get_state ()">nm_vpn_plugin_old_get_state</a> <span class="c_punctuation">()</span> @@ -158,7 +158,7 @@ <td class="property_flags">Read / Write / Construct Only</td> </tr> <tr> -<td class="property_type"><span class="type">NMVpnServiceState</span></td> +<td class="property_type"><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState"><span class="type">NMVpnServiceState</span></a></td> <td class="property_name"><a class="link" href="NMVpnPluginOld.html#NMVpnPluginOld--state" title="The “state” property">state</a></td> <td class="property_flags">Read / Write</td> </tr> @@ -274,7 +274,7 @@ nm_vpn_plugin_old_get_connection (<em class="parameter"><code><a class="link" hr <hr> <div class="refsect2"> <a name="nm-vpn-plugin-old-get-state"></a><h3>nm_vpn_plugin_old_get_state ()</h3> -<pre class="programlisting"><span class="returnvalue">NMVpnServiceState</span> +<pre class="programlisting"><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState"><span class="returnvalue">NMVpnServiceState</span></a> nm_vpn_plugin_old_get_state (<em class="parameter"><code><a class="link" href="NMVpnPluginOld.html" title="NMVpnPluginOld"><span class="type">NMVpnPluginOld</span></a> *plugin</code></em>);</pre> <div class="warning"> <p><code class="literal">nm_vpn_plugin_old_get_state</code> has been deprecated since version 1.2 and should not be used in newly-written code.</p> @@ -286,7 +286,7 @@ nm_vpn_plugin_old_get_state (<em class="parameter"><code><a class="link" href="N <a name="nm-vpn-plugin-old-set-state"></a><h3>nm_vpn_plugin_old_set_state ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> nm_vpn_plugin_old_set_state (<em class="parameter"><code><a class="link" href="NMVpnPluginOld.html" title="NMVpnPluginOld"><span class="type">NMVpnPluginOld</span></a> *plugin</code></em>, - <em class="parameter"><code><span class="type">NMVpnServiceState</span> state</code></em>);</pre> + <em class="parameter"><code><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState"><span class="type">NMVpnServiceState</span></a> state</code></em>);</pre> <div class="warning"> <p><code class="literal">nm_vpn_plugin_old_set_state</code> has been deprecated since version 1.2 and should not be used in newly-written code.</p> <p>Replaced by NMVpnServicePlugin.</p> @@ -352,7 +352,7 @@ nm_vpn_plugin_old_set_login_banner (<em class="parameter"><code><a class="link" <a name="nm-vpn-plugin-old-failure"></a><h3>nm_vpn_plugin_old_failure ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> nm_vpn_plugin_old_failure (<em class="parameter"><code><a class="link" href="NMVpnPluginOld.html" title="NMVpnPluginOld"><span class="type">NMVpnPluginOld</span></a> *plugin</code></em>, - <em class="parameter"><code><span class="type">NMVpnPluginFailure</span> reason</code></em>);</pre> + <em class="parameter"><code><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnPluginFailure"><span class="type">NMVpnPluginFailure</span></a> reason</code></em>);</pre> <div class="warning"> <p><code class="literal">nm_vpn_plugin_old_failure</code> has been deprecated since version 1.2 and should not be used in newly-written code.</p> <p>Replaced by NMVpnServicePlugin.</p> @@ -535,7 +535,7 @@ to flags, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macro <hr> <div class="refsect2"> <a name="NMVpnPluginOld--state"></a><h3>The <code class="literal">“state”</code> property</h3> -<pre class="programlisting"> “state” <span class="type">NMVpnServiceState</span></pre> +<pre class="programlisting"> “state” <a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState"><span class="type">NMVpnServiceState</span></a></pre> <p>The state of the plugin.</p> <div class="warning"> <p><code class="literal">NMVpnPluginOld:state</code> has been deprecated since version 1.2 and should not be used in newly-written code.</p> diff --git a/docs/libnm/html/NMVpnServicePlugin.html b/docs/libnm/html/NMVpnServicePlugin.html index cd038c2e..965727a3 100644 --- a/docs/libnm/html/NMVpnServicePlugin.html +++ b/docs/libnm/html/NMVpnServicePlugin.html @@ -150,7 +150,7 @@ <td class="property_flags">Read / Write / Construct Only</td> </tr> <tr> -<td class="property_type"><span class="type">NMVpnServiceState</span></td> +<td class="property_type"><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState"><span class="type">NMVpnServiceState</span></a></td> <td class="property_name"><a class="link" href="NMVpnServicePlugin.html#NMVpnServicePlugin--state" title="The “state” property">state</a></td> <td class="property_flags">Read / Write</td> </tr> @@ -324,7 +324,7 @@ nm_vpn_service_plugin_set_login_banner <a name="nm-vpn-service-plugin-failure"></a><h3>nm_vpn_service_plugin_failure ()</h3> <pre class="programlisting"><span class="returnvalue">void</span> nm_vpn_service_plugin_failure (<em class="parameter"><code><a class="link" href="NMVpnServicePlugin.html" title="NMVpnServicePlugin"><span class="type">NMVpnServicePlugin</span></a> *plugin</code></em>, - <em class="parameter"><code><span class="type">NMVpnPluginFailure</span> reason</code></em>);</pre> + <em class="parameter"><code><a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnPluginFailure"><span class="type">NMVpnPluginFailure</span></a> reason</code></em>);</pre> </div> <hr> <div class="refsect2"> @@ -515,7 +515,7 @@ to flags, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macro <hr> <div class="refsect2"> <a name="NMVpnServicePlugin--state"></a><h3>The <code class="literal">“state”</code> property</h3> -<pre class="programlisting"> “state” <span class="type">NMVpnServiceState</span></pre> +<pre class="programlisting"> “state” <a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState"><span class="type">NMVpnServiceState</span></a></pre> <p>The state of the plugin.</p> <p>Owner: NMVpnServicePlugin</p> <p>Flags: Read / Write</p> diff --git a/docs/libnm/html/api-index-full.html b/docs/libnm/html/api-index-full.html index a1c2086d..7a730e98 100644 --- a/docs/libnm/html/api-index-full.html +++ b/docs/libnm/html/api-index-full.html @@ -3761,11 +3761,11 @@ NMUtilsPredicateStr, user_function in NMSettingOvs </dt> <dd></dd> <dt> -NMVpnConnectionState, enum in nm-vpn-dbus-interface +<a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionState">NMVpnConnectionState</a>, enum in nm-vpn-dbus-interface </dt> <dd></dd> <dt> -NMVpnConnectionStateReason, enum in nm-vpn-dbus-interface +<a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionStateReason">NMVpnConnectionStateReason</a>, enum in nm-vpn-dbus-interface </dt> <dd></dd> <dt> @@ -3817,7 +3817,7 @@ NMVpnConnectionStateReason, enum in nm-vpn-dbus-interface </dt> <dd></dd> <dt> -NMVpnPluginFailure, enum in nm-vpn-dbus-interface +<a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnPluginFailure">NMVpnPluginFailure</a>, enum in nm-vpn-dbus-interface </dt> <dd></dd> <dt> @@ -3929,7 +3929,7 @@ NMVpnPluginFailure, enum in nm-vpn-dbus-interface </dt> <dd></dd> <dt> -NMVpnServiceState, enum in nm-vpn-dbus-interface +<a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState">NMVpnServiceState</a>, enum in nm-vpn-dbus-interface </dt> <dd></dd> <dt> diff --git a/docs/libnm/html/index.html b/docs/libnm/html/index.html index 73821288..f9ea840b 100644 --- a/docs/libnm/html/index.html +++ b/docs/libnm/html/index.html @@ -15,7 +15,7 @@ <div> <div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">libnm Reference Manual</p></th></tr></table></div> <div><p class="releaseinfo"> - for libnm 1.39.90 + for libnm 1.40.0 The latest version of this documentation can be found on-line at <a class="ulink" href="https://networkmanager.dev/docs/libnm/latest/" target="_top">https://networkmanager.dev/docs/libnm/latest/</a>. diff --git a/docs/libnm/html/libnm-nm-dbus-interface.html b/docs/libnm/html/libnm-nm-dbus-interface.html index 1585ca83..36eb69f8 100644 --- a/docs/libnm/html/libnm-nm-dbus-interface.html +++ b/docs/libnm/html/libnm-nm-dbus-interface.html @@ -4116,20 +4116,39 @@ is detected in the system.</p> <td class="enum_member_annotations"> </td> </tr> <tr> -<td class="enum_member_name"><p><a name="NM-MPTCP-FLAGS-ENABLED-ON-GLOBAL-IFACE:CAPS"></a>NM_MPTCP_FLAGS_ENABLED_ON_GLOBAL_IFACE</p></td> +<td class="enum_member_name"><p><a name="NM-MPTCP-FLAGS-ENABLED:CAPS"></a>NM_MPTCP_FLAGS_ENABLED</p></td> <td class="enum_member_description"> -<p>MPTCP handling is enabled -or disabled depending on whether a /0 default route (either IPv4 or IPv6) is -configured in the main routing table.</p> +<p>MPTCP is enabled and endpoints will be configured. +This flag is implied if any of the other flags indicate that +MPTCP is enabled and therefore in most cases unnecessary. +Note that if "/proc/sys/net/mptcp/enabled" sysctl is disabled, MPTCP +handling is disabled despite this flag. This can be overruled with the +"also-without-sysctl" flag. +Note that by default interfaces that don't have a default route are +excluded from having MPTCP endpoints configured. This can be overruled +with the "also-without-default-route" and this affects endpoints +per address family.</p> </td> <td class="enum_member_annotations"> </td> </tr> <tr> -<td class="enum_member_name"><p><a name="NM-MPTCP-FLAGS-ENABLED:CAPS"></a>NM_MPTCP_FLAGS_ENABLED</p></td> +<td class="enum_member_name"><p><a name="NM-MPTCP-FLAGS-ALSO-WITHOUT-SYSCTL:CAPS"></a>NM_MPTCP_FLAGS_ALSO_WITHOUT_SYSCTL</p></td> <td class="enum_member_description"> -<p>MPTCP is enabled and endpoints will be configured. -This flag is implied if any of the other flags indicate that -MPTCP is enabled and therefore in most cases unnecessary.</p> +<p>even if MPTCP handling is enabled +via the "enabled" flag, it is ignored unless "/proc/sys/net/mptcp/enabled" +is on. With this flag, MPTCP endpoints will be configured regardless +of the sysctl setting.</p> +</td> +<td class="enum_member_annotations"> </td> +</tr> +<tr> +<td class="enum_member_name"><p><a name="NM-MPTCP-FLAGS-ALSO-WITHOUT-DEFAULT-ROUTE:CAPS"></a>NM_MPTCP_FLAGS_ALSO_WITHOUT_DEFAULT_ROUTE</p></td> +<td class="enum_member_description"> +<p>even if MPTCP handling is enabled +via the "enabled" flag, it is ignored per-address family unless NetworkManager +configures a default route. With this flag, NetworkManager will also configure +MPTCP endpoints if there is no default route. This takes effect per-address +family.</p> </td> <td class="enum_member_annotations"> </td> </tr> diff --git a/docs/libnm/html/libnm.devhelp2 b/docs/libnm/html/libnm.devhelp2 index b245c127..18e1826c 100644 --- a/docs/libnm/html/libnm.devhelp2 +++ b/docs/libnm/html/libnm.devhelp2 @@ -589,7 +589,7 @@ <keyword type="function" name="nm_remote_connection_delete ()" link="NMRemoteConnection.html#nm-remote-connection-delete" deprecated="1.22: Use nm_remote_connection_delete_async() or GDBusConnection."/> <keyword type="function" name="nm_remote_connection_delete_async ()" link="NMRemoteConnection.html#nm-remote-connection-delete-async"/> <keyword type="function" name="nm_remote_connection_delete_finish ()" link="NMRemoteConnection.html#nm-remote-connection-delete-finish"/> - <keyword type="function" name="nm_remote_connection_get_secrets ()" link="NMRemoteConnection.html#nm-remote-connection-get-secrets" deprecated="1.22: Use nm_remote_connection_get_secrets_async() or GDBusConnection."/> + <keyword type="function" name="nm_remote_connection_get_secrets ()" link="NMRemoteConnection.html#nm-remote-connection-get-secrets"/> <keyword type="function" name="nm_remote_connection_get_secrets_async ()" link="NMRemoteConnection.html#nm-remote-connection-get-secrets-async"/> <keyword type="function" name="nm_remote_connection_get_secrets_finish ()" link="NMRemoteConnection.html#nm-remote-connection-get-secrets-finish"/> <keyword type="function" name="nm_remote_connection_get_unsaved ()" link="NMRemoteConnection.html#nm-remote-connection-get-unsaved"/> @@ -3529,8 +3529,9 @@ <keyword type="constant" name="NM_RADIO_FLAG_WWAN_AVAILABLE" link="libnm-nm-dbus-interface.html#NM-RADIO-FLAG-WWAN-AVAILABLE:CAPS"/> <keyword type="constant" name="NM_MPTCP_FLAGS_NONE" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-NONE:CAPS"/> <keyword type="constant" name="NM_MPTCP_FLAGS_DISABLED" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-DISABLED:CAPS"/> - <keyword type="constant" name="NM_MPTCP_FLAGS_ENABLED_ON_GLOBAL_IFACE" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-ENABLED-ON-GLOBAL-IFACE:CAPS"/> <keyword type="constant" name="NM_MPTCP_FLAGS_ENABLED" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-ENABLED:CAPS"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_ALSO_WITHOUT_SYSCTL" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-ALSO-WITHOUT-SYSCTL:CAPS"/> + <keyword type="constant" name="NM_MPTCP_FLAGS_ALSO_WITHOUT_DEFAULT_ROUTE" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-ALSO-WITHOUT-DEFAULT-ROUTE:CAPS"/> <keyword type="constant" name="NM_MPTCP_FLAGS_SIGNAL" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-SIGNAL:CAPS"/> <keyword type="constant" name="NM_MPTCP_FLAGS_SUBFLOW" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-SUBFLOW:CAPS"/> <keyword type="constant" name="NM_MPTCP_FLAGS_BACKUP" link="libnm-nm-dbus-interface.html#NM-MPTCP-FLAGS-BACKUP:CAPS"/> diff --git a/docs/libnm/html/object-tree.html b/docs/libnm/html/object-tree.html index 04306fd0..ebc3205c 100644 --- a/docs/libnm/html/object-tree.html +++ b/docs/libnm/html/object-tree.html @@ -214,10 +214,10 @@ <span class="lineart">├──</span> <a class="link" href="libnm-nm-dbus-interface.html#NMTernary" title="enum NMTernary">NMTernary</a> <span class="lineart">├──</span> <a class="link" href="libnm-nm-utils.html#NMUtilsSecurityType" title="enum NMUtilsSecurityType">NMUtilsSecurityType</a> <span class="lineart">├──</span> <a class="link" href="NMSettingVlan.html#NMVlanPriorityMap" title="enum NMVlanPriorityMap">NMVlanPriorityMap</a> - <span class="lineart">├──</span> NMVpnConnectionState - <span class="lineart">├──</span> NMVpnConnectionStateReason - <span class="lineart">├──</span> NMVpnPluginFailure - <span class="lineart">├──</span> NMVpnServiceState + <span class="lineart">├──</span> <a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionState">NMVpnConnectionState</a> + <span class="lineart">├──</span> <a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnConnectionStateReason">NMVpnConnectionStateReason</a> + <span class="lineart">├──</span> <a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnPluginFailure">NMVpnPluginFailure</a> + <span class="lineart">├──</span> <a href="/usr/share/gtk-doc/html/NetworkManager/nm-vpn-dbus-types.html#NMVpnServiceState">NMVpnServiceState</a> <span class="lineart">├──</span> <a class="link" href="NMSettingWirelessSecurity.html#NMWepKeyType" title="enum NMWepKeyType">NMWepKeyType</a> <span class="lineart">╰──</span> <a class="link" href="libnm-nm-dbus-interface.html#NMWimaxNspNetworkType" title="enum NMWimaxNspNetworkType">NMWimaxNspNetworkType</a> <a href="/usr/share/gtk-doc/html/gobject/gobject-Boxed-Types.html">GBoxed</a> diff --git a/docs/libnm/html/usage.html b/docs/libnm/html/usage.html index cc2062d0..5b5fb9ab 100644 --- a/docs/libnm/html/usage.html +++ b/docs/libnm/html/usage.html @@ -96,7 +96,7 @@ </p> <pre class="screen"><code class="prompt">$ </code><strong class="userinput"><code>cc $(pkg-config --libs --cflags libnm) -o hello-nm hello-nm.c</code></strong> <code class="prompt">$ </code><strong class="userinput"><code>./hello-nm</code></strong> - NetworkManager version: 1.39.90 + NetworkManager version: 1.40.0 <code class="prompt">$ </code></pre> <p> diff --git a/docs/libnm/version.xml b/docs/libnm/version.xml index d3781d71..32b7211c 100644 --- a/docs/libnm/version.xml +++ b/docs/libnm/version.xml @@ -1 +1 @@ -1.39.90 +1.40.0 |