From e152ec7bf4ba252ff9d3eb13eabd417b931dac9a Mon Sep 17 00:00:00 2001
From: Iain Lane
-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,7 +537,7 @@
-guint
+guint
nm_utils_version ()
@@ -545,7 +545,7 @@
-GHashTable *
+GHashTable *
nm_utils_parse_variant_attributes ()
@@ -561,7 +561,7 @@
-NMTCQdisc *
+NMTCQdisc *
nm_utils_tc_qdisc_from_str ()
@@ -577,7 +577,7 @@
-NMTCAction *
+NMTCAction *
nm_utils_tc_action_from_str ()
@@ -593,7 +593,7 @@
+
-NMTCTfilter *
+NMTCTfilter *
nm_utils_tc_tfilter_from_str ()
@@ -607,6 +607,14 @@
nm_utils_tc_tfilter_to_str ()
+
@@ -656,9 +664,9 @@ access points and devices, among other things.
+gint64
+
+
+nm_utils_get_timestamp_msec ()
+
+
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.
@@ -687,15 +695,15 @@ number of known SSID-cloaking methods.const char * -nm_utils_escape_ssid (+nm_utils_escape_ssid (const guint8 *ssid, -gsize len);
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 @@ -732,12 +740,12 @@ and will be overwritten by subsequent calls to this function
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) @@ -777,7 +785,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
char * -nm_utils_ssid_to_utf8 (+nm_utils_ssid_to_utf8 (const guint8 *ssid, -gsize len);
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 @@ -839,19 +847,19 @@ _only_.
gboolean +gboolean nm_utils_security_valid (@@ -916,15 +924,15 @@ e.g. (NMUtilsSecurityType type,NMDeviceWifiCapabilities wifi_caps, -gboolean have_ap, -gboolean adhoc, +gboolean have_ap, +gboolean adhoc,NM80211ApFlags ap_flags,NM80211ApSecurityFlags ap_wpa,NM80211ApSecurityFlags ap_rsn);Returns
-
TRUEif the device capabilities and AP capabilties intersect and are ++,
TRUEif the device capabilities and AP capabilties intersect and are compatible with the desiredtype-,FALSEif they are notFALSEif they are not
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 @@ -956,15 +964,15 @@ e.g.
gboolean +gboolean nm_utils_wep_key_valid (const char *key,NMWepKeyType wep_type);Checks if
key@@ -993,14 +1001,14 @@ nm_utils_wep_key_valid (const cha
gboolean +gboolean nm_utils_wpa_psk_valid (const char *psk);Checks if
@@ -1021,16 +1029,16 @@ nm_utils_wpa_psk_valid (pskis a valid WPA PSKconst cha
gboolean +gboolean nm_utils_is_json_object (+const char *str, -GError **error);GError **error);
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
+ (if non-gateway- (if non-NULL). In all of the other addresses, that field will be 0.NULL). In all of the other addresses, that field will be 0.Parameters
@@ -1155,7 +1163,7 @@ gateway). The "gateway" field of the first address will get the value of
@@ -1163,12 +1171,12 @@ gateway). The "gateway" field of the first address will get the value ofReturns
-a new floating GVariant representing
addresses+a new floating GVariant representing
addresses.[transfer none]
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
@@ -1183,7 +1191,7 @@ of the other addresses are ignored.out_gateway; the "gateway" fields of the other addresses are ignored.- value
+ a GVariant of type 'aau'
a GVariant of type 'aau'
@@ -1197,17 +1205,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).
@@ -1227,7 +1235,7 @@ metric).@@ -1235,11 +1243,11 @@ metric).Returns
-a new floating GVariant representing
routes+a new floating GVariant representing
routes.[transfer none]
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.
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
@@ -1290,8 +1298,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
@@ -1315,8 +1323,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 @@ -1344,9 +1352,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.
@@ -1374,8 +1382,8 @@ type 'aay' representing an array of IPv6 addresses.Returns
-a new floating GVariant representing
dns+a new floating GVariant representing
dns.[transfer none]
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.
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.@@ -1443,12 +1451,12 @@ all 0s.Returns
-a new floating GVariant representing
addresses+a new floating GVariant representing
addresses.[transfer none]
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
@@ -1463,7 +1471,7 @@ fields of the other addresses are ignored.out_gateway; the "gateway" fields of the other addresses are ignored.- value
+ a GVariant of type 'a(ayuay)'
a GVariant of type 'a(ayuay)'
@@ -1477,17 +1485,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).
@@ -1507,7 +1515,7 @@ metric).@@ -1515,11 +1523,11 @@ metric).Returns
-a new floating GVariant representing
routes+a new floating GVariant representing
routes.[transfer none]
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
@@ -1538,17 +1546,17 @@ hop, and metric) into a@@ -1530,7 +1538,7 @@ hop, and metric) into a
- value
+ GVariant of type 'a(ayuayu)'
GVariant of type 'a(ayuayu)'
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.
@@ -1569,7 +1577,7 @@ include additional attributes.@@ -1577,12 +1585,12 @@ include additional attributes.Returns
-a new floating GVariant representing
addresses+a new floating GVariant representing
addresses.[transfer none]
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
@@ -1595,7 +1603,7 @@ objects.- value
+ a GVariant of type 'aa{sv}'
a GVariant of type 'aa{sv}'
@@ -1609,17 +1617,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).
@@ -1639,7 +1647,7 @@ prefix, next hop, metric, and additional attributes).@@ -1647,12 +1655,12 @@ prefix, next hop, metric, and additional attributes).Returns
-a new floating GVariant representing
routes+a new floating GVariant representing
routes.[transfer none]
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.
@@ -1679,7 +1687,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]
@@ -1691,13 +1699,13 @@ nm_utils_uuid_generate (voidReturns
a newly allocated UUID suitable for use as the NMSettingConnection -object's “id”: property. Should be freed with
+object's “id”: property. Should be freed withg_free()g_free()
nm_utils_file_is_certificate ()
-gboolean +gboolean nm_utils_file_is_certificate (const char *filename);Tests if
filenamehas a valid extension for an X.509 certificate file @@ -1720,15 +1728,15 @@ recognized by NetworkManager.
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
filenamehas a valid extension for an X.509 private key file (".der", ".key", ".pem", or ".p12"), and contains a private key in a format @@ -1757,13 +1765,13 @@ recognized by NetworkManager.
nm_utils_file_is_pkcs12 ()
-gboolean +gboolean nm_utils_file_is_pkcs12 (const char *filename);Tests if
@@ -1784,24 +1792,24 @@ nm_utils_file_is_pkcs12 (filenameis a PKCS#12 file.const ch
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);
@@ -1810,10 +1818,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
@@ -1840,16 +1848,16 @@ It is silently ignored if it is empty or not an absolute path.prognamefile in a list of searchpaths.- paths
a
NULLterminated list of search paths. -Can be empty orNULL, in which case onlytry_first+a
NULLterminated list of search paths. +Can be empty orNULL, in which case onlytry_firstis checked.[allow-none] - file_test_flags
the flags passed to
g_file_test()when searching ++. Set it to 0 to skip the the flags passed to
g_file_test()when searching forprogname-. Set it to 0 to skip theg_file_test().g_file_test().@@ -1870,7 +1878,7 @@ function. @@ -1878,7 +1886,7 @@ function. - error
+ on failure, set a "not found" error
G_IO_ERRORG_IO_ERROR_NOT_FOUND.on failure, set a "not found" error
G_IO_ERRORG_IO_ERROR_NOT_FOUND.[allow-none] Returns
-the full path to the helper, if found, or
NULLif not found. +the full path to the helper, if found, or
NULLif not found. The returned string is not owned by the caller, but later invocations of the function might overwrite it.[transfer none]
@@ -1887,8 +1895,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
@@ -1913,8 +1921,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.
@@ -1949,8 +1957,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.
@@ -1989,8 +1997,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.
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).
@@ -2035,7 +2043,7 @@ nm_utils_wifi_2ghz_freqs (voidnm_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).
@@ -2048,12 +2056,14 @@ nm_utils_wifi_5ghz_freqs (voidnm_utils_wifi_strength_bars ()
const char * -nm_utils_wifi_strength_bars (+nm_utils_wifi_strength_bars (guint8 strength);guint8 strength);Converts
+strength suitable for printing to stdout. +strengthinto a 4-character-wide graphical representation of -strength suitable for printing to stdout. If the current locale and terminal -support it, this will use unicode graphics characters to represent -"bars". Otherwise it will use 0 to 4 asterisks.Previous versions used to take a guess at the terminal type and possibly +return a wide UTF-8 encoded string. Now it always returns a 7-bit +clean strings of one to 0 to 4 asterisks. Users that actually need +the functionality are encouraged to make their implementations instead.
Parameters
@@ -2077,7 +2087,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
@@ -2108,8 +2118,8 @@ nm_utils_hwaddr_len (type.int tnm_utils_hwaddr_ntoa ()
char * -nm_utils_hwaddr_ntoa (+nm_utils_hwaddr_ntoa (gconstpointer addr, -gsize length);gconstpointer addr, +gsize length);Converts
addrto textual form.@@ -2145,12 +2155,12 @@ nm_utils_hwaddr_ntoa (nm_utils_hwaddr_atoba ()
-GByteArray * +GByteArray * nm_utils_hwaddr_atoba (+const char *asc, -gsize length);gsize length);Parses
+ and converts it to binary form in a GByteArray. See +asc- and converts it to binary form in a GByteArray. See -nm_utils_hwaddr_aton()if you don't want a GByteArray.nm_utils_hwaddr_aton()if you don't want a GByteArray.Parameters
@@ -2175,7 +2185,7 @@ nm_utils_hwaddr_atoba (
const charReturns
-a new GByteArray, or
NULLifasc+a new GByteArray, or
NULLifasccouldn't be parsed.[transfer full]
@@ -2184,10 +2194,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
ascand converts it to binary form inbuffer. @@ -2209,8 +2219,8 @@ Bytes inasc- buffer
- buffer to store the result into
+ + buffer to store the result into.
[type guint8][array length=length] @@ -2224,7 +2234,7 @@ the size of the buffer in bytes. length
Returns
@@ -2233,9 +2243,9 @@ or would be shorter or longer than
buffer-, orNULLifasc+, orNULLifasccouldn't be parsed or would be shorter or longer thanlength.length
@@ -2275,7 +2285,7 @@ of the indicated length,nm_utils_hwaddr_canonical ()
char * nm_utils_hwaddr_canonical (+const char *asc, -gssize length);gssize length);Parses
ascto see if it is a valid hardware address of the given length, and if so, returns it in canonical form (uppercase, with @@ -2308,18 +2318,18 @@ is expected to convert toReturns
the canonicalized address if
+be a valid hardware address of the indicated length,ascappears to -be a valid hardware address of the indicated length,NULLif not.NULLif 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
before being compared.hwaddr1andhwaddr2@@ -2333,7 +2343,7 @@ over a simplememcmp():@@ -2362,8 +2372,8 @@ guaranteed to not match if they are invalid.) If
hwaddr1orhwaddr2- isNULL, it is treated instead as though it was + isNULL, it is treated instead as though it was a zero-filled bufferhwaddr1_lenorhwaddr2_lenbytes long.- hwaddr1
- pointer to a binary or ASCII hardware address, or
NULL+ + pointer to a binary or ASCII hardware address, or
NULL.[nullable] @@ -2374,8 +2384,8 @@ is ASCII hwaddr1_len
- hwaddr2
- pointer to a binary or ASCII hardware address, or
NULL+ + pointer to a binary or ASCII hardware address, or
NULL.[nullable] @@ -2389,9 +2399,9 @@ is ASCII hwaddr2_len
@@ -2399,8 +2409,8 @@ different (or either of them is invalid).Returns
-
TRUEifhwaddr1+
TRUEifhwaddr1andhwaddr2-are equivalent,FALSEif they are +are equivalent,FALSEif they are 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
srcinto a hexadecimal string. Iffinal_len@@ -2445,7 +2455,7 @@ array
nm_utils_iface_valid_name ()
-gboolean +gboolean nm_utils_iface_valid_name (const char *name);@@ -2502,15 +2512,15 @@ nm_utils_iface_valid_name (
nm_utils_iface_valid_namehas been deprecated since version 1.6 and should not be used in newly-written code.const
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.
@@ -2530,7 +2540,7 @@ function in net/core/dev.c.@@ -2538,13 +2548,13 @@ function in net/core/dev.c. - error
+ location to store the error occurring, or
NULLto ignorelocation to store the error occurring, or
NULLto ignoreReturns
-+
TRUEif interface name is valid, otherwiseFALSEis returned.
TRUEif interface name is valid, otherwiseFALSEis returned.
nm_utils_is_uuid ()
-gboolean +gboolean nm_utils_is_uuid (const char *str);Checks if
@@ -2565,8 +2575,8 @@ nm_utils_is_uuid (stris a UUIDconst char
@@ -2595,10 +2605,10 @@ nm_utils_inet4_ntop (in_addr_tdst
the destination buffer, it must contain at least
INET_ADDRSTRLENorNM_UTILS_INET_ADDRSTRLEN-characters. If set toNULL, it will return a pointer to an internal, static +characters. If set toNULL, it will return a pointer to an internal, static buffer (shared withnm_utils_inet6_ntop()). Beware, that the internal buffer will be overwritten with ever new call ofnm_utils_inet4_ntop()or -nm_utils_inet6_ntop()that does not provied it's owndst+nm_utils_inet6_ntop()that does not provide its owndstbuffer. Also, using the internal buffer is not thread safe. When in doubt, pass your owndst@@ -2641,10 +2651,10 @@ nm_utils_inet6_ntop (const structdst
the destination buffer, it must contain at least
INET6_ADDRSTRLENorNM_UTILS_INET_ADDRSTRLEN-characters. If set toNULL, it will return a pointer to an internal, static +characters. If set toNULL, it will return a pointer to an internal, static buffer (shared withnm_utils_inet4_ntop()). Beware, that the internal buffer will be overwritten with ever new call ofnm_utils_inet4_ntop()or -nm_utils_inet6_ntop()that does not provied it's owndst+nm_utils_inet6_ntop()that does not provide its owndstbuffer. Also, using the internal buffer is not thread safe. When in doubt, pass your owndst@@ -2658,7 +2668,7 @@ buffer to avoid these issues.Returns
the input buffer
@@ -2666,7 +2676,7 @@ otherwise, this function cannot fail.dst, or a pointer to an -internal, static buffer.NULLis not allowed asin6addr+internal, static buffer.NULLis not allowed asin6addr, otherwise, this function cannot fail.
nm_utils_ipaddr_valid ()
-gboolean +gboolean nm_utils_ipaddr_valid (int family,const char *ip);Checks if
ip@@ -2696,16 +2706,16 @@ nm_utils_ipaddr_valid (int
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_typecan (in the general case) work with connections of typeother_type@@ -2719,7 +2729,7 @@ general case) work with connections of typeother_ty then this checks ifother_typeis a valid type for a slave of that master.Note that even if this returns
TRUEit is not guaranteed that +Note that even if this returns
TRUEit is not guaranteed that every connection of typeother_typeis compatible withvirtual_type@@ -2751,7 +2761,7 @@ underlying device driver.
@@ -2818,10 +2828,10 @@ 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 -
@@ -2836,7 +2846,7 @@ to an (unsigned) hex number.G_TYPE_FLAGSthe function returns a comma-separated list of matching values. +G_TYPE_FLAGSthe function returns a comma-separated list of matching values. If the value has no corresponding string representation, it is converted to a number. For enums it is converted to a decimal number, for flags to an (unsigned) hex number.- type
+ the
GTypeof the enumthe
GTypeof the enum@@ -2849,22 +2859,22 @@ to an (unsigned) hex number. 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_FLAGSthe function returns the logical OR of values +If the enum is a
G_TYPE_FLAGSthe function returns the logical OR of values matching the comma-separated tokens in the string; if an unknown token is found -the function returnsFALSEand stores a pointer to a newly allocated string +the function returnsFALSEand stores a pointer to a newly allocated string containing the unrecognized token inerr_token.@@ -2878,7 +2888,7 @@ containing the unrecognized token inerr_token- type
+ the
GTypeof the enumthe
GTypeof the enum@@ -2901,7 +2911,7 @@ containing the unrecognized token in err_tokenSince: 1.2
@@ -2909,9 +2919,9 @@ containing the unrecognized token inerr_tokennm_utils_enum_get_values ()
const char ** -nm_utils_enum_get_values (+nm_utils_enum_get_values (GType type, -gint from, -gint to);GType type, +gint from, +gint to);Returns the list of possible values for a given enum.
@@ -2943,7 +2953,7 @@ nm_utils_enum_get_values ( Returns
a NULL-terminated dynamically-allocated array of static strings -or
+orNULLon error.NULLon error.[transfer container]
Since: 1.2
@@ -2951,7 +2961,7 @@ orN
nm_utils_version ()
-guint +guint nm_utils_version (void);Returns
@@ -2963,13 +2973,13 @@ at runtime.
nm_utils_parse_variant_attributes ()
-GHashTable * +GHashTable * nm_utils_parse_variant_attributes (+const char *string,char attr_separator,char key_value_separator, -gboolean ignore_unknown, +gboolean ignore_unknown,const NMVariantAttributeSpec *const *spec, -GError **error);GError **error);Parse attributes from a string.
@@ -3024,18 +3035,18 @@ nm_utils_parse_variant_attributes (Parameters
@@ -3015,8 +3025,9 @@ nm_utils_parse_variant_attributes (constReturns
-a GHashTable mapping attribute names to GVariant values.
-[transfer full]
+a GHashTable mapping +attribute names to GVariant values.
+[transfer full][element-type utf8 GVariant]
Since: 1.8
constnm_utils_format_variant_attributes ()
char * -nm_utils_format_variant_attributes (GHashTable *attributes, +nm_utils_format_variant_attributes (GHashTable *attributes,char attr_separator,char key_value_separator);
nm_utils_tc_qdisc_from_str ()
-NMTCQdisc * +NMTCQdisc * nm_utils_tc_qdisc_from_str (+const char *str, -GError **error);GError **error);Parces the tc style string qdisc representation of the queueing -discipline to a
+discipline to aNMTCQdiscinstance. Supports a subset of the tc language.NMTCQdiscinstance. Supports a subset of the tc language.Parameters
@@ -3060,17 +3071,17 @@ discipline to a
NMTCQdiscinstance. Supports a subs -Since: 1.10.2
+Since: 1.12
nm_utils_tc_qdisc_to_str ()
char * -nm_utils_tc_qdisc_to_str (-NMTCQdisc *qdisc, -GError **error);Turns the
NMTCQdiscinto a tc style string representation of the queueing +nm_utils_tc_qdisc_to_str (NMTCQdisc *qdisc, +GError **error); +Turns the
NMTCQdiscinto a tc style string representation of the queueing discipline.Parameters
@@ -3083,7 +3094,7 @@ discipline.- qdisc
+ the
NMTCQdiscthe
NMTCQdisc@@ -3096,18 +3107,18 @@ discipline. - Since: 1.10.2
+Since: 1.12
nm_utils_tc_action_from_str ()
-NMTCAction * +NMTCAction * nm_utils_tc_action_from_str (+const char *str, -GError **error);GError **error);Parces the tc style string action representation of the queueing -discipline to a
+discipline to aNMTCActioninstance. Supports a subset of the tc language.NMTCActioninstance. Supports a subset of the tc language.Parameters
@@ -3132,17 +3143,17 @@ discipline to a
NMTCActioninstance. Supports a sub -Since: 1.10.2
+Since: 1.12
nm_utils_tc_action_to_str ()
char * -nm_utils_tc_action_to_str (-NMTCAction *action, -GError **error);Turns the
NMTCActioninto a tc style string representation of the queueing +nm_utils_tc_action_to_str (NMTCAction *action, +GError **error); +Turns the
NMTCActioninto a tc style string representation of the queueing discipline.Parameters
@@ -3155,7 +3166,7 @@ discipline.- action
+ the
NMTCActionthe
NMTCAction@@ -3168,18 +3179,18 @@ discipline. - Since: 1.10.2
+Since: 1.12
nm_utils_tc_tfilter_from_str ()
-NMTCTfilter * +NMTCTfilter * nm_utils_tc_tfilter_from_str (+const char *str, -GError **error);GError **error);Parces the tc style string tfilter representation of the queueing -discipline to a
+discipline to aNMTCTfilterinstance. Supports a subset of the tc language.NMTCTfilterinstance. Supports a subset of the tc language.Parameters
@@ -3204,17 +3215,17 @@ discipline to a
NMTCTfilterinstance. Supports a su -Since: 1.10.2
+Since: 1.12
nm_utils_tc_tfilter_to_str ()
char * -nm_utils_tc_tfilter_to_str (-NMTCTfilter *tfilter, -GError **error);Turns the
NMTCTfilterinto a tc style string representation of the queueing +nm_utils_tc_tfilter_to_str (NMTCTfilter *tfilter, +GError **error); +Turns the
NMTCTfilterinto a tc style string representation of the queueing discipline.Parameters
@@ -3227,7 +3238,7 @@ discipline.- tfilter
+ the
NMTCTfilterthe
NMTCTfilter@@ -3240,9 +3251,15 @@ discipline. - Since: 1.10.2
+Since: 1.12
+ +
+@@ -3360,6 +3377,6 @@ for both -+
Generated by GTK-Doc V1.27
Generated by GTK-Doc V1.28