From c333f062ddcba9b35330647bf6cbd0a07f2d786e Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Thu, 11 May 2017 14:55:55 +0200 Subject: New upstream version 1.8.0 --- docs/libnm/html/libnm-nm-utils.html | 649 +++++++++++++++++++++--------------- 1 file changed, 371 insertions(+), 278 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 a794916f..fdd9876f 100644 --- a/docs/libnm/html/libnm-nm-utils.html +++ b/docs/libnm/html/libnm-nm-utils.html @@ -42,7 +42,7 @@ -gboolean +gboolean nm_utils_is_empty_ssid () @@ -57,7 +57,7 @@ -gboolean +gboolean nm_utils_same_ssid () @@ -73,7 +73,7 @@ -gboolean +gboolean nm_utils_security_valid () @@ -81,7 +81,7 @@ -gboolean +gboolean nm_utils_ap_mode_security_valid () @@ -89,7 +89,7 @@ -gboolean +gboolean nm_utils_wep_key_valid () @@ -97,7 +97,7 @@ -gboolean +gboolean nm_utils_wpa_psk_valid () @@ -105,7 +105,7 @@ -gboolean +gboolean nm_utils_is_json_object () @@ -113,7 +113,7 @@ -GVariant * +GVariant * nm_utils_ip4_dns_to_variant () @@ -129,7 +129,7 @@ -GVariant * +GVariant * nm_utils_ip4_addresses_to_variant () @@ -137,7 +137,7 @@ -GPtrArray * +GPtrArray * nm_utils_ip4_addresses_from_variant () @@ -145,7 +145,7 @@ -GVariant * +GVariant * nm_utils_ip4_routes_to_variant () @@ -153,7 +153,7 @@ -GPtrArray * +GPtrArray * nm_utils_ip4_routes_from_variant () @@ -161,7 +161,7 @@ -guint32 +guint32 nm_utils_ip4_netmask_to_prefix () @@ -169,7 +169,7 @@ -guint32 +guint32 nm_utils_ip4_prefix_to_netmask () @@ -177,7 +177,7 @@ -guint32 +guint32 nm_utils_ip4_get_default_prefix () @@ -185,7 +185,7 @@ -GVariant * +GVariant * nm_utils_ip6_dns_to_variant () @@ -201,7 +201,7 @@ -GVariant * +GVariant * nm_utils_ip6_addresses_to_variant () @@ -209,7 +209,7 @@ -GPtrArray * +GPtrArray * nm_utils_ip6_addresses_from_variant () @@ -217,7 +217,7 @@ -GVariant * +GVariant * nm_utils_ip6_routes_to_variant () @@ -225,7 +225,7 @@ -GPtrArray * +GPtrArray * nm_utils_ip6_routes_from_variant () @@ -233,7 +233,7 @@ -GVariant * +GVariant * nm_utils_ip_addresses_to_variant () @@ -241,7 +241,7 @@ -GPtrArray * +GPtrArray * nm_utils_ip_addresses_from_variant () @@ -249,7 +249,7 @@ -GVariant * +GVariant * nm_utils_ip_routes_to_variant () @@ -257,7 +257,7 @@ -GPtrArray * +GPtrArray * nm_utils_ip_routes_from_variant () @@ -273,7 +273,7 @@ -gboolean +gboolean nm_utils_file_is_certificate () @@ -281,7 +281,7 @@ -gboolean +gboolean nm_utils_file_is_private_key () @@ -289,7 +289,7 @@ -gboolean +gboolean nm_utils_file_is_pkcs12 () @@ -297,7 +297,7 @@ -gboolean +gboolean (*NMUtilsFileSearchInPathsPredicate) () @@ -305,7 +305,7 @@ -gboolean +gboolean (*NMUtilsCheckFilePredicate) () @@ -320,7 +320,7 @@ -guint32 +guint32 nm_utils_wifi_freq_to_channel () @@ -328,7 +328,7 @@ -guint32 +guint32 nm_utils_wifi_channel_to_freq () @@ -336,7 +336,7 @@ -guint32 +guint32 nm_utils_wifi_find_next_channel () @@ -344,21 +344,21 @@ -gboolean +gboolean nm_utils_wifi_is_channel_valid () -const guint * +const guint * nm_utils_wifi_2ghz_freqs () -const guint * +const guint * nm_utils_wifi_5ghz_freqs () @@ -373,7 +373,7 @@ -gsize +gsize nm_utils_hwaddr_len () @@ -389,7 +389,7 @@ -GByteArray * +GByteArray * nm_utils_hwaddr_atoba () @@ -397,7 +397,7 @@ -guint8 * +guint8 * nm_utils_hwaddr_aton () @@ -405,7 +405,7 @@ -gboolean +gboolean nm_utils_hwaddr_valid () @@ -421,7 +421,7 @@ -gboolean +gboolean nm_utils_hwaddr_matches () @@ -437,7 +437,7 @@ -GBytes * +GBytes * nm_utils_hexstr2bin () @@ -445,7 +445,7 @@ -gboolean +gboolean nm_utils_iface_valid_name () @@ -453,7 +453,7 @@ -gboolean +gboolean nm_utils_is_valid_iface_name () @@ -461,7 +461,7 @@ -gboolean +gboolean nm_utils_is_uuid () @@ -483,7 +483,7 @@ -gboolean +gboolean nm_utils_ipaddr_valid () @@ -491,7 +491,7 @@ -gboolean +gboolean nm_utils_check_virtual_device_compatibility () @@ -522,7 +522,7 @@ -gboolean +gboolean nm_utils_enum_from_str () @@ -537,12 +537,28 @@ -guint +guint nm_utils_version () + + +GHashTable * + + +nm_utils_parse_variant_attributes () + + + + +char * + + +nm_utils_format_variant_attributes () + + @@ -567,6 +583,10 @@ NM_UTILS_INET_ADDRSTRLEN +  +NMVariantAttributeSpec + + struct stat @@ -575,7 +595,7 @@

Object Hierarchy

-
    GEnum
+
    GEnum
     ╰── NMUtilsSecurityType
@@ -588,9 +608,9 @@ access points and devices, among other things.

Functions

nm_utils_is_empty_ssid ()

-
gboolean
-nm_utils_is_empty_ssid (const guint8 *ssid,
-                        gsize len);
+
gboolean
+nm_utils_is_empty_ssid (const guint8 *ssid,
+                        gsize len);

Different manufacturers use different mechanisms for not broadcasting the AP's SSID. This function attempts to detect blank/empty SSIDs using a number of known SSID-cloaking methods.

@@ -619,15 +639,15 @@ number of known SSID-cloaking methods.

Returns

-

TRUE if the SSID is "empty", FALSE if it is not

+

TRUE if the SSID is "empty", FALSE if it is not

nm_utils_escape_ssid ()

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

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 @@ -664,12 +684,12 @@ and will be overwritten by subsequent calls to this function

nm_utils_same_ssid ()

-
gboolean
-nm_utils_same_ssid (const guint8 *ssid1,
-                    gsize len1,
-                    const guint8 *ssid2,
-                    gsize len2,
-                    gboolean ignore_trailing_null);
+
gboolean
+nm_utils_same_ssid (const guint8 *ssid1,
+                    gsize len1,
+                    const guint8 *ssid2,
+                    gsize len2,
+                    gboolean ignore_trailing_null);

Earlier versions of the Linux kernel added a NULL byte to the end of the SSID to enable easy printing of the SSID on the console or in a terminal, but this behavior was problematic (SSIDs are simply byte arrays, not strings) @@ -709,7 +729,7 @@ NULLs, even though that is functionally pointless.

ignore_trailing_null

-

TRUE to ignore one trailing NULL byte

+

TRUE to ignore one trailing NULL byte

  @@ -717,15 +737,15 @@ NULLs, even though that is functionally pointless.

Returns

-

TRUE if the SSIDs are the same, FALSE if they are not

+

TRUE if the SSIDs are the same, FALSE if they are not

nm_utils_ssid_to_utf8 ()

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

Wi-Fi SSIDs are byte arrays, they are _not_ strings. Thus, an SSID may contain embedded NULLs and other unprintable characters. Often it is useful to print the SSID out for debugging purposes, but that should be the @@ -771,19 +791,19 @@ _only_.

Returns

an allocated string containing a UTF-8 -representation of the SSID, which must be freed by the caller using g_free(). -Returns NULL on errors.

+representation of the SSID, which must be freed by the caller using g_free(). +Returns NULL on errors.

[transfer full]

nm_utils_security_valid ()

-
gboolean
+
gboolean
 nm_utils_security_valid (NMUtilsSecurityType type,
                          NMDeviceWifiCapabilities wifi_caps,
-                         gboolean have_ap,
-                         gboolean adhoc,
+                         gboolean have_ap,
+                         gboolean adhoc,
                          NM80211ApFlags ap_flags,
                          NM80211ApSecurityFlags ap_wpa,
                          NM80211ApSecurityFlags ap_rsn);

@@ -848,15 +868,15 @@ e.g. (
 
Returns

-
 TRUE if the device capabilities and AP capabilties intersect and are
+
 TRUE if the device capabilities and AP capabilties intersect and are
 compatible with the desired type
-, FALSE if they are not

+, FALSE if they are not

nm_utils_ap_mode_security_valid ()

-
gboolean
+
gboolean
 nm_utils_ap_mode_security_valid (NMUtilsSecurityType type,
                                  NMDeviceWifiCapabilities wifi_caps);

 
Given a set of device capabilities, and a desired security type to check
@@ -888,15 +908,15 @@ e.g. 
 

 
Returns

-
 TRUE if the device capabilities are compatible with the desired
+
 TRUE if the device capabilities are compatible with the desired
 type
-, FALSE if they are not.

+, FALSE if they are not.

nm_utils_wep_key_valid ()

-
gboolean
+
gboolean
 nm_utils_wep_key_valid (const char *key,
                         NMWepKeyType wep_type);

 
Checks if key
@@ -925,14 +945,14 @@ nm_utils_wep_key_valid (const cha

Returns

-

TRUE if key -is a WEP key, FALSE if not

+

TRUE if key +is a WEP key, FALSE if not

nm_utils_wpa_psk_valid ()

-
gboolean
+
gboolean
 nm_utils_wpa_psk_valid (const char *psk);

 
Checks if psk
  is a valid WPA PSK

@@ -953,16 +973,16 @@ nm_utils_wpa_psk_valid (const cha

Returns

-

TRUE if psk -is a WPA PSK, FALSE if not

+

TRUE if psk +is a WPA PSK, FALSE if not

nm_utils_is_json_object ()

-
gboolean
+
gboolean
 nm_utils_is_json_object (const char *str,
-                         GError **error);

+                         GError **error);

Parameters

@@ -989,7 +1009,7 @@ nm_utils_is_json_object (const ch

Returns

whether the passed string is valid JSON. If libnm is not compiled with libjansson support, this check will -also return TRUE for possibly invalid inputs. If that is a problem +also return TRUE for possibly invalid inputs. If that is a problem for you, you must validate the JSON yourself.

Since: 1.6

@@ -997,9 +1017,9 @@ for you, you must validate the JSON yourself.

nm_utils_ip4_dns_to_variant ()

-
GVariant *
+
GVariant *
 nm_utils_ip4_dns_to_variant (char **dns);

-
Utility function to convert an array of IP address strings int a GVariant of
+
Utility function to convert an array of IP address strings int a GVariant of
 type 'au' representing an array of IPv4 addresses.

 

 
Parameters

@@ -1018,7 +1038,7 @@ type 'au' representing an array of IPv4 addresses.

 

 

 
Returns

-
 a new floating GVariant representing dns
+
 a new floating GVariant representing dns
 . 

 
[transfer none]

 

@@ -1027,8 +1047,8 @@ type 'au' representing an array of IPv4 addresses.

 

 
nm_utils_ip4_dns_from_variant ()

 
char **
-nm_utils_ip4_dns_from_variant (GVariant *value);

-
Utility function to convert a GVariant of type 'au' representing a list of
+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.

Parameters

@@ -1040,29 +1060,29 @@ IPv4 addresses into an array of IP address strings.

 - +

value

a GVariant of type 'au'

a GVariant of type 'au'

  

Returns

-

a NULL-terminated array of IP address strings.

+

a NULL-terminated array of IP address strings.

[transfer full][type utf8]

nm_utils_ip4_addresses_to_variant ()

-
GVariant *
-nm_utils_ip4_addresses_to_variant (GPtrArray *addresses,
+
GVariant *
+nm_utils_ip4_addresses_to_variant (GPtrArray *addresses,
                                    const char *gateway);

-
Utility function to convert a GPtrArray of NMIPAddress objects representing
-IPv4 addresses into a GVariant of type 'aau' representing an array of
+
Utility function to convert a GPtrArray of NMIPAddress objects representing
+IPv4 addresses into a GVariant of type 'aau' representing an array of
 NetworkManager IPv4 addresses (which are tuples of address, prefix, and
 gateway). The "gateway" field of the first address will get the value of
 gateway
- (if non-NULL). In all of the other addresses, that field will be 0.

+ (if non-NULL). In all of the other addresses, that field will be 0.

 

 
Parameters

 

@@ -1087,7 +1107,7 @@ gateway). The "gateway" field of the first address will get the value of
 

 
Returns

-
 a new floating GVariant representing addresses
+
 a new floating GVariant representing addresses
 . 

 
[transfer none]

 

@@ -1095,12 +1115,12 @@ gateway). The "gateway" field of the first address will get the value of
 

 
nm_utils_ip4_addresses_from_variant ()

-
GPtrArray *
-nm_utils_ip4_addresses_from_variant (GVariant *value,
+
GPtrArray *
+nm_utils_ip4_addresses_from_variant (GVariant *value,
                                      char **out_gateway);

-
Utility function to convert a GVariant of type 'aau' representing a list of
+
Utility function to convert a GVariant of type 'aau' representing a list of
 NetworkManager IPv4 addresses (which are tuples of address, prefix, and
-gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field of
+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.

@@ -1115,7 +1135,7 @@ of the other addresses are ignored.

 

-
+
@@ -1129,17 +1149,17 @@ of the other addresses are ignored.

 
Returns

 
 a newly allocated
-GPtrArray of NMIPAddress objects. 

+GPtrArray of NMIPAddress objects. 

 
[transfer full][element-type NMIPAddress]

 

 
nm_utils_ip4_routes_to_variant ()

-
GVariant *
-nm_utils_ip4_routes_to_variant (GPtrArray *routes);

-
Utility function to convert a GPtrArray of NMIPRoute objects representing
-IPv4 routes into a GVariant of type 'aau' representing an array of
+
GVariant *
+nm_utils_ip4_routes_to_variant (GPtrArray *routes);

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

 

@@ -1159,7 +1179,7 @@ metric).

 

 

 
Returns

-
 a new floating GVariant representing routes
+
 a new floating GVariant representing routes
 . 

 
[transfer none]

 

@@ -1167,11 +1187,11 @@ metric).

 

 

 
nm_utils_ip4_routes_from_variant ()

-
GPtrArray *
-nm_utils_ip4_routes_from_variant (GVariant *value);

-
Utility function to convert a GVariant of type 'aau' representing an array
+
GPtrArray *
+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.

 

 
Parameters

 

 
 
 

 
value
a GVariant of type 'aau'
a GVariant of type 'aau'

  
 

 

 
 
 
 

@@ -1182,7 +1202,7 @@ and metric) into a 
value

-
+
GVariant of type 'aau'
GVariant of type 'aau'

  
 

 

@@ -1190,15 +1210,15 @@ and metric) into a 
 
Returns

 
 a newly allocated
-GPtrArray of NMIPRoute objects. 

+GPtrArray of NMIPRoute objects. 

 
[transfer full][element-type NMIPRoute]

nm_utils_ip4_netmask_to_prefix ()

-
guint32
-nm_utils_ip4_netmask_to_prefix (guint32 netmask);
+
guint32
+nm_utils_ip4_netmask_to_prefix (guint32 netmask);

Parameters

@@ -1222,8 +1242,8 @@ nm_utils_ip4_netmask_to_prefix (

nm_utils_ip4_prefix_to_netmask ()

-
guint32
-nm_utils_ip4_prefix_to_netmask (guint32 prefix);
+
guint32
+nm_utils_ip4_prefix_to_netmask (guint32 prefix);

Parameters

@@ -1247,8 +1267,8 @@ nm_utils_ip4_prefix_to_netmask (

nm_utils_ip4_get_default_prefix ()

-
guint32
-nm_utils_ip4_get_default_prefix (guint32 ip);
+
guint32
+nm_utils_ip4_get_default_prefix (guint32 ip);

When the Internet was originally set up, various ranges of IP addresses were segmented into three network classes: A, B, and C. This function will return a prefix that is associated with the IP address specified defining where it @@ -1276,9 +1296,9 @@ falls in the predefined classes.

nm_utils_ip6_dns_to_variant ()

-
GVariant *
+
GVariant *
 nm_utils_ip6_dns_to_variant (char **dns);

-
Utility function to convert an array of IP address strings int a GVariant of
+
Utility function to convert an array of IP address strings int a GVariant of
 type 'aay' representing an array of IPv6 addresses.

 

 
Parameters

@@ -1297,7 +1317,7 @@ type 'aay' representing an array of IPv6 addresses.

 

 

 
Returns

-
 a new floating GVariant representing dns
+
 a new floating GVariant representing dns
 . 

 
[transfer none]

 

@@ -1306,8 +1326,8 @@ type 'aay' representing an array of IPv6 addresses.

 

 
nm_utils_ip6_dns_from_variant ()

 
char **
-nm_utils_ip6_dns_from_variant (GVariant *value);

-
Utility function to convert a GVariant of type 'aay' representing a list of
+nm_utils_ip6_dns_from_variant (GVariant *value);
+

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

Parameters

@@ -1319,29 +1339,29 @@ IPv6 addresses into an array of IP address strings.

 - +

value

a GVariant of type 'aay'

a GVariant of type 'aay'

  

Returns

-

a NULL-terminated array of IP address strings.

+

a NULL-terminated array of IP address strings.

[transfer full][type utf8]

nm_utils_ip6_addresses_to_variant ()

-
GVariant *
-nm_utils_ip6_addresses_to_variant (GPtrArray *addresses,
+
GVariant *
+nm_utils_ip6_addresses_to_variant (GPtrArray *addresses,
                                    const char *gateway);

-
Utility function to convert a GPtrArray of NMIPAddress objects representing
-IPv6 addresses into a GVariant of type 'a(ayuay)' representing an array of
+
Utility function to convert a GPtrArray of NMIPAddress objects representing
+IPv6 addresses into a GVariant of type 'a(ayuay)' representing an array of
 NetworkManager IPv6 addresses (which are tuples of address, prefix, and
 gateway).  The "gateway" field of the first address will get the value of
 gateway
- (if non-NULL). In all of the other addresses, that field will be
+ (if non-NULL). In all of the other addresses, that field will be
 all 0s.

 

 
Parameters

@@ -1367,7 +1387,7 @@ all 0s.

 

 

 
Returns

-
 a new floating GVariant representing addresses
+
 a new floating GVariant representing addresses
 . 

 
[transfer none]

 

@@ -1375,12 +1395,12 @@ all 0s.

 

 

 
nm_utils_ip6_addresses_from_variant ()

-
GPtrArray *
-nm_utils_ip6_addresses_from_variant (GVariant *value,
+
GPtrArray *
+nm_utils_ip6_addresses_from_variant (GVariant *value,
                                      char **out_gateway);

-
Utility function to convert a GVariant of type 'a(ayuay)' representing a
+
Utility function to convert a GVariant of type 'a(ayuay)' representing a
 list of NetworkManager IPv6 addresses (which are tuples of address, prefix,
-and gateway) into a GPtrArray of NMIPAddress objects. The "gateway" field
+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.

@@ -1395,7 +1415,7 @@ fields of the other addresses are ignored.

 
 
 
value

-
a GVariant of type 'a(ayuay)'

+
a GVariant of type 'a(ayuay)'

  
 
 
@@ -1409,17 +1429,17 @@ fields of the other addresses are ignored.

 

 
Returns

 
 a newly allocated
-GPtrArray of NMIPAddress objects. 

+GPtrArray of NMIPAddress objects. 

 
[transfer full][element-type NMIPAddress]

 

 

 

 

 
nm_utils_ip6_routes_to_variant ()

-
GVariant *
-nm_utils_ip6_routes_to_variant (GPtrArray *routes);

-
Utility function to convert a GPtrArray of NMIPRoute objects representing
-IPv6 routes into a GVariant of type 'a(ayuayu)' representing an array of
+
GVariant *
+nm_utils_ip6_routes_to_variant (GPtrArray *routes);

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

 

@@ -1439,7 +1459,7 @@ metric).

 

 

 
Returns

-
 a new floating GVariant representing routes
+
 a new floating GVariant representing routes
 . 

 
[transfer none]

 

@@ -1447,11 +1467,11 @@ metric).

 

 

 
nm_utils_ip6_routes_from_variant ()

-
GPtrArray *
-nm_utils_ip6_routes_from_variant (GVariant *value);

-
Utility function to convert a GVariant of type 'a(ayuayu)' representing an
+
GPtrArray *
+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.

 

 
Parameters

 

@@ -1462,7 +1482,7 @@ hop, and metric) into a 
value

-
+
GVariant of type 'a(ayuayu)'
GVariant of type 'a(ayuayu)'

  
 

 

@@ -1470,17 +1490,17 @@ hop, and metric) into a 
 
Returns

 
 a newly allocated
-GPtrArray of NMIPRoute objects. 

+GPtrArray of NMIPRoute objects. 

 
[transfer full][element-type NMIPRoute]

 

 

 

 

 
nm_utils_ip_addresses_to_variant ()

-
GVariant *
-nm_utils_ip_addresses_to_variant (GPtrArray *addresses);

-
Utility function to convert a GPtrArray of NMIPAddress objects representing
-IPv4 or IPv6 addresses into a GVariant of type 'aa{sv}' representing an
+
GVariant *
+nm_utils_ip_addresses_to_variant (GPtrArray *addresses);

+
Utility function to convert a GPtrArray of NMIPAddress objects representing
+IPv4 or IPv6 addresses into a GVariant of type 'aa{sv}' representing an
 array of new-style NetworkManager IP addresses. All addresses will include
 "address" (an IP address string), and "prefix" (a uint). Some addresses may
 include additional attributes.

@@ -1501,7 +1521,7 @@ include additional attributes.

 

 

 
Returns

-
 a new floating GVariant representing addresses
+
 a new floating GVariant representing addresses
 . 

 
[transfer none]

 

@@ -1509,12 +1529,12 @@ include additional attributes.

 

 

 
nm_utils_ip_addresses_from_variant ()

-
GPtrArray *
-nm_utils_ip_addresses_from_variant (GVariant *value,
+
GPtrArray *
+nm_utils_ip_addresses_from_variant (GVariant *value,
                                     int family);

-
Utility function to convert a GVariant representing a list of new-style
+
Utility function to convert a 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
+nm_utils_ip_addresses_to_variant()) into a GPtrArray of NMIPAddress
 objects.

 

 
Parameters

@@ -1527,7 +1547,7 @@ objects.

 
 
 
value

-
a GVariant of type 'aa{sv}'

+
a GVariant of type 'aa{sv}'

  
 
 
@@ -1541,17 +1561,17 @@ objects.

 

 
Returns

 
 a newly allocated
-GPtrArray of NMIPAddress objects. 

+GPtrArray of NMIPAddress objects. 

 
[transfer full][element-type NMIPAddress]

 

 

 

 

 
nm_utils_ip_routes_to_variant ()

-
GVariant *
-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
+
GVariant *
+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).

 

@@ -1571,7 +1591,7 @@ prefix, next hop, metric, and additional attributes).

 

 

 
Returns

-
 a new floating GVariant representing routes
+
 a new floating GVariant representing routes
 . 

 
[transfer none]

 

@@ -1579,12 +1599,12 @@ prefix, next hop, metric, and additional attributes).

 

 

 
nm_utils_ip_routes_from_variant ()

-
GPtrArray *
-nm_utils_ip_routes_from_variant (GVariant *value,
+
GPtrArray *
+nm_utils_ip_routes_from_variant (GVariant *value,
                                  int family);

-
Utility function to convert a GVariant representing a list of new-style
+
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
+prefix, next hop, metric, and additional attributes) into a GPtrArray of
 NMIPRoute objects.

 

 
Parameters

@@ -1597,7 +1617,7 @@ prefix, next hop, metric, and additional attributes) into a 
value

-
a GVariant of type 'aa{sv}'

+
a GVariant of type 'aa{sv}'

  
 
 
@@ -1611,7 +1631,7 @@ prefix, next hop, metric, and additional attributes) into a 
 
Returns

 
 a newly allocated
-GPtrArray of NMIPRoute objects. 

+GPtrArray of NMIPRoute objects. 

 
[transfer full][element-type NMIPRoute]

 

 

@@ -1623,13 +1643,13 @@ nm_utils_uuid_generate (void
 
Returns

 
 a newly allocated UUID suitable for use as the NMSettingConnection
-object's “id”: property.  Should be freed with g_free()

+object's “id”: property.  Should be freed with g_free()

 

 

 

 

 
nm_utils_file_is_certificate ()

-
gboolean
+
gboolean
 nm_utils_file_is_certificate (const char *filename);

 
Tests if filename
  has a valid extension for an X.509 certificate file
@@ -1652,15 +1672,15 @@ recognized by NetworkManager.

 

 

 
Returns

-
 TRUE if the file is a certificate, FALSE if it is not

+
 TRUE if the file is a certificate, FALSE if it is not

 

 

 

 

 
nm_utils_file_is_private_key ()

-
gboolean
+
gboolean
 nm_utils_file_is_private_key (const char *filename,
-                              gboolean *out_encrypted);

+                              gboolean *out_encrypted);

 
Tests if filename
  has a valid extension for an X.509 private key file
 (".der", ".key", ".pem", or ".p12"), and contains a private key in a format
@@ -1689,13 +1709,13 @@ recognized by NetworkManager.

 

 

 
Returns

-
 TRUE if the file is a private key, FALSE if it is not

+
 TRUE if the file is a private key, FALSE if it is not

nm_utils_file_is_pkcs12 ()

-
gboolean
+
gboolean
 nm_utils_file_is_pkcs12 (const char *filename);

 
Tests if filename
  is a PKCS#12 file.

@@ -1716,24 +1736,24 @@ nm_utils_file_is_pkcs12 (const ch

Returns

-

TRUE if the file is PKCS#12, FALSE if it is not

+

TRUE if the file is PKCS#12, FALSE if it is not

NMUtilsFileSearchInPathsPredicate ()

-
gboolean
+
gboolean
 (*NMUtilsFileSearchInPathsPredicate) (const char *filename,
-                                      gpointer user_data);

+                                      gpointer user_data);

NMUtilsCheckFilePredicate ()

-
gboolean
+
gboolean
 (*NMUtilsCheckFilePredicate) (const char *filename,
                               const struct stat *stat,
-                              gpointer user_data,
-                              GError **error);

+                              gpointer user_data,
+                              GError **error);
@@ -1742,10 +1762,10 @@ nm_utils_file_is_pkcs12 (const ch nm_utils_file_search_in_paths (const char *progname, const char *try_first, const char *const *paths, - GFileTest file_test_flags, + GFileTest file_test_flags, NMUtilsFileSearchInPathsPredicate predicate, - gpointer user_data, - GError **error); + gpointer user_data, + GError **error);

Searches for a progname file in a list of search paths .

@@ -1772,16 +1792,16 @@ It is silently ignored if it is empty or not an absolute path.

paths

-

a NULL terminated list of search paths. -Can be empty or NULL, in which case only try_first +

a NULL terminated list of search paths. +Can be empty or NULL, in which case only try_first is checked.

[allow-none]

file_test_flags

-

the flags passed to g_file_test() when searching +

the flags passed to g_file_test() when searching for progname -. Set it to 0 to skip the g_file_test().

+. Set it to 0 to skip the g_file_test().

  @@ -1802,7 +1822,7 @@ function.

error

-

on failure, set a "not found" error G_IO_ERROR G_IO_ERROR_NOT_FOUND.

+

on failure, set a "not found" error G_IO_ERROR G_IO_ERROR_NOT_FOUND.

[allow-none] @@ -1810,7 +1830,7 @@ function.

Returns

-

the full path to the helper, if found, or NULL if not found. +

the full path to the helper, if found, or NULL if not found. The returned string is not owned by the caller, but later invocations of the function might overwrite it.

[transfer none]

@@ -1819,8 +1839,8 @@ invocations of the function might overwrite it.

nm_utils_wifi_freq_to_channel ()

-
guint32
-nm_utils_wifi_freq_to_channel (guint32 freq);
+
guint32
+nm_utils_wifi_freq_to_channel (guint32 freq);

Utility function to translate a Wi-Fi frequency to its corresponding channel.

Parameters

@@ -1845,8 +1865,8 @@ nm_utils_wifi_freq_to_channel (

nm_utils_wifi_channel_to_freq ()

-
guint32
-nm_utils_wifi_channel_to_freq (guint32 channel,
+
guint32
+nm_utils_wifi_channel_to_freq (guint32 channel,
                                const char *band);

 
Utility function to translate a Wi-Fi channel to its corresponding frequency.

 

@@ -1881,8 +1901,8 @@ is invalid

 

 

 
nm_utils_wifi_find_next_channel ()

-
guint32
-nm_utils_wifi_find_next_channel (guint32 channel,
+
guint32
+nm_utils_wifi_find_next_channel (guint32 channel,
                                  int direction,
                                  char *band);

 
Utility function to find out next/previous Wi-Fi channel for a channel.

@@ -1921,8 +1941,8 @@ nm_utils_wifi_find_next_channel (
 
nm_utils_wifi_is_channel_valid ()

-
gboolean
-nm_utils_wifi_is_channel_valid (guint32 channel,
+
gboolean
+nm_utils_wifi_is_channel_valid (guint32 channel,
                                 const char *band);

 
Utility function to verify Wi-Fi channel validity.

 

@@ -1949,13 +1969,13 @@ nm_utils_wifi_is_channel_valid (
 
Returns

-
 TRUE or FALSE

+
 TRUE or FALSE

 

 

 

 

 
nm_utils_wifi_2ghz_freqs ()

-
const guint *
+
const guint *
 nm_utils_wifi_2ghz_freqs (void);

 
Utility function to return 2.4 GHz Wi-Fi frequencies (802.11bg band).

 

@@ -1967,7 +1987,7 @@ nm_utils_wifi_2ghz_freqs (void
 

 
nm_utils_wifi_5ghz_freqs ()

-
const guint *
+
const guint *
 nm_utils_wifi_5ghz_freqs (void);

 
Utility function to return 5 GHz Wi-Fi frequencies (802.11a band).

 

@@ -1980,7 +2000,7 @@ nm_utils_wifi_5ghz_freqs (void
 
nm_utils_wifi_strength_bars ()

 
const char *
-nm_utils_wifi_strength_bars (guint8 strength);

+nm_utils_wifi_strength_bars (guint8 strength);

 
Converts strength
  into a 4-character-wide graphical representation of
 strength suitable for printing to stdout. If the current locale and terminal
@@ -2009,7 +2029,7 @@ support it, this will use unicode graphics characters to represent
 

 

 
nm_utils_hwaddr_len ()

-
gsize
+
gsize
 nm_utils_hwaddr_len (int type);

 
Returns the length in octets of a hardware address of type type
 .

@@ -2040,8 +2060,8 @@ nm_utils_hwaddr_len (int t
 

 
nm_utils_hwaddr_ntoa ()

 
char *
-nm_utils_hwaddr_ntoa (gconstpointer addr,
-                      gsize length);

+nm_utils_hwaddr_ntoa (gconstpointer addr,
+                      gsize length);

 
Converts addr
  to textual form.

 

@@ -2077,12 +2097,12 @@ nm_utils_hwaddr_ntoa (
 
nm_utils_hwaddr_atoba ()

-
GByteArray *
+
GByteArray *
 nm_utils_hwaddr_atoba (const char *asc,
-                       gsize length);

+                       gsize length);

 
Parses asc
- and converts it to binary form in a GByteArray. See
-nm_utils_hwaddr_aton() if you don't want a GByteArray.

+ and converts it to binary form in a GByteArray. See
+nm_utils_hwaddr_aton() if you don't want a GByteArray.

 

 
Parameters

 

@@ -2107,7 +2127,7 @@ nm_utils_hwaddr_atoba (const char
 
 

 
Returns

-
 a new GByteArray, or NULL if asc
+
 a new GByteArray, or NULL if asc
 couldn't
 be parsed. 

 
[transfer full]

@@ -2116,10 +2136,10 @@ be parsed. 

 

 

 
nm_utils_hwaddr_aton ()

-
guint8 *
+
guint8 *
 nm_utils_hwaddr_aton (const char *asc,
-                      gpointer buffer,
-                      gsize length);

+                      gpointer buffer,
+                      gsize length);

 
Parses asc
  and converts it to binary form in buffer
 .
@@ -2156,7 +2176,7 @@ the size of the buffer in bytes.

 

 
Returns

 
 buffer
-, or NULL if asc
+, or NULL if asc
 couldn't be parsed
 or would be shorter or longer than length
 .

@@ -2165,9 +2185,9 @@ or would be shorter or longer than length
 

 
nm_utils_hwaddr_valid ()

-
gboolean
+
gboolean
 nm_utils_hwaddr_valid (const char *asc,
-                       gssize length);

+                       gssize length);

 
Parses asc
  to see if it is a valid hardware address of the given
 length.

@@ -2197,9 +2217,9 @@ is expected to convert to
 

 

 
Returns

-
 TRUE if asc
+
 TRUE if asc
 appears to be a valid hardware address
-of the indicated length, FALSE if not.

+of the indicated length, FALSE if not.

 

 

 

@@ -2207,7 +2227,7 @@ of the indicated length, 
nm_utils_hwaddr_canonical ()

 
char *
 nm_utils_hwaddr_canonical (const char *asc,
-                           gssize length);

+                           gssize length);
 
Parses asc
  to see if it is a valid hardware address of the given
 length, and if so, returns it in canonical form (uppercase, with
@@ -2240,18 +2260,18 @@ is expected to convert to
 
Returns

 
 the canonicalized address if asc
 appears to
-be a valid hardware address of the indicated length, NULL if not. 

+be a valid hardware address of the indicated length, NULL if not. 

 
[transfer full]

 

 

 

 

 
nm_utils_hwaddr_matches ()

-
gboolean
-nm_utils_hwaddr_matches (gconstpointer hwaddr1,
-                         gssize hwaddr1_len,
-                         gconstpointer hwaddr2,
-                         gssize hwaddr2_len);

+
gboolean
+nm_utils_hwaddr_matches (gconstpointer hwaddr1,
+                         gssize hwaddr1_len,
+                         gconstpointer hwaddr2,
+                         gssize hwaddr2_len);

 
Generalized hardware address comparison function. Tests if hwaddr1
  and
 hwaddr2
@@ -2265,7 +2285,7 @@ over a simple memcmp():

  before being compared.

 
  • If hwaddr1
  or hwaddr2
- is NULL, it is treated instead as though it was
+ is NULL, it is treated instead as though it was
  a zero-filled buffer hwaddr1_len
  or hwaddr2_len
  bytes long.
    • 
@@ -2294,7 +2314,7 @@ guaranteed to not match if they are invalid.)
    
 
    
-
+
@@ -2306,7 +2326,7 @@ is ASCII
    
     
-
+
@@ -2321,9 +2341,9 @@ is ASCII
    
 
 
    
 
    Returns
    
-
     TRUE if hwaddr1
+
     TRUE if hwaddr1
 and hwaddr2
-are equivalent, FALSE if they are
+are equivalent, FALSE if they are
 different (or either of them is invalid).
    
 
    
 
@@ -2331,8 +2351,8 @@ different (or either of them is invalid).
    
 
    
 
    nm_utils_bin2hexstr ()
    
 
    char *
-nm_utils_bin2hexstr (gconstpointer src,
-                     gsize len,
+nm_utils_bin2hexstr (gconstpointer src,
+                     gsize len,
                      int final_len);
    
 
    Converts the byte array src
  into a hexadecimal string. If final_len
@@ -2377,7 +2397,7 @@ array
    
 
    
 
    
 
    nm_utils_hexstr2bin ()
    
-
    GBytes *
+
    GBytes *
 nm_utils_hexstr2bin (const char *hex);
    
 
    Converts a hexadecimal string hex
  into an array of bytes.  The optional
@@ -2403,18 +2423,18 @@ may not start or end with ':'.
    
 
    
 
    
 
    Returns
    
-
     the converted bytes, or NULL on error. 
    
+
     the converted bytes, or NULL on error. 
    
 
    [transfer full]
    
 
    
 
    
 
    
 
    
 
    nm_utils_iface_valid_name ()
    
-
    gboolean
+
    gboolean
 nm_utils_iface_valid_name (const char *name);
    
 
    
 
    nm_utils_iface_valid_name has been deprecated since version 1.6 and should not be used in newly-written code.
    
-
    use nm_utils_is_valid_iface_name() insteead, with better error reporting.
    
+
    use nm_utils_is_valid_iface_name() instead, with better error reporting.
    
 
    
 
    Validate the network interface name.
    
 
    
@@ -2434,15 +2454,15 @@ nm_utils_iface_valid_name (const 
 
    
 
    
 
    Returns
    
-
     TRUE if interface name is valid, otherwise FALSE is returned.
    
+
     TRUE if interface name is valid, otherwise FALSE is returned.
    
 
    
 
    
 
    
 
    
 
    nm_utils_is_valid_iface_name ()
    
-
    gboolean
+
    gboolean
 nm_utils_is_valid_iface_name (const char *name,
-                              GError **error);
    
+                              GError **error);
    
 
    Validate the network interface name.
    
 
    This function is a 1:1 copy of the kernel's interface validation
 function in net/core/dev.c.
    
@@ -2462,7 +2482,7 @@ function in net/core/dev.c.
    
 
    
-
+
@@ -2470,13 +2490,13 @@ function in net/core/dev.c.
    
 
 
    
 
    Returns
    
-
     TRUE if interface name is valid, otherwise FALSE is returned.
    
+
     TRUE if interface name is valid, otherwise FALSE is returned.
    
 
    
 
 
    
 
    
 
    nm_utils_is_uuid ()
    
-
    gboolean
+
    gboolean
 nm_utils_is_uuid (const char *str);
    
 
    Checks if str
  is a UUID
    
@@ -2497,8 +2517,8 @@ nm_utils_is_uuid (const char
 
    
 
    Returns
    
-
     TRUE if str
-is a UUID, FALSE if not
    
+
     TRUE if str
+is a UUID, FALSE if not
    
 
    
 
    
 
    
@@ -2527,7 +2547,7 @@ nm_utils_inet4_ntop (in_addr_t
    dst
    
 
    Returns
    
 
     the input buffer dst
 , or a pointer to an
-internal, static buffer. NULL is not allowed as in6addr
+internal, static buffer. NULL is not allowed as in6addr
 ,
 otherwise, this function cannot fail.
    
 
@@ -2598,7 +2618,7 @@ otherwise, this function cannot fail.
    
 
    
 
    
 
    nm_utils_ipaddr_valid ()
    
-
    gboolean
+
    gboolean
 nm_utils_ipaddr_valid (int family,
                        const char *ip);
    
 
    Checks if ip
@@ -2628,16 +2648,16 @@ nm_utils_ipaddr_valid (int
 
    
 
    
 
    Returns
    
-
     TRUE or FALSE
    
+
     TRUE or FALSE
    
 
    
 
 
    
 
    
 
    nm_utils_check_virtual_device_compatibility ()
    
-
    gboolean
+
    gboolean
 nm_utils_check_virtual_device_compatibility
-                               (GType virtual_type,
-                                GType other_type);
    
+                               (GType virtual_type,
+                                GType other_type);
    
 
    Determines if a connection of type virtual_type
  can (in the
 general case) work with connections of type other_type
@@ -2651,7 +2671,7 @@ general case) work with connections of type other_ty
 then this checks if other_type
  is a valid type for a slave of that
 master.
    
-
    Note that even if this returns TRUE it is not guaranteed that
+
    Note that even if this returns TRUE it is not guaranteed that
 every connection of type other_type
  is
 compatible with virtual_type
@@ -2683,7 +2703,7 @@ underlying device driver.
    
 
    
 
    
 
    Returns
    
-
     TRUE or FALSE
    
+
     TRUE or FALSE
    
 
    
 
 
    
@@ -2750,12 +2770,12 @@ available modes.
    
 
    
 
    nm_utils_enum_to_str ()
    
 
    char *
-nm_utils_enum_to_str (GType type,
+nm_utils_enum_to_str (GType type,
                       int value);
    
 
    Converts an enum value to its string representation. If the enum is a
-G_TYPE_FLAGS the function returns a comma-separated list of matching values.
-If the enum is a G_TYPE_ENUM and the given value is not valid the
-function returns NULL.
    
+G_TYPE_FLAGS the function returns a comma-separated list of matching values.
+If the enum is a G_TYPE_ENUM and the given value is not valid the
+function returns NULL.
    
 
    
 
    Parameters
    
 
    
 
    
 
    hwaddr1
    pointer to a binary or ASCII hardware address, or NULL
    pointer to a binary or ASCII hardware address, or NULL
    		
  
 
    
 
    
 
    
 
    hwaddr2
    pointer to a binary or ASCII hardware address, or NULL
    pointer to a binary or ASCII hardware address, or NULL
    		
  
 
    
 
    
 
    
 
    error
    location to store the error occurring, or NULL to ignore
    location to store the error occurring, or NULL to ignore
    		
  
 
    
 
    the destination buffer, it must contain at least
 INET_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN
-characters. If set to NULL, it will return a pointer to an internal, static
+characters. If set to NULL, it will return a pointer to an internal, static
 buffer (shared with nm_utils_inet6_ntop()).  Beware, that the internal
 buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or
 nm_utils_inet6_ntop() that does not provied it's own dst
@@ -2573,7 +2593,7 @@ nm_utils_inet6_ntop (const struct
 
    dst
    		
 
    the destination buffer, it must contain at least
 INET6_ADDRSTRLEN or NM_UTILS_INET_ADDRSTRLEN
-characters. If set to NULL, it will return a pointer to an internal, static
+characters. If set to NULL, it will return a pointer to an internal, static
 buffer (shared with nm_utils_inet4_ntop()).  Beware, that the internal
 buffer will be overwritten with ever new call of nm_utils_inet4_ntop() or
 nm_utils_inet6_ntop() that does not provied it's own dst
@@ -2590,7 +2610,7 @@ buffer to avoid these issues.
    		
 
    
@@ -2767,7 +2787,7 @@ function returns 
    type
    
-    
+
@@ -2780,22 +2800,22 @@ function returns 
 
    Returns
    
-
     a newly allocated string or NULL
    
+
     a newly allocated string or NULL
    
 
 
    Since: 1.2
    
 
 
    
 
    
 
    nm_utils_enum_from_str ()
    
-
    gboolean
-nm_utils_enum_from_str (GType type,
+
    gboolean
+nm_utils_enum_from_str (GType type,
                         const char *str,
                         int *out_value,
                         char **err_token);
    
 
    Converts a string to the matching enum value.
    
-
    If the enum is a G_TYPE_FLAGS the function returns the logical OR of values
+
    If the enum is a G_TYPE_FLAGS the function returns the logical OR of values
 matching the comma-separated tokens in the string; if an unknown token is found
-the function returns FALSE and stores a pointer to a newly allocated string
+the function returns FALSE and stores a pointer to a newly allocated string
 containing the unrecognized token in err_token
 .
    
 
    
@@ -2809,7 +2829,7 @@ containing the unrecognized token in err_token
 
    
-
+
@@ -2825,14 +2845,14 @@ containing the unrecognized token in err_token
 
-
+
    the GType of the enum
    the GType of the enum
    		
  
 
    
 
    
 
    type
    the GType of the enum
    the GType of the enum
    		
  
 
    
 
    err_token
    		
 
     location to store the first unrecognized token. 
    		[out][allow-none][out][allow-none][transfer full]
 
    
     
 
    
 
    
 
    
 
    Returns
    
-
     TRUE if the conversion was successful, FALSE otherwise
    
+
     TRUE if the conversion was successful, FALSE otherwise
    
 
    
 
    Since: 1.2
    
 
    
@@ -2840,9 +2860,9 @@ containing the unrecognized token in err_token
 
    nm_utils_enum_get_values ()
    
 
    const char **
-nm_utils_enum_get_values (GType type,
-                          gint from,
-                          gint to);
    
+nm_utils_enum_get_values (GType type,
+                          gint from,
+                          gint to);
    
 
    Returns the list of possible values for a given enum.
    
 
    
 
    Parameters
    
@@ -2855,7 +2875,7 @@ nm_utils_enum_get_values (
    type
    
-
    the GType of the enum
    
+
    the GType of the enum
    
  
 
 
@@ -2874,15 +2894,15 @@ nm_utils_enum_get_values (
 
    Returns
    
 
     a NULL-terminated dynamically-allocated array of static strings
-or NULL on error. 
    
-
    [transfer full]
    
+or NULL on error. 
    
+
    [transfer container]
    
 
    
 
    Since: 1.2
    
 
    
 
    
 
    
 
    nm_utils_version ()
    
-
    guint
+
    guint
 nm_utils_version (void);
    
 
    
 
    Returns
    
@@ -2891,6 +2911,74 @@ at runtime.
    
 
    
 
    Since: 1.6.0
    
 
    
+
    
+
    
+
    nm_utils_parse_variant_attributes ()
    
+
    GHashTable *
+nm_utils_parse_variant_attributes (const char *string,
+                                   char attr_separator,
+                                   char key_value_separator,
+                                   gboolean ignore_unknown,
+                                   const NMVariantAttributeSpec *const *spec,
+                                   GError **error);
    
+
    Parse attributes from a string.
    
+
    
+
    Parameters
    
+
    
+++++
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
    




    string
    the input string
    		 
    attr_separator
    the attribute separator character
    		 
    key_value_separator
    character separating key and values
    		 
    ignore_unknown
    whether unknown attributes should be ignored
    		 
    spec
    the attribute format specifiers
    		 
    error
     location to store the error on failure. 
    		[out][allow-none]
    
+
    
+
    
+
    Returns
    
+
     a GHashTable mapping attribute names to GVariant values. 
    
+
    [transfer full]
    
+
    
+
    Since: 1.8
    
+
    
+
    
+
    
+
    nm_utils_format_variant_attributes ()
    
+
    char *
+nm_utils_format_variant_attributes (GHashTable *attributes,
+                                    char attr_separator,
+                                    char key_value_separator);
    
+
    
 
    
 
    
 
    Types and Values
    
@@ -2996,6 +3084,11 @@ for both 
+
    NMVariantAttributeSpec
    
+
    typedef struct _NMVariantAttributeSpec NMVariantAttributeSpec;
    
+
    
+
    
+
    
 
    struct stat
    
 
    struct stat;
    
 
    
-- 
cgit 1.3.0-6-gf8a5