From 70e18d99b8e3e77bb37e218d7ac582130156f8ef Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Thu, 25 Jan 2024 09:46:18 +0100 Subject: New upstream version 1.45.90 --- docs/libnm/html/libnm-nm-utils.html | 50 +++++++++++++++++++++++++++++-------- 1 file changed, 40 insertions(+), 10 deletions(-) (limited to 'docs/libnm/html/libnm-nm-utils.html') diff --git a/docs/libnm/html/libnm-nm-utils.html b/docs/libnm/html/libnm-nm-utils.html index a4846dcf..7d53938f 100644 --- a/docs/libnm/html/libnm-nm-utils.html +++ b/docs/libnm/html/libnm-nm-utils.html @@ -716,10 +716,16 @@ number of known SSID-cloaking methods.

const char *
 nm_utils_escape_ssid (const guint8 *ssid,
                       gsize len);
+
+

nm_utils_escape_ssid has been deprecated since version 1.46 and should not be used in newly-written code.

+

use nm_utils_ssid_to_utf8() or nm_utils_bin2hexstr().

+

This function does a quick printable character conversion of the SSID, simply replacing embedded NULLs and non-printable characters with the hexadecimal representation of that character. Intended for debugging only, should not be used for display of SSIDs.

+

Warning: this function uses a static buffer. It is not thread-safe. Don't + use this function.

Parameters

@@ -1118,6 +1124,8 @@ type 'au' representing an array of IPv4 addresses.

nm_utils_ip4_dns_from_variant (GVariant *value);

Utility function to convert a GVariant of type 'au' representing a list of IPv4 addresses into an array of IP address strings.

+

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

@@ -1191,7 +1199,10 @@ NetworkManager IPv4 addresses (which are tuples of address, prefix, and gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field of the first address (if set) will be returned in out_gateway ; the "gateway" fields -of the other addresses are ignored.

+of the other addresses are ignored. Note that invalid addresses are discarded +but the valid addresses are still returned.

+

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

@@ -1260,7 +1271,10 @@ metric).

nm_utils_ip4_routes_from_variant (GVariant *value);

Utility function to convert a GVariant of type 'aau' representing an array of NetworkManager IPv4 routes (which are tuples of route, prefix, next hop, -and metric) into a GPtrArray of NMIPRoute objects.

+and metric) into a GPtrArray of NMIPRoute objects. Note that invalid routes +are discarded but the valid routes are still returned.

+

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

@@ -1407,6 +1421,8 @@ nm_utils_ip6_dns_from_variant ( +

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

@@ -1481,7 +1497,10 @@ list of NetworkManager IPv6 addresses (which are tuples of address, prefix, and gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field of the first address (if set) will be returned in out_gateway ; the "gateway" -fields of the other addresses are ignored.

+fields of the other addresses are ignored. Note that invalid addresses are +discarded but the valid addresses are still returned.

+

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

@@ -1550,7 +1569,10 @@ metric).

nm_utils_ip6_routes_from_variant (GVariant *value);

Utility function to convert a GVariant of type 'a(ayuayu)' representing an array of NetworkManager IPv6 routes (which are tuples of route, prefix, next -hop, and metric) into a GPtrArray of NMIPRoute objects.

+hop, and metric) into a GPtrArray of NMIPRoute objects. Note that invalid +routes are ignored but the valid ones are still returned.

+

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

@@ -1615,7 +1637,10 @@ nm_utils_ip_addresses_from_variant (GVariant representing a list of new-style NetworkManager IPv4 or IPv6 addresses (as described in the documentation for nm_utils_ip_addresses_to_variant()) into a GPtrArray of NMIPAddress -objects.

+objects. Note that invalid addresses are discarded but the valid addresses +are still returned.

+

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

@@ -1653,8 +1678,11 @@ objects.

nm_utils_ip_routes_to_variant (GPtrArray *routes);

Utility function to convert a GPtrArray of NMIPRoute objects representing IPv4 or IPv6 routes into a GVariant of type 'aa{sv}' representing an array -of new-style NetworkManager IP routes (which are tuples of destination, -prefix, next hop, metric, and additional attributes).

+of new-style NetworkManager IP routes. All routes will include "dest" (an IP +address string), "prefix" (an uint) and optionally "next-hop" (an IP address +string) and "metric" (an uint). Some routes may include additional attributes. +Note that invalid routes are discarded and only a warning is emitted, but the +valid routes are still returned.

Parameters

@@ -1685,9 +1713,11 @@ prefix, next hop, metric, and additional attributes).

nm_utils_ip_routes_from_variant (GVariant *value, int family);

Utility function to convert a GVariant representing a list of new-style -NetworkManager IPv4 or IPv6 addresses (which are tuples of destination, -prefix, next hop, metric, and additional attributes) into a GPtrArray of -NMIPRoute objects.

+NetworkManager IPv4 or IPv6 addresses (as described in the documentation for +nm_utils_ip_routes_to_variant()) into a GPtrArray of NMIPRoute objects. +Invalid routes are discarded but the valid routes are still returned.

+

Since 1.46, an empty list is returned if the variant type is not valid +(before it was checked as assertion)

Parameters

-- cgit 1.3.0-6-gf8a5