2014-07-24 12:53:33 +00:00
|
|
|
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: t; c-basic-offset: 4 -*- */
|
|
|
|
/*
|
|
|
|
* This library is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
|
|
* License as published by the Free Software Foundation; either
|
|
|
|
* version 2 of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This library is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
* Lesser General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
|
|
* License along with this library; if not, write to the
|
|
|
|
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
|
|
* Boston, MA 02110-1301 USA.
|
|
|
|
*
|
2014-12-16 17:13:14 +00:00
|
|
|
* Copyright 2005 - 2014 Red Hat, Inc.
|
2014-07-24 12:53:33 +00:00
|
|
|
*/
|
|
|
|
|
all: fix up multiple-include-guard defines
Previously, src/nm-ip4-config.h, libnm/nm-ip4-config.h, and
libnm-glib/nm-ip4-config.h all used "NM_IP4_CONFIG_H" as an include
guard, which meant that nm-test-utils.h could not tell which of them
was being included (and so, eg, if you tried to include
nm-ip4-config.h in a libnm test, it would fail to compile because
nm-test-utils.h was referring to symbols in src/nm-ip4-config.h).
Fix this by changing the include guards in the non-API-stable parts of
the tree:
- libnm-glib/nm-ip4-config.h remains NM_IP4_CONFIG_H
- libnm/nm-ip4-config.h now uses __NM_IP4_CONFIG_H__
- src/nm-ip4-config.h now uses __NETWORKMANAGER_IP4_CONFIG_H__
And likewise for all other headers.
The two non-"nm"-prefixed headers, libnm/NetworkManager.h and
src/NetworkManagerUtils.h are now __NETWORKMANAGER_H__ and
__NETWORKMANAGER_UTILS_H__ respectively, which, while not entirely
consistent with the general scheme, do still mostly make sense in
isolation.
2014-08-13 18:10:11 +00:00
|
|
|
#ifndef __NM_UTILS_H__
|
|
|
|
#define __NM_UTILS_H__
|
2014-07-24 12:53:33 +00:00
|
|
|
|
2014-07-06 20:53:02 +00:00
|
|
|
#if !defined (__NETWORKMANAGER_H_INSIDE__) && !defined (NETWORKMANAGER_COMPILATION)
|
|
|
|
#error "Only <NetworkManager.h> can be included directly."
|
|
|
|
#endif
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
#include <glib.h>
|
|
|
|
|
2014-10-22 02:09:52 +00:00
|
|
|
#include <netinet/in.h>
|
|
|
|
|
2014-08-02 14:50:25 +00:00
|
|
|
/* For ETH_ALEN and INFINIBAND_ALEN */
|
|
|
|
#include <linux/if_ether.h>
|
|
|
|
#include <linux/if_infiniband.h>
|
|
|
|
|
2014-07-04 17:26:57 +00:00
|
|
|
#include "nm-core-enum-types.h"
|
2014-10-22 02:09:52 +00:00
|
|
|
#include "nm-setting-wireless-security.h"
|
2014-07-24 12:53:33 +00:00
|
|
|
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
|
|
/* SSID helpers */
|
2014-06-26 13:25:06 +00:00
|
|
|
gboolean nm_utils_is_empty_ssid (const guint8 *ssid, gsize len);
|
|
|
|
const char *nm_utils_escape_ssid (const guint8 *ssid, gsize len);
|
|
|
|
gboolean nm_utils_same_ssid (const guint8 *ssid1, gsize len1,
|
|
|
|
const guint8 *ssid2, gsize len2,
|
2014-07-24 12:53:33 +00:00
|
|
|
gboolean ignore_trailing_null);
|
2014-06-26 13:25:06 +00:00
|
|
|
char * nm_utils_ssid_to_utf8 (const guint8 *ssid, gsize len);
|
2014-07-24 12:53:33 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* NMUtilsSecurityType:
|
|
|
|
* @NMU_SEC_INVALID: unknown or invalid security, placeholder and not used
|
|
|
|
* @NMU_SEC_NONE: unencrypted and open
|
|
|
|
* @NMU_SEC_STATIC_WEP: static WEP keys are used for encryption
|
|
|
|
* @NMU_SEC_LEAP: Cisco LEAP is used for authentication and for generating the
|
|
|
|
* dynamic WEP keys automatically
|
|
|
|
* @NMU_SEC_DYNAMIC_WEP: standard 802.1x is used for authentication and
|
|
|
|
* generating the dynamic WEP keys automatically
|
|
|
|
* @NMU_SEC_WPA_PSK: WPA1 is used with Pre-Shared Keys (PSK)
|
|
|
|
* @NMU_SEC_WPA_ENTERPRISE: WPA1 is used with 802.1x authentication
|
|
|
|
* @NMU_SEC_WPA2_PSK: WPA2/RSN is used with Pre-Shared Keys (PSK)
|
|
|
|
* @NMU_SEC_WPA2_ENTERPRISE: WPA2 is used with 802.1x authentication
|
|
|
|
*
|
|
|
|
* Describes generic security mechanisms that 802.11 access points may offer.
|
|
|
|
* Used with nm_utils_security_valid() for checking whether a given access
|
|
|
|
* point is compatible with a network device.
|
|
|
|
**/
|
|
|
|
typedef enum {
|
|
|
|
NMU_SEC_INVALID = 0,
|
|
|
|
NMU_SEC_NONE,
|
|
|
|
NMU_SEC_STATIC_WEP,
|
|
|
|
NMU_SEC_LEAP,
|
|
|
|
NMU_SEC_DYNAMIC_WEP,
|
|
|
|
NMU_SEC_WPA_PSK,
|
|
|
|
NMU_SEC_WPA_ENTERPRISE,
|
|
|
|
NMU_SEC_WPA2_PSK,
|
|
|
|
NMU_SEC_WPA2_ENTERPRISE
|
|
|
|
} NMUtilsSecurityType;
|
|
|
|
|
|
|
|
gboolean nm_utils_security_valid (NMUtilsSecurityType type,
|
|
|
|
NMDeviceWifiCapabilities wifi_caps,
|
|
|
|
gboolean have_ap,
|
|
|
|
gboolean adhoc,
|
|
|
|
NM80211ApFlags ap_flags,
|
|
|
|
NM80211ApSecurityFlags ap_wpa,
|
|
|
|
NM80211ApSecurityFlags ap_rsn);
|
|
|
|
|
|
|
|
gboolean nm_utils_ap_mode_security_valid (NMUtilsSecurityType type,
|
|
|
|
NMDeviceWifiCapabilities wifi_caps);
|
|
|
|
|
|
|
|
gboolean nm_utils_wep_key_valid (const char *key, NMWepKeyType wep_type);
|
|
|
|
gboolean nm_utils_wpa_psk_valid (const char *psk);
|
|
|
|
|
2016-09-23 08:30:50 +00:00
|
|
|
NM_AVAILABLE_IN_1_6
|
2016-10-14 08:04:11 +00:00
|
|
|
gboolean nm_utils_is_json_object (const char *str, GError **error);
|
2016-09-23 08:30:50 +00:00
|
|
|
|
2014-09-06 21:57:39 +00:00
|
|
|
GVariant *nm_utils_ip4_dns_to_variant (char **dns);
|
|
|
|
char **nm_utils_ip4_dns_from_variant (GVariant *value);
|
2014-10-21 01:30:56 +00:00
|
|
|
GVariant *nm_utils_ip4_addresses_to_variant (GPtrArray *addresses,
|
|
|
|
const char *gateway);
|
|
|
|
GPtrArray *nm_utils_ip4_addresses_from_variant (GVariant *value,
|
|
|
|
char **out_gateway);
|
2014-09-06 21:57:39 +00:00
|
|
|
GVariant *nm_utils_ip4_routes_to_variant (GPtrArray *routes);
|
|
|
|
GPtrArray *nm_utils_ip4_routes_from_variant (GVariant *value);
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
guint32 nm_utils_ip4_netmask_to_prefix (guint32 netmask);
|
|
|
|
guint32 nm_utils_ip4_prefix_to_netmask (guint32 prefix);
|
|
|
|
guint32 nm_utils_ip4_get_default_prefix (guint32 ip);
|
|
|
|
|
2014-09-06 21:57:39 +00:00
|
|
|
GVariant *nm_utils_ip6_dns_to_variant (char **dns);
|
|
|
|
char **nm_utils_ip6_dns_from_variant (GVariant *value);
|
2014-10-21 01:30:56 +00:00
|
|
|
GVariant *nm_utils_ip6_addresses_to_variant (GPtrArray *addresses,
|
|
|
|
const char *gateway);
|
|
|
|
GPtrArray *nm_utils_ip6_addresses_from_variant (GVariant *value,
|
|
|
|
char **out_gateway);
|
2014-09-06 21:57:39 +00:00
|
|
|
GVariant *nm_utils_ip6_routes_to_variant (GPtrArray *routes);
|
|
|
|
GPtrArray *nm_utils_ip6_routes_from_variant (GVariant *value);
|
|
|
|
|
libnm-core, libnm, core: add AddressData and RouteData properties
Add AddressData and RouteData properties to NMSettingIPConfig and
NMIP[46]Config. These are like the existing "addresses" and "routes"
properties, but using strings and containing additional attributes,
like NMIPAddress and NMIPRoute.
This only affects the D-Bus representations; there are no API changes
to NMSettingIP{,4,6}Config or NMIP{4,6}Config as a result of this; the
additional information is just added to the existing 'addresses' and
'routes' properties.
NMSettingIP4Config and NMSettingIP6Config now always generate both
old-style data ('addresses', 'address-labels', 'routes') and new-style
data ('address-data', 'gateway', 'route-data') when serializing to
D-Bus, for backward compatibility. When deserializing, they will fill
in the 'addresses' and 'routes' properties from the new-style data if
it is present (ignoring the old-style data), or from the old-style
data if the new-style isn't present.
The daemon-side NMIP4Config and NMIP6Config always emit changes for
both 'Addresses'/'Routes' and 'AddressData'/'RouteData'. The
libnm-side classes initially listen for changes on both properties,
but start ignoring the 'Addresses' and 'Routes' properties once they
know the daemon is also providing 'AddressData' and 'RouteData'.
2014-10-21 12:33:18 +00:00
|
|
|
GVariant *nm_utils_ip_addresses_to_variant (GPtrArray *addresses);
|
|
|
|
GPtrArray *nm_utils_ip_addresses_from_variant (GVariant *value,
|
|
|
|
int family);
|
|
|
|
GVariant *nm_utils_ip_routes_to_variant (GPtrArray *routes);
|
|
|
|
GPtrArray *nm_utils_ip_routes_from_variant (GVariant *value,
|
|
|
|
int family);
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
char *nm_utils_uuid_generate (void);
|
|
|
|
|
2014-10-30 15:15:44 +00:00
|
|
|
gboolean nm_utils_file_is_certificate (const char *filename);
|
|
|
|
gboolean nm_utils_file_is_private_key (const char *filename, gboolean *out_encrypted);
|
2014-07-24 12:53:33 +00:00
|
|
|
gboolean nm_utils_file_is_pkcs12 (const char *filename);
|
|
|
|
|
2014-11-25 22:01:55 +00:00
|
|
|
typedef gboolean (*NMUtilsFileSearchInPathsPredicate) (const char *filename, gpointer user_data);
|
|
|
|
|
2015-05-28 19:52:24 +00:00
|
|
|
struct stat;
|
|
|
|
|
|
|
|
typedef gboolean (*NMUtilsCheckFilePredicate) (const char *filename, const struct stat *stat, gpointer user_data, GError **error);
|
|
|
|
|
2014-11-25 22:01:55 +00:00
|
|
|
const char *nm_utils_file_search_in_paths (const char *progname,
|
|
|
|
const char *try_first,
|
|
|
|
const char *const *paths,
|
|
|
|
GFileTest file_test_flags,
|
|
|
|
NMUtilsFileSearchInPathsPredicate predicate,
|
|
|
|
gpointer user_data,
|
|
|
|
GError **error);
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
guint32 nm_utils_wifi_freq_to_channel (guint32 freq);
|
|
|
|
guint32 nm_utils_wifi_channel_to_freq (guint32 channel, const char *band);
|
|
|
|
guint32 nm_utils_wifi_find_next_channel (guint32 channel, int direction, char *band);
|
|
|
|
gboolean nm_utils_wifi_is_channel_valid (guint32 channel, const char *band);
|
2015-08-18 07:37:48 +00:00
|
|
|
NM_AVAILABLE_IN_1_2
|
|
|
|
const guint *nm_utils_wifi_2ghz_freqs (void);
|
|
|
|
NM_AVAILABLE_IN_1_2
|
|
|
|
const guint *nm_utils_wifi_5ghz_freqs (void);
|
2014-07-24 12:53:33 +00:00
|
|
|
|
2014-09-19 20:51:07 +00:00
|
|
|
const char *nm_utils_wifi_strength_bars (guint8 strength);
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
/**
|
|
|
|
* NM_UTILS_HWADDR_LEN_MAX:
|
|
|
|
*
|
|
|
|
* The maximum length of hardware addresses handled by NetworkManager itself,
|
|
|
|
* nm_utils_hwaddr_len(), and nm_utils_hwaddr_aton().
|
|
|
|
*/
|
|
|
|
#define NM_UTILS_HWADDR_LEN_MAX 20 /* INFINIBAND_ALEN */
|
|
|
|
|
2014-10-28 12:32:25 +00:00
|
|
|
gsize nm_utils_hwaddr_len (int type) G_GNUC_PURE;
|
|
|
|
|
|
|
|
char *nm_utils_hwaddr_ntoa (gconstpointer addr, gsize length);
|
|
|
|
GByteArray *nm_utils_hwaddr_atoba (const char *asc, gsize length);
|
|
|
|
guint8 *nm_utils_hwaddr_aton (const char *asc, gpointer buffer, gsize length);
|
|
|
|
|
|
|
|
gboolean nm_utils_hwaddr_valid (const char *asc, gssize length);
|
|
|
|
char *nm_utils_hwaddr_canonical (const char *asc, gssize length);
|
|
|
|
gboolean nm_utils_hwaddr_matches (gconstpointer hwaddr1,
|
|
|
|
gssize hwaddr1_len,
|
|
|
|
gconstpointer hwaddr2,
|
|
|
|
gssize hwaddr2_len);
|
2014-07-24 12:53:33 +00:00
|
|
|
|
2014-11-06 23:51:09 +00:00
|
|
|
char *nm_utils_bin2hexstr (gconstpointer src, gsize len, int final_len);
|
|
|
|
GBytes *nm_utils_hexstr2bin (const char *hex);
|
2014-07-24 12:53:33 +00:00
|
|
|
|
|
|
|
gboolean nm_utils_iface_valid_name(const char *name);
|
|
|
|
|
|
|
|
gboolean nm_utils_is_uuid (const char *str);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* NM_UTILS_INET_ADDRSTRLEN:
|
|
|
|
*
|
|
|
|
* Defines the minimal length for a char buffer that is suitable as @dst argument
|
|
|
|
* for both nm_utils_inet4_ntop() and nm_utils_inet6_ntop().
|
|
|
|
**/
|
|
|
|
#define NM_UTILS_INET_ADDRSTRLEN INET6_ADDRSTRLEN
|
|
|
|
const char *nm_utils_inet4_ntop (in_addr_t inaddr, char *dst);
|
|
|
|
const char *nm_utils_inet6_ntop (const struct in6_addr *in6addr, char *dst);
|
|
|
|
|
2014-09-16 20:42:46 +00:00
|
|
|
gboolean nm_utils_ipaddr_valid (int family, const char *ip);
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
gboolean nm_utils_check_virtual_device_compatibility (GType virtual_type, GType other_type);
|
|
|
|
|
2015-01-15 21:42:26 +00:00
|
|
|
NM_AVAILABLE_IN_1_2
|
2014-12-16 17:13:14 +00:00
|
|
|
int nm_utils_bond_mode_string_to_int (const char *mode);
|
2015-01-15 21:42:26 +00:00
|
|
|
NM_AVAILABLE_IN_1_2
|
2014-12-16 17:13:14 +00:00
|
|
|
const char *nm_utils_bond_mode_int_to_string (int mode);
|
|
|
|
|
2015-06-04 13:05:33 +00:00
|
|
|
NM_AVAILABLE_IN_1_2
|
|
|
|
char *nm_utils_enum_to_str (GType type, int value);
|
|
|
|
|
|
|
|
NM_AVAILABLE_IN_1_2
|
|
|
|
gboolean nm_utils_enum_from_str (GType type, const char *str, int *out_value, char **err_token);
|
|
|
|
|
2015-09-06 11:11:11 +00:00
|
|
|
NM_AVAILABLE_IN_1_2
|
|
|
|
const char **nm_utils_enum_get_values (GType type, gint from, gint to);
|
|
|
|
|
2014-07-24 12:53:33 +00:00
|
|
|
G_END_DECLS
|
|
|
|
|
all: fix up multiple-include-guard defines
Previously, src/nm-ip4-config.h, libnm/nm-ip4-config.h, and
libnm-glib/nm-ip4-config.h all used "NM_IP4_CONFIG_H" as an include
guard, which meant that nm-test-utils.h could not tell which of them
was being included (and so, eg, if you tried to include
nm-ip4-config.h in a libnm test, it would fail to compile because
nm-test-utils.h was referring to symbols in src/nm-ip4-config.h).
Fix this by changing the include guards in the non-API-stable parts of
the tree:
- libnm-glib/nm-ip4-config.h remains NM_IP4_CONFIG_H
- libnm/nm-ip4-config.h now uses __NM_IP4_CONFIG_H__
- src/nm-ip4-config.h now uses __NETWORKMANAGER_IP4_CONFIG_H__
And likewise for all other headers.
The two non-"nm"-prefixed headers, libnm/NetworkManager.h and
src/NetworkManagerUtils.h are now __NETWORKMANAGER_H__ and
__NETWORKMANAGER_UTILS_H__ respectively, which, while not entirely
consistent with the general scheme, do still mostly make sense in
isolation.
2014-08-13 18:10:11 +00:00
|
|
|
#endif /* __NM_UTILS_H__ */
|