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
 
@@ -1183,7 +1183,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]
 
@@ -1191,12 +1191,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. Note that invalid addresses are discarded
@@ -1214,7 +1214,7 @@ but the valid addresses are still returned.
 
-
+
@@ -1229,17 +1229,17 @@ contain the IP gateway. 

 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).
 
@@ -1259,7 +1259,7 @@ metric).
 
 
 Returns
-a new floating GVariant representing routes
+
a new floating GVariant representing routes
 . 
 [transfer none]
 
@@ -1267,11 +1267,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. Note that invalid routes
+and metric) into a GPtrArray of NMIPRoute objects. Note that invalid routes
 are discarded but the valid routes are still returned.
 Since 1.46, an empty list is returned if the variant type is not valid
 (before it was checked as assertion)
@@ -1285,7 +1285,7 @@ are discarded but the valid routes are still returned.
 
 
-
+
 
 
 
 value a GVariant of type 'aau' a GVariant of type 'aau'
  
 
 
 
 
 
 

 value GVariant of type 'aau' GVariant of type 'aau'
  
 
 
@@ -1293,15 +1293,15 @@ are discarded but the valid routes are still returned.
 
 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
 
@@ -1331,8 +1331,8 @@ set.

 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
 

 
 
@@ -1356,8 +1356,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
@@ -1385,9 +1385,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.
 If a string cannot be parsed, it will be silently ignored.
 
@@ -1407,7 +1407,7 @@ type 'aay' representing an array of IPv6 addresses.
 
 
 Returns
-a new floating GVariant representing dns
+
a new floating GVariant representing dns
 . 
 [transfer none]
 
@@ -1416,8 +1416,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. Each "ay" entry must be
 a IPv6 address in binary form (16 bytes long). Invalid entries are silently
 ignored.
@@ -1433,29 +1433,29 @@ ignored.
 
 
-
+
 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
@@ -1481,7 +1481,7 @@ all 0s.
 
 
 Returns
-a new floating GVariant representing addresses
+
a new floating GVariant representing addresses
 . 
 [transfer none]
 
@@ -1489,12 +1489,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. Note that invalid addresses are
@@ -1512,7 +1512,7 @@ discarded but the valid addresses are still returned.
 
 
 value
-a GVariant of type 'a(ayuay)'
+a GVariant of type 'a(ayuay)'
  
 
 
@@ -1527,17 +1527,17 @@ contain the IP gateway. 
 
 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).
 
@@ -1557,7 +1557,7 @@ metric).
 
 
 Returns
-a new floating GVariant representing routes
+
a new floating GVariant representing routes
 . 
 [transfer none]
 
@@ -1565,11 +1565,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. Note that invalid
+hop, and metric) into a GPtrArray of NMIPRoute objects. Note that invalid
 routes are ignored but the valid ones are still returned.
 Since 1.46, an empty list is returned if the variant type is not valid
 (before it was checked as assertion)
@@ -1583,7 +1583,7 @@ routes are ignored but the valid ones are still returned.
 
 
 value
-GVariant of type 'a(ayuayu)'
+GVariant of type 'a(ayuayu)'
  
 
 
@@ -1591,17 +1591,17 @@ routes are ignored but the valid ones are still returned.
 
 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.
@@ -1622,7 +1622,7 @@ include additional attributes.
 
 
 Returns
-a new floating GVariant representing addresses
+
a new floating GVariant representing addresses
 . 
 [transfer none]
 
@@ -1631,12 +1631,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. Note that invalid addresses are discarded but the valid addresses
 are still returned.
 Since 1.46, an empty list is returned if the variant type is not valid
@@ -1652,7 +1652,7 @@ are still returned.
 
 
 value
-a GVariant of type 'aa{sv}'
+a GVariant of type 'aa{sv}'
  
 
 
@@ -1666,7 +1666,7 @@ are still returned.
 
 Returns
 a newly allocated
-GPtrArray of NMIPAddress objects. 
+GPtrArray of NMIPAddress objects. 
 [transfer full][element-type NMIPAddress]
 
 Since: 1.42
@@ -1674,10 +1674,10 @@ are still returned.
 
 
 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. All routes will include "dest" (an IP
 address string), "prefix" (an uint) and optionally "next-hop" (an IP address
 string) and "metric" (an uint). Some routes may include additional attributes.
@@ -1700,7 +1700,7 @@ valid routes are still returned.
 
 
 Returns
-a new floating GVariant representing routes
+
a new floating GVariant representing routes
 . 
 [transfer none]
 
@@ -1709,12 +1709,12 @@ valid routes are still returned.
 
 
 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 (as described in the documentation for
-nm_utils_ip_routes_to_variant()) into a GPtrArray of NMIPRoute objects.
+nm_utils_ip_routes_to_variant()) into a GPtrArray of NMIPRoute objects.
 Invalid routes are discarded but the valid routes are still returned.
 Since 1.46, an empty list is returned if the variant type is not valid
 (before it was checked as assertion)
@@ -1729,7 +1729,7 @@ Invalid routes are discarded but the valid routes are still returned.
 
 
 value
-a GVariant of type 'aa{sv}'
+a GVariant of type 'aa{sv}'
  
 
 
@@ -1743,7 +1743,7 @@ Invalid routes are discarded but the valid routes are still returned.
 
 Returns
 a newly allocated
-GPtrArray of NMIPRoute objects. 
+GPtrArray of NMIPRoute objects. 
 [transfer full][element-type NMIPRoute]
 
 Since: 1.42
@@ -1756,24 +1756,24 @@ 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()
 

 

 
 
 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);
 
 
 
@@ -1782,10 +1782,10 @@ object's “id”: property.  Should be freed with 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 . @@ -1812,16 +1812,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. [nullable] 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(). @@ -1842,7 +1842,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. @@ -1850,7 +1850,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]

@@ -1859,8 +1859,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

@@ -1885,8 +1885,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. @@ -1921,8 +1921,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. @@ -1961,8 +1961,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. @@ -1989,13 +1989,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). @@ -2007,7 +2007,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). @@ -2020,7 +2020,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. @@ -2051,7 +2051,7 @@ the functionality are encouraged to make their implementations instead. nm_utils_hwaddr_len () -gsize +gsize nm_utils_hwaddr_len (int type); Returns the length in octets of a hardware address of type type . @@ -2082,8 +2082,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. @@ -2119,12 +2119,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 @@ -2149,7 +2149,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] @@ -2158,10 +2158,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 . @@ -2198,7 +2198,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 . @@ -2207,9 +2207,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. @@ -2239,9 +2239,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. @@ -2249,7 +2249,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 @@ -2282,18 +2282,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 @@ -2307,7 +2307,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. @@ -2336,7 +2336,7 @@ guaranteed to not match if they are invalid.) - + @@ -2348,7 +2348,7 @@ is ASCII - + @@ -2363,9 +2363,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). @@ -2373,8 +2373,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 @@ -2419,7 +2419,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 @@ -2445,14 +2445,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. @@ -2476,18 +2476,18 @@ nm_utils_iface_valid_name (const Returns - TRUE if interface name is valid, otherwise FALSE is returned. -Before 1.20, this function did not accept NULL as name + TRUE if interface name is valid, otherwise FALSE is returned. +Before 1.20, this function did not accept NULL as name argument. If you -want to run against older versions of libnm, don't pass NULL. +want to run against older versions of libnm, don't pass NULL. 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. @@ -2507,7 +2507,7 @@ function in net/core/dev.c. - + @@ -2515,17 +2515,17 @@ function in net/core/dev.c. Returns - TRUE if interface name is valid, otherwise FALSE is returned. -Before 1.20, this function did not accept NULL as name + TRUE if interface name is valid, otherwise FALSE is returned. +Before 1.20, this function did not accept NULL as name argument. If you -want to run against older versions of libnm, don't pass NULL. +want to run against older versions of libnm, don't pass NULL. Since: 1.6 nm_utils_is_uuid () -gboolean +gboolean nm_utils_is_uuid (const char *str); nm_utils_is_uuid has been deprecated since version 1.32 and should not be used in newly-written code. @@ -2552,17 +2552,17 @@ nm_utils_is_uuid (const char Returns - TRUE if str -is a UUID, FALSE if not -In older versions, nm_utils_is_uuid() did not accept NULL as str -argument. Don't pass NULL if you run against older versions of libnm. + TRUE if str +is a UUID, FALSE if not +In older versions, nm_utils_is_uuid() did not accept NULL as str +argument. Don't pass NULL if you run against older versions of libnm. nm_utils_inet4_ntop () const char * -nm_utils_inet4_ntop (guint32 inaddr, +nm_utils_inet4_ntop (guint32 inaddr, char *dst); Wrapper for inet_ntop. [skip] @@ -2584,7 +2584,7 @@ nm_utils_inet4_ntop (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. @@ -2657,7 +2657,7 @@ otherwise, this function cannot fail. nm_utils_ipaddr_valid () -gboolean +gboolean nm_utils_ipaddr_valid (int family, const char *ip); Checks if ip @@ -2687,16 +2687,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 @@ -2710,7 +2710,7 @@ general case) work with connections of type other_ty then this checks if other_type is a valid type for a port of that controller. -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 @@ -2742,7 +2742,7 @@ underlying device driver. Returns - TRUE or FALSE + TRUE or FALSE @@ -2809,10 +2809,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. @@ -2827,7 +2827,7 @@ to an (unsigned) hex number. - + @@ -2840,22 +2840,22 @@ to an (unsigned) hex number. 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 . @@ -2869,7 +2869,7 @@ containing the unrecognized token in err_token - + @@ -2893,7 +2893,7 @@ the first unrecognized token. Returns - TRUE if the conversion was successful, FALSE otherwise + TRUE if the conversion was successful, FALSE otherwise Since: 1.2 @@ -2901,7 +2901,7 @@ the first unrecognized token. nm_utils_enum_get_values () const char ** -nm_utils_enum_get_values (GType type, +nm_utils_enum_get_values (GType type, int from, int to); Returns the list of possible values for a given enum. @@ -2916,7 +2916,7 @@ nm_utils_enum_get_values (type - + @@ -2935,7 +2935,7 @@ nm_utils_enum_get_values ( Returns a NULL-terminated dynamically-allocated array of static strings -or NULL on error. +or NULL on error. [transfer container] Since: 1.2 @@ -2943,7 +2943,7 @@ or N nm_utils_version () -guint +guint nm_utils_version (void); Returns @@ -2955,13 +2955,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. Parameters @@ -3007,8 +3007,8 @@ nm_utils_parse_variant_attributes (const Returns -a GHashTable mapping -attribute names to GVariant values. Warning: the variant are still floating + a GHashTable mapping +attribute names to GVariant values. Warning: the variant are still floating references, owned by the hash table. If you take a reference, ensure to sink the one of the hash table first. [transfer full][element-type utf8 GVariant] @@ -3019,7 +3019,7 @@ the one of the hash table first. 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); Format attributes to a string. @@ -3034,7 +3034,7 @@ nm_utils_format_variant_attributes (attributes - + @@ -3052,7 +3052,7 @@ nm_utils_format_variant_attributes ( Returns -the string representing attributes, or NULL + the string representing attributes, or NULL in case there are no attributes. [transfer full] @@ -3063,7 +3063,7 @@ in case there are no attributes. nm_utils_tc_qdisc_from_str () NMTCQdisc * nm_utils_tc_qdisc_from_str (const char *str, - GError **error); + GError **error); Parses the tc style string qdisc representation of the queueing discipline to a NMTCQdisc instance. Supports a subset of the tc language. @@ -3090,7 +3090,7 @@ discipline to a Returns - the NMTCQdisc or NULL + the NMTCQdisc or NULL Since: 1.12 @@ -3099,7 +3099,7 @@ discipline to a nm_utils_tc_qdisc_to_str () char * nm_utils_tc_qdisc_to_str (NMTCQdisc *qdisc, - GError **error); + GError **error); Turns the NMTCQdisc into a tc style string representation of the queueing discipline. @@ -3126,7 +3126,7 @@ discipline. Returns - formatted string or NULL + formatted string or NULL Since: 1.12 @@ -3135,7 +3135,7 @@ discipline. nm_utils_tc_action_from_str () NMTCAction * nm_utils_tc_action_from_str (const char *str, - GError **error); + GError **error); Parses the tc style string action representation of the queueing discipline to a NMTCAction instance. Supports a subset of the tc language. @@ -3162,7 +3162,7 @@ discipline to a Returns - the NMTCAction or NULL + the NMTCAction or NULL Since: 1.12 @@ -3171,7 +3171,7 @@ discipline to a nm_utils_tc_action_to_str () char * nm_utils_tc_action_to_str (NMTCAction *action, - GError **error); + GError **error); Turns the NMTCAction into a tc style string representation of the queueing discipline. @@ -3198,7 +3198,7 @@ discipline. Returns - formatted string or NULL + formatted string or NULL Since: 1.12 @@ -3207,7 +3207,7 @@ discipline. nm_utils_tc_tfilter_from_str () NMTCTfilter * nm_utils_tc_tfilter_from_str (const char *str, - GError **error); + GError **error); Parses the tc style string tfilter representation of the queueing discipline to a NMTCTfilter instance. Supports a subset of the tc language. @@ -3234,7 +3234,7 @@ discipline to a Returns - the NMTCTfilter or NULL + the NMTCTfilter or NULL Since: 1.12 @@ -3243,7 +3243,7 @@ discipline to a nm_utils_tc_tfilter_to_str () char * nm_utils_tc_tfilter_to_str (NMTCTfilter *tfilter, - GError **error); + GError **error); Turns the NMTCTfilter into a tc style string representation of the queueing discipline. @@ -3270,7 +3270,7 @@ discipline. Returns - formatted string or NULL + formatted string or NULL Since: 1.12 @@ -3279,8 +3279,8 @@ discipline. nm_utils_sriov_vf_to_str () char * nm_utils_sriov_vf_to_str (const NMSriovVF *vf, - gboolean omit_index, - GError **error); + gboolean omit_index, + GError **error); Converts a SR-IOV virtual function object to its string representation. Parameters @@ -3298,7 +3298,7 @@ nm_utils_sriov_vf_to_str (const - + @@ -3311,7 +3311,7 @@ nm_utils_sriov_vf_to_str (const Returns - a newly allocated string or NULL on error + a newly allocated string or NULL on error Since: 1.14 @@ -3320,7 +3320,7 @@ nm_utils_sriov_vf_to_str (const nm_utils_sriov_vf_from_str () NMSriovVF * nm_utils_sriov_vf_from_str (const char *str, - GError **error); + GError **error); Converts a string to a SR-IOV virtual function object. Parameters @@ -3354,7 +3354,7 @@ nm_utils_sriov_vf_from_str (const nm_utils_get_timestamp_msec () -gint64 +gint64 nm_utils_get_timestamp_msec (void); Gets current time in milliseconds of CLOCK_BOOTTIME. @@ -3366,10 +3366,10 @@ nm_utils_get_timestamp_msec (void nm_utils_base64secret_decode () -gboolean +gboolean nm_utils_base64secret_decode (const char *base64_key, - gsize required_key_len, - guint8 *out_key); + gsize required_key_len, + guint8 *out_key); Parameters hwaddr1 pointer to a binary or ASCII hardware address, or NULL. pointer to a binary or ASCII hardware address, or NULL. [nullable] hwaddr2 pointer to a binary or ASCII hardware address, or NULL. pointer to a binary or ASCII hardware address, or NULL. [nullable] 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_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 provide its own dst @@ -2631,7 +2631,7 @@ nm_utils_inet6_ntop (const struct dst the destination buffer, it must contain at least INET6_ADDRSTRLEN or NM_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 provide its own dst @@ -2649,7 +2649,7 @@ buffer to avoid these issues. type the GType of the enum the GType of the enum type the GType of the enum the GType of the enum the GType of the enum the GType of the enum a GHashTable mapping attribute names to GVariant values. a GHashTable mapping attribute names to GVariant values. [element-type utf8 GVariant] omit_index if TRUE, the VF index will be omitted from output string if TRUE, the VF index will be omitted from output string @@ -3402,7 +3402,7 @@ bytes. Returns - TRUE if the input key is a valid base64 encoded key + TRUE if the input key is a valid base64 encoded key with required_key_len bytes. @@ -3560,6 +3560,6 @@ for both -Generated by GTK-Doc V1.33.1 +Generated by GTK-Doc V1.34.0 \ No newline at end of file -- cgit 1.3.0-6-gf8a5

hwaddr1	pointer to a binary or ASCII hardware address, or `NULL`.	pointer to a binary or ASCII hardware address, or `NULL`.	[nullable]
hwaddr2	pointer to a binary or ASCII hardware address, or `NULL`.	pointer to a binary or ASCII hardware address, or `NULL`.	[nullable]
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_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 provide its own `dst` @@ -2631,7 +2631,7 @@ nm_utils_inet6_ntop (`const struct`	dst	the destination buffer, it must contain at least `INET6_ADDRSTRLEN` or `NM_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 provide its own `dst` @@ -2649,7 +2649,7 @@ buffer to avoid these issues.
type	the `GType` of the enum	the `GType` of the enum
type	the `GType` of the enum	the `GType` of the enum
the `GType` of the enum	the `GType` of the enum
a GHashTable mapping attribute names to GVariant values.	a GHashTable mapping attribute names to GVariant values.	[element-type utf8 GVariant]
omit_index	if `TRUE`, the VF index will be omitted from output string	if `TRUE`, the VF index will be omitted from output string

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

Functions

nm_utils_is_empty_ssid ()

Returns

nm_utils_escape_ssid ()

nm_utils_same_ssid ()

Returns

nm_utils_ssid_to_utf8 ()

Returns

nm_utils_security_valid ()

Returns

nm_utils_ap_mode_security_valid ()

Returns

nm_utils_wep_key_valid ()

Returns

nm_utils_wpa_psk_valid ()

Returns

nm_utils_is_json_object ()

Parameters

Returns

nm_utils_ip4_dns_to_variant ()

Parameters

Returns

nm_utils_ip4_dns_from_variant ()

Returns

nm_utils_ip4_addresses_to_variant ()

Parameters

Returns

nm_utils_ip4_addresses_from_variant ()

Returns

nm_utils_ip4_routes_to_variant ()

Returns

nm_utils_ip4_routes_from_variant ()

Returns

nm_utils_ip4_netmask_to_prefix ()

Parameters

nm_utils_ip4_prefix_to_netmask ()

Parameters

nm_utils_ip4_get_default_prefix ()

nm_utils_ip6_dns_to_variant ()

Returns

nm_utils_ip6_dns_from_variant ()

Returns

nm_utils_ip6_addresses_to_variant ()

Parameters

Returns

nm_utils_ip6_addresses_from_variant ()

Returns

nm_utils_ip6_routes_to_variant ()

Returns

nm_utils_ip6_routes_from_variant ()

Returns

nm_utils_ip_addresses_to_variant ()

Returns

nm_utils_ip_addresses_from_variant ()

Returns

nm_utils_ip_routes_to_variant ()

Returns

nm_utils_ip_routes_from_variant ()

Returns

Returns

NMUtilsFileSearchInPathsPredicate ()

NMUtilsCheckFilePredicate ()

Returns

nm_utils_wifi_freq_to_channel ()

Parameters

nm_utils_wifi_channel_to_freq ()

nm_utils_wifi_find_next_channel ()

nm_utils_wifi_is_channel_valid ()

Returns

nm_utils_wifi_2ghz_freqs ()

nm_utils_wifi_5ghz_freqs ()

nm_utils_wifi_strength_bars ()

nm_utils_hwaddr_len ()

nm_utils_hwaddr_ntoa ()

nm_utils_hwaddr_atoba ()

Parameters

Returns

nm_utils_hwaddr_aton ()

Returns

nm_utils_hwaddr_valid ()

`nm_utils_tc_qdisc_to_str ()`

`nm_utils_tc_action_to_str ()`

`nm_utils_tc_tfilter_to_str ()`