From afcd268ea7b1149fbfb66bce4eca659b675da0a2 Mon Sep 17 00:00:00 2001
From: Michael Biebl
-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 ()
@@ -559,6 +559,54 @@
nm_utils_format_variant_attributes ()
+
+
+NMTCQdisc *
+
+
+nm_utils_tc_qdisc_from_str ()
+
+
+
+
+char *
+
+
+nm_utils_tc_qdisc_to_str ()
+
+
+
+
+NMTCAction *
+
+
+nm_utils_tc_action_from_str ()
+
+
+
+
+char *
+
+
+nm_utils_tc_action_to_str ()
+
+
+
+
+NMTCTfilter *
+
+
+nm_utils_tc_tfilter_from_str ()
+
+
+
@@ -595,7 +643,7 @@
@@ -608,9 +656,9 @@ access points and devices, among other things.
+char *
+
+
+nm_utils_tc_tfilter_to_str ()
+
+
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.
@@ -625,7 +673,7 @@ number of known SSID-cloaking methods.ssid
pointer to a buffer containing the SSID data.
pointer to a buffer containing the SSID data.
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 @@ -663,7 +711,7 @@ be used for display of SSIDs.
ssid
pointer to a buffer containing the SSID data.
pointer to a buffer containing the SSID data.
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) @@ -707,7 +755,7 @@ NULLs, even though that is functionally pointless.
ssid1
the first SSID to compare.
the first SSID to compare.
ssid2
the second SSID to compare.
the second SSID to compare.
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 @@ -776,7 +824,7 @@ _only_.
ssid
pointer to a buffer containing the SSID data.
pointer to a buffer containing the SSID data.
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.
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.
[transfer full]
gboolean +gboolean nm_utils_security_valid (@@ -868,15 +916,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 @@ -908,15 +956,15 @@ e.g.
gboolean +gboolean nm_utils_wep_key_valid (const char *key,NMWepKeyType wep_type);Checks if
key@@ -945,14 +993,14 @@ nm_utils_wep_key_valid (const cha
gboolean +gboolean nm_utils_wpa_psk_valid (const char *psk);Checks if
@@ -973,16 +1021,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);
a new floating GVariant representing dns
+
a new floating GVariant representing dns
.
[transfer none]
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.
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
@@ -1094,12 +1142,12 @@ gateway). The "gateway" field of the first address will get the value of
- addresses
+ an array of NMIPAddress objects.
an array of NMIPAddress objects.
[element-type NMIPAddress] @@ -1107,7 +1155,7 @@ gateway). The "gateway" field of the first address will get the value of - gateway
+ the gateway IP address.
the gateway IP address.
[allow-none] @@ -1115,12 +1163,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
@@ -1135,12 +1183,12 @@ 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'
@@ -1148,18 +1196,18 @@ of the other addresses are ignored. - out_gateway
+ on return, will contain the IP gateway.
on return, will contain the IP gateway.
[out][allow-none][transfer full] Returns
-a newly allocated -GPtrArray of NMIPAddress objects.
+a newly allocated +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).
@@ -1172,14 +1220,14 @@ metric).- routes
+ an array of NMIP4Route objects.
an array of NMIP4Route objects.
[element-type NMIPRoute] @@ -1187,11 +1235,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
@@ -1242,8 +1290,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
@@ -1267,8 +1315,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 @@ -1296,9 +1344,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.
@@ -1326,8 +1374,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.
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
@@ -1374,12 +1422,12 @@ all 0s.- addresses
+ an array of NMIPAddress objects.
an array of NMIPAddress objects.
[element-type NMIPAddress] @@ -1387,7 +1435,7 @@ all 0s. - gateway
+ the gateway IP address.
the gateway IP address.
[allow-none] @@ -1395,12 +1443,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
@@ -1415,12 +1463,12 @@ 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)'
@@ -1428,18 +1476,18 @@ fields of the other addresses are ignored. - out_gateway
+ on return, will contain the IP gateway.
on return, will contain the IP gateway.
[out][allow-none][transfer full] Returns
-a newly allocated -GPtrArray of NMIPAddress objects.
+a newly allocated +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).
@@ -1467,11 +1515,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.
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.
@@ -1514,14 +1562,14 @@ include additional attributes.- addresses
+ an array of NMIPAddress objects.
an array of NMIPAddress objects.
[element-type NMIPAddress]
a new floating GVariant representing addresses
+
a new floating GVariant representing addresses
.
[transfer none]
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
@@ -1547,7 +1595,7 @@ objects.- value
+ a GVariant of type 'aa{sv}'
a GVariant of type 'aa{sv}'
@@ -1560,18 +1608,18 @@ objects. Returns
-a newly allocated -GPtrArray of NMIPAddress objects.
+a newly allocated +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).
@@ -1599,12 +1647,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.
@@ -1630,8 +1678,8 @@ prefix, next hop, metric, and additional attributes) into a Returns
-a newly allocated -GPtrArray of NMIPRoute objects.
+a newly allocated +GPtrArray of NMIPRoute objects.
[transfer full][element-type NMIPRoute]
@@ -1643,13 +1691,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 @@ -1672,15 +1720,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 @@ -1701,7 +1749,7 @@ recognized by NetworkManager.@@ -1709,13 +1757,13 @@ recognized by NetworkManager. - out_encrypted
+ on return, whether the file is encrypted.
on return, whether the file is encrypted.
[out]
gboolean +gboolean nm_utils_file_is_pkcs12 (const char *filename);Tests if
@@ -1736,24 +1784,24 @@ nm_utils_file_is_pkcs12 (filenameis a PKCS#12 file.const ch
gboolean +gboolean (*NMUtilsFileSearchInPathsPredicate) (+const char *filename, -gpointer user_data);gpointer user_data);
gboolean +gboolean (*NMUtilsCheckFilePredicate) (+const char *filename,const struct stat *stat, -gpointer user_data, -GError **error);gpointer user_data, +GError **error);
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
.
@@ -1786,27 +1834,27 @@ Must be a non-empty string, without path separator (/).
try_first
a custom path to try first before searching. +
a custom path to try first before searching. 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.
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().
g_file_test().
predicate
if given, pass the file name to this function +
if given, pass the file name to this function
for additional checks. This check is performed after the check for
file_test_flags
. You cannot omit both file_test_flags
@@ -1816,13 +1864,13 @@ and predicate
user_data
(allow-none): user data for predicate
+
(allow-none): user data for predicate
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.
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]
@@ -1839,8 +1887,8 @@ invocations of the function might overwrite it.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.
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.
@@ -1901,8 +1949,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.
@@ -1941,8 +1989,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).
@@ -1987,7 +2035,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).
@@ -2000,7 +2048,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
@@ -2029,7 +2077,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
.
@@ -2060,8 +2108,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.
@@ -2075,7 +2123,7 @@ nm_utils_hwaddr_ntoa (addr
- a binary hardware address.
+a binary hardware address.
[type guint8][array length=length]
Returns
- the textual form of addr
+
the textual form of addr
.
[transfer full]
@@ -2097,12 +2145,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
@@ -2127,7 +2175,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]
@@ -2136,10 +2184,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
.
@@ -2176,7 +2224,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
.
@@ -2185,9 +2233,9 @@ or would be shorter or longer than length
@@ -2227,7 +2275,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
@@ -2258,20 +2306,20 @@ is expected to convert to
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
@@ -2285,7 +2333,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.
@@ -2314,7 +2362,7 @@ guaranteed to not match if they are invalid.)
hwaddr1
-pointer to a binary or ASCII hardware address, or NULL
+pointer to a binary or ASCII hardware address, or NULL
@@ -2326,7 +2374,7 @@ is ASCII
hwaddr2
-pointer to a binary or ASCII hardware address, or NULL
+pointer to a binary or ASCII hardware address, or NULL
@@ -2341,9 +2389,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).
@@ -2351,8 +2399,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
@@ -2370,7 +2418,7 @@ greater than -1, the returned string is terminated at that index
src
- an array of bytes.
+an array of bytes.
[type guint8][array length=len]
@@ -2389,7 +2437,7 @@ array
@@ -2397,7 +2445,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
@@ -2423,14 +2471,14 @@ 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.
@@ -2454,15 +2502,15 @@ nm_utils_iface_valid_name (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.
@@ -2482,7 +2530,7 @@ function in net/core/dev.c.
error
-location to store the error occurring, or NULL to ignore
+location to store the error occurring, or NULL to ignore
@@ -2490,13 +2538,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
@@ -2517,8 +2565,8 @@ nm_utils_is_uuid (const char
@@ -2547,7 +2595,7 @@ nm_utils_inet4_ntop (in_addr_tdst
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
@@ -2593,7 +2641,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
@@ -2610,7 +2658,7 @@ buffer to avoid these issues.
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.
@@ -2618,7 +2666,7 @@ otherwise, this function cannot fail.
nm_utils_ipaddr_valid ()
-gboolean
+gboolean
nm_utils_ipaddr_valid (int family,
const char *ip);
Checks if ip
@@ -2648,16 +2696,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_type
can (in the
general case) work with connections of type other_type
@@ -2671,7 +2719,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
@@ -2703,7 +2751,7 @@ underlying device driver.
@@ -2770,10 +2818,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
-G_TYPE_FLAGS the function returns a comma-separated list of matching values.
+G_TYPE_FLAGS the 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.
@@ -2788,7 +2836,7 @@ to an (unsigned) hex number.
type
-the GType of the enum
+the GType of the enum
@@ -2801,22 +2849,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_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
.
@@ -2830,7 +2878,7 @@ containing the unrecognized token in err_token
type
-the GType of the enum
+the GType of the enum
@@ -2840,12 +2888,12 @@ containing the unrecognized token in err_token
out_value
- the output value.
+the output value.
[out][allow-none]
err_token
- location to store the first unrecognized token.
+location to store the first unrecognized token.
[out][allow-none][transfer full]
@@ -2853,7 +2901,7 @@ containing the unrecognized token in err_token
Since: 1.2
@@ -2861,9 +2909,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.
-the GType of the enum
+the GType of the enum
@@ -2894,8 +2942,8 @@ nm_utils_enum_get_values (
Returns
- a NULL-terminated dynamically-allocated array of static strings
-or NULL on error.
+a NULL-terminated dynamically-allocated array of static strings
+or NULL on error.
[transfer container]
Since: 1.2
@@ -2903,7 +2951,7 @@ or
nm_utils_version ()
-guint
+guint
nm_utils_version (void);
Returns
@@ -2915,13 +2963,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.
@@ -2967,7 +3015,7 @@ nm_utils_parse_variant_attributes (const
Returns
- a GHashTable mapping attribute names to GVariant values.
+a GHashTable mapping attribute names to GVariant values.
[transfer full]
Since: 1.8
@@ -2976,10 +3024,226 @@ nm_utils_parse_variant_attributes (const
nm_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 *
+nm_utils_tc_qdisc_from_str (const char *str,
+ GError **error);
+Parces the tc style string qdisc representation of the queueing
+discipline to a NMTCQdisc instance. Supports a subset of the tc language.
+
+Parameters
+
+
+
+
+
+
+
+
+str
+the string representation of a qdisc
+
+
+
+error
+location of the error
+
+
+
+
+
+
+Since: 1.10.2
+
+
+
+nm_utils_tc_qdisc_to_str ()
+char *
+nm_utils_tc_qdisc_to_str (NMTCQdisc *qdisc,
+ GError **error);
+Turns the NMTCQdisc into a tc style string representation of the queueing
+discipline.
+
+
+Since: 1.10.2
+
+
+
+nm_utils_tc_action_from_str ()
+NMTCAction *
+nm_utils_tc_action_from_str (const char *str,
+ GError **error);
+Parces the tc style string action representation of the queueing
+discipline to a NMTCAction instance. Supports a subset of the tc language.
+
+Parameters
+
+
+
+
+
+
+
+
+str
+the string representation of a action
+
+
+
+error
+location of the error
+
+
+
+
+
+
+Since: 1.10.2
+
+
+
+nm_utils_tc_action_to_str ()
+char *
+nm_utils_tc_action_to_str (NMTCAction *action,
+ GError **error);
+Turns the NMTCAction into a tc style string representation of the queueing
+discipline.
+
+
+Since: 1.10.2
+
+
+
+nm_utils_tc_tfilter_from_str ()
+NMTCTfilter *
+nm_utils_tc_tfilter_from_str (const char *str,
+ GError **error);
+Parces the tc style string tfilter representation of the queueing
+discipline to a NMTCTfilter instance. Supports a subset of the tc language.
+
+Parameters
+
+
+
+
+
+
+
+
+str
+the string representation of a tfilter
+
+
+
+error
+location of the error
+
+
+
+
+
+
+Since: 1.10.2
+
+
+
+nm_utils_tc_tfilter_to_str ()
+char *
+nm_utils_tc_tfilter_to_str (NMTCTfilter *tfilter,
+ GError **error);
+Turns the NMTCTfilter into a tc style string representation of the queueing
+discipline.
+
+
+Since: 1.10.2
+
+
Generated by GTK-Doc V1.26