Blame src/nm-config-data.h

Packit Service b23acc
// SPDX-License-Identifier: GPL-2.0+
Packit Service b23acc
/*
Packit Service b23acc
 * Copyright (C) 2014 Red Hat, Inc.
Packit Service b23acc
 */
Packit Service b23acc
Packit Service b23acc
#ifndef NM_CONFIG_DATA_H
Packit Service b23acc
#define NM_CONFIG_DATA_H
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
typedef enum {
Packit Service b23acc
Packit Service b23acc
	/* an invalid mode. */
Packit Service b23acc
	NM_AUTH_POLKIT_MODE_UNKNOWN,
Packit Service b23acc
Packit Service b23acc
	/* don't use PolicyKit, but only allow root user (uid 0). */
Packit Service b23acc
	NM_AUTH_POLKIT_MODE_ROOT_ONLY,
Packit Service b23acc
Packit Service b23acc
	/* don't use PolicyKit, but allow all requests. */
Packit Service b23acc
	NM_AUTH_POLKIT_MODE_ALLOW_ALL,
Packit Service b23acc
Packit Service b23acc
	/* use PolicyKit to authorize requests. Root user (uid 0) always
Packit Service b23acc
	 * gets a free pass, without consulting PolicyKit. If PolicyKit is not
Packit Service b23acc
	 * running, authorization will fail for non root users. */
Packit Service b23acc
	NM_AUTH_POLKIT_MODE_USE_POLKIT,
Packit Service b23acc
Packit Service b23acc
} NMAuthPolkitMode;
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
#define NM_TYPE_CONFIG_DATA            (nm_config_data_get_type ())
Packit Service b23acc
#define NM_CONFIG_DATA(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj), NM_TYPE_CONFIG_DATA, NMConfigData))
Packit Service b23acc
#define NM_CONFIG_DATA_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass),  NM_TYPE_CONFIG_DATA, NMConfigDataClass))
Packit Service b23acc
#define NM_IS_CONFIG_DATA(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj), NM_TYPE_CONFIG_DATA))
Packit Service b23acc
#define NM_IS_CONFIG_DATA_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass),  NM_TYPE_CONFIG_DATA))
Packit Service b23acc
#define NM_CONFIG_DATA_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS ((obj),  NM_TYPE_CONFIG_DATA, NMConfigDataClass))
Packit Service b23acc
Packit Service b23acc
#define NM_CONFIG_DATA_CONFIG_MAIN_FILE      "config-main-file"
Packit Service b23acc
#define NM_CONFIG_DATA_CONFIG_DESCRIPTION    "config-description"
Packit Service b23acc
#define NM_CONFIG_DATA_KEYFILE_USER          "keyfile-user"
Packit Service b23acc
#define NM_CONFIG_DATA_KEYFILE_INTERN        "keyfile-intern"
Packit Service b23acc
#define NM_CONFIG_DATA_CONNECTIVITY_ENABLED  "connectivity-enabled"
Packit Service b23acc
#define NM_CONFIG_DATA_CONNECTIVITY_URI      "connectivity-uri"
Packit Service b23acc
#define NM_CONFIG_DATA_CONNECTIVITY_INTERVAL "connectivity-interval"
Packit Service b23acc
#define NM_CONFIG_DATA_CONNECTIVITY_RESPONSE "connectivity-response"
Packit Service b23acc
#define NM_CONFIG_DATA_NO_AUTO_DEFAULT       "no-auto-default"
Packit Service b23acc
#define NM_CONFIG_DATA_DNS_MODE              "dns"
Packit Service b23acc
Packit Service b23acc
typedef enum { /*< flags >*/
Packit Service b23acc
	NM_CONFIG_GET_VALUE_NONE                   = 0,
Packit Service b23acc
Packit Service b23acc
	/* use g_key_file_get_value() instead of g_key_file_get_string(). */
Packit Service b23acc
	NM_CONFIG_GET_VALUE_RAW                    = (1LL << 0),
Packit Service b23acc
Packit Service b23acc
	/* strip whitespaces */
Packit Service b23acc
	NM_CONFIG_GET_VALUE_STRIP                  = (1LL << 1),
Packit Service b23acc
Packit Service b23acc
	/* if the returned string would be the empty word, return NULL. */
Packit Service b23acc
	NM_CONFIG_GET_VALUE_NO_EMPTY               = (1LL << 2),
Packit Service b23acc
Packit Service b23acc
	/* special flag to read device spec. You want to use this before passing the
Packit Service b23acc
	 * value to nm_match_spec_split(). */
Packit Service b23acc
	NM_CONFIG_GET_VALUE_TYPE_SPEC              = NM_CONFIG_GET_VALUE_RAW,
Packit Service b23acc
} NMConfigGetValueFlags;
Packit Service b23acc
Packit Service b23acc
typedef enum { /*< flags >*/
Packit Service b23acc
	NM_CONFIG_CHANGE_NONE                      = 0,
Packit Service b23acc
Packit Service b23acc
	/**************************************************************************
Packit Service b23acc
	 * The external cause which triggered the reload/configuration-change
Packit Service b23acc
	 *************************************************************************/
Packit Service b23acc
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_SIGHUP              = (1L << 0),
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_SIGUSR1             = (1L << 1),
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_SIGUSR2             = (1L << 2),
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_NO_AUTO_DEFAULT     = (1L << 3),
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_SET_VALUES          = (1L << 4),
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_CONF                = (1L << 5),
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_DNS_RC              = (1L << 6),
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSE_DNS_FULL            = (1L << 7),
Packit Service b23acc
Packit Service b23acc
	NM_CONFIG_CHANGE_CAUSES                    = ((1L << 8) - 1),
Packit Service b23acc
Packit Service b23acc
	/**************************************************************************
Packit Service b23acc
	 * Following flags describe which property of the configuration changed:
Packit Service b23acc
	 *************************************************************************/
Packit Service b23acc
Packit Service b23acc
	/* main-file or config-description changed */
Packit Service b23acc
	NM_CONFIG_CHANGE_CONFIG_FILES              = (1L << 10),
Packit Service b23acc
Packit Service b23acc
	/* any configuration on disk changed */
Packit Service b23acc
	NM_CONFIG_CHANGE_VALUES                    = (1L << 11),
Packit Service b23acc
Packit Service b23acc
	/* any user configuration on disk changed (NetworkManager.conf) */
Packit Service b23acc
	NM_CONFIG_CHANGE_VALUES_USER               = (1L << 12),
Packit Service b23acc
Packit Service b23acc
	/* any internal configuration on disk changed (NetworkManager-intern.conf) */
Packit Service b23acc
	NM_CONFIG_CHANGE_VALUES_INTERN             = (1L << 13),
Packit Service b23acc
Packit Service b23acc
	/* configuration regarding connectivity changed */
Packit Service b23acc
	NM_CONFIG_CHANGE_CONNECTIVITY              = (1L << 14),
Packit Service b23acc
Packit Service b23acc
	/* configuration regarding no-auto-default changed */
Packit Service b23acc
	NM_CONFIG_CHANGE_NO_AUTO_DEFAULT           = (1L << 15),
Packit Service b23acc
Packit Service b23acc
	/* configuration regarding dns-mode changed */
Packit Service b23acc
	NM_CONFIG_CHANGE_DNS_MODE                  = (1L << 16),
Packit Service b23acc
Packit Service b23acc
	/* configuration regarding rc-manager changed */
Packit Service b23acc
	NM_CONFIG_CHANGE_RC_MANAGER                = (1L << 17),
Packit Service b23acc
Packit Service b23acc
	/* configuration regarding global dns-config changed */
Packit Service b23acc
	NM_CONFIG_CHANGE_GLOBAL_DNS_CONFIG         = (1L << 18),
Packit Service b23acc
Packit Service b23acc
} NMConfigChangeFlags;
Packit Service b23acc
Packit Service b23acc
typedef struct _NMConfigDataClass NMConfigDataClass;
Packit Service b23acc
Packit Service b23acc
typedef struct _NMGlobalDnsConfig NMGlobalDnsConfig;
Packit Service b23acc
typedef struct _NMGlobalDnsDomain NMGlobalDnsDomain;
Packit Service b23acc
Packit Service b23acc
GType nm_config_data_get_type (void);
Packit Service b23acc
Packit Service b23acc
NMConfigData *nm_config_data_new (const char *config_main_file,
Packit Service b23acc
                                  const char *config_description,
Packit Service b23acc
                                  const char *const*no_auto_default,
Packit Service b23acc
                                  GKeyFile *keyfile_user,
Packit Service b23acc
                                  GKeyFile *keyfile_intern);
Packit Service b23acc
NMConfigData *nm_config_data_new_update_keyfile_intern (const NMConfigData *base, GKeyFile *keyfile_intern);
Packit Service b23acc
NMConfigData *nm_config_data_new_update_no_auto_default (const NMConfigData *base, const char *const*no_auto_default);
Packit Service b23acc
Packit Service b23acc
NMConfigChangeFlags nm_config_data_diff (NMConfigData *old_data, NMConfigData *new_data);
Packit Service b23acc
Packit Service b23acc
void nm_config_data_log (const NMConfigData *self,
Packit Service b23acc
                         const char *prefix,
Packit Service b23acc
                         const char *key_prefix,
Packit Service b23acc
                         const char *no_auto_default_file,
Packit Service b23acc
                         /* FILE* */ gpointer print_stream);
Packit Service b23acc
Packit Service b23acc
const char *nm_config_data_get_config_main_file (const NMConfigData *config_data);
Packit Service b23acc
const char *nm_config_data_get_config_description (const NMConfigData *config_data);
Packit Service b23acc
Packit Service b23acc
gboolean nm_config_data_has_group (const NMConfigData *self, const char *group);
Packit Service b23acc
gboolean nm_config_data_has_value (const NMConfigData *self, const char *group, const char *key, NMConfigGetValueFlags flags);
Packit Service b23acc
char *nm_config_data_get_value (const NMConfigData *config_data, const char *group, const char *key, NMConfigGetValueFlags flags);
Packit Service b23acc
int nm_config_data_get_value_boolean (const NMConfigData *self, const char *group, const char *key, int default_value);
Packit Service b23acc
gint64 nm_config_data_get_value_int64 (const NMConfigData *self, const char *group, const char *key, guint base, gint64 min, gint64 max, gint64 fallback);
Packit Service b23acc
Packit Service b23acc
char **nm_config_data_get_plugins (const NMConfigData *config_data, gboolean allow_default);
Packit Service b23acc
gboolean nm_config_data_get_connectivity_enabled (const NMConfigData *config_data);
Packit Service b23acc
const char *nm_config_data_get_connectivity_uri (const NMConfigData *config_data);
Packit Service b23acc
guint nm_config_data_get_connectivity_interval (const NMConfigData *config_data);
Packit Service b23acc
const char *nm_config_data_get_connectivity_response (const NMConfigData *config_data);
Packit Service b23acc
Packit Service b23acc
int nm_config_data_get_autoconnect_retries_default (const NMConfigData *config_data);
Packit Service b23acc
Packit Service b23acc
NMAuthPolkitMode nm_config_data_get_main_auth_polkit (const NMConfigData *config_data);
Packit Service b23acc
Packit Service b23acc
const char *const*nm_config_data_get_no_auto_default (const NMConfigData *config_data);
Packit Service b23acc
gboolean          nm_config_data_get_no_auto_default_for_device (const NMConfigData *self, NMDevice *device);
Packit Service b23acc
Packit Service b23acc
const char *nm_config_data_get_dns_mode (const NMConfigData *self);
Packit Service b23acc
const char *nm_config_data_get_rc_manager (const NMConfigData *self);
Packit Service b23acc
gboolean nm_config_data_get_systemd_resolved (const NMConfigData *self);
Packit Service b23acc
Packit Service b23acc
gboolean nm_config_data_get_ignore_carrier (const NMConfigData *self, NMDevice *device);
Packit Service b23acc
gboolean nm_config_data_get_assume_ipv6ll_only (const NMConfigData *self, NMDevice *device);
Packit Service b23acc
int      nm_config_data_get_sriov_num_vfs (const NMConfigData *self, NMDevice *device);
Packit Service b23acc
Packit Service b23acc
NMGlobalDnsConfig *nm_config_data_get_global_dns_config (const NMConfigData *self);
Packit Service b23acc
Packit Service b23acc
extern const char *__start_connection_defaults[];
Packit Service b23acc
extern const char *__stop_connection_defaults[];
Packit Service b23acc
Packit Service b23acc
#define NM_CON_DEFAULT_NOP(name) \
Packit Service b23acc
	static const char *NM_UNIQ_T (connection_default, NM_UNIQ) \
Packit Service b23acc
		_nm_used _nm_section ("connection_defaults") = "" name
Packit Service b23acc
Packit Service b23acc
#define NM_CON_DEFAULT(name) \
Packit Service b23acc
	({ \
Packit Service b23acc
		static const char *__con_default_prop \
Packit Service b23acc
			_nm_used _nm_section ("connection_defaults") = "" name; \
Packit Service b23acc
		\
Packit Service b23acc
		name; \
Packit Service b23acc
	})
Packit Service b23acc
Packit Service b23acc
char *nm_config_data_get_connection_default (const NMConfigData *self,
Packit Service b23acc
                                             const char *property,
Packit Service b23acc
                                             NMDevice *device);
Packit Service b23acc
Packit Service b23acc
gint64 nm_config_data_get_connection_default_int64 (const NMConfigData *self,
Packit Service b23acc
                                                    const char *property,
Packit Service b23acc
                                                    NMDevice *device,
Packit Service b23acc
                                                    gint64 min,
Packit Service b23acc
                                                    gint64 max,
Packit Service b23acc
                                                    gint64 fallback);
Packit Service b23acc
Packit Service b23acc
char *nm_config_data_get_device_config (const NMConfigData *self,
Packit Service b23acc
                                        const char *property,
Packit Service b23acc
                                        NMDevice *device,
Packit Service b23acc
                                        gboolean *has_match);
Packit Service b23acc
Packit Service b23acc
char *nm_config_data_get_device_config_by_pllink (const NMConfigData *self,
Packit Service b23acc
                                                  const char *property,
Packit Service b23acc
                                                  const NMPlatformLink *pllink,
Packit Service b23acc
                                                  const char *match_device_type,
Packit Service b23acc
                                                  gboolean *has_match);
Packit Service b23acc
Packit Service b23acc
gboolean nm_config_data_get_device_config_boolean (const NMConfigData *self,
Packit Service b23acc
                                                   const char *property,
Packit Service b23acc
                                                   NMDevice *device,
Packit Service b23acc
                                                   int val_no_match,
Packit Service b23acc
                                                   int val_invalid);
Packit Service b23acc
Packit Service b23acc
char **nm_config_data_get_groups (const NMConfigData *self);
Packit Service b23acc
char **nm_config_data_get_keys (const NMConfigData *self, const char *group);
Packit Service b23acc
gboolean nm_config_data_is_intern_atomic_group (const NMConfigData *self, const char *group);
Packit Service b23acc
Packit Service b23acc
GKeyFile *nm_config_data_clone_keyfile_intern (const NMConfigData *self);
Packit Service b23acc
Packit Service b23acc
const char *const *nm_global_dns_config_get_searches (const NMGlobalDnsConfig *dns_config);
Packit Service b23acc
const char *const *nm_global_dns_config_get_options (const NMGlobalDnsConfig *dns_config);
Packit Service b23acc
guint nm_global_dns_config_get_num_domains (const NMGlobalDnsConfig *dns_config);
Packit Service b23acc
NMGlobalDnsDomain *nm_global_dns_config_get_domain (const NMGlobalDnsConfig *dns_config, guint i);
Packit Service b23acc
NMGlobalDnsDomain *nm_global_dns_config_lookup_domain (const NMGlobalDnsConfig *dns_config, const char *name);
Packit Service b23acc
const char *nm_global_dns_domain_get_name (const NMGlobalDnsDomain *domain);
Packit Service b23acc
const char *const *nm_global_dns_domain_get_servers (const NMGlobalDnsDomain *domain);
Packit Service b23acc
const char *const *nm_global_dns_domain_get_options (const NMGlobalDnsDomain *domain);
Packit Service b23acc
gboolean nm_global_dns_config_is_internal (const NMGlobalDnsConfig *dns_config);
Packit Service b23acc
gboolean nm_global_dns_config_is_empty (const NMGlobalDnsConfig *dns_config);
Packit Service b23acc
void nm_global_dns_config_update_checksum (const NMGlobalDnsConfig *dns_config, GChecksum *sum);
Packit Service b23acc
void nm_global_dns_config_free (NMGlobalDnsConfig *dns_config);
Packit Service b23acc
Packit Service b23acc
NMGlobalDnsConfig *nm_global_dns_config_from_dbus (const GValue *value, GError **error);
Packit Service b23acc
void nm_global_dns_config_to_dbus (const NMGlobalDnsConfig *dns_config, GValue *value);
Packit Service b23acc
Packit Service b23acc
void nm_config_data_get_warnings (const NMConfigData *self,
Packit Service b23acc
                                  GPtrArray *warnings);
Packit Service b23acc
Packit Service b23acc
/* private accessors */
Packit Service b23acc
GKeyFile *_nm_config_data_get_keyfile (const NMConfigData *self);
Packit Service b23acc
GKeyFile *_nm_config_data_get_keyfile_user (const NMConfigData *self);
Packit Service b23acc
GKeyFile *_nm_config_data_get_keyfile_intern (const NMConfigData *self);
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
/* nm-config-data.c requires getting the DHCP manager's configuration. That is a bit
Packit Service b23acc
 * ugly, and optimally, NMConfig* is independent of NMDhcpManager. Instead of
Packit Service b23acc
 * including the header, forward declare the two functions that we need. */
Packit Service b23acc
struct _NMDhcpManager;
Packit Service b23acc
struct _NMDhcpManager *nm_dhcp_manager_get (void);
Packit Service b23acc
const char *nm_dhcp_manager_get_config (struct _NMDhcpManager *self);
Packit Service b23acc
Packit Service b23acc
#endif /* NM_CONFIG_DATA_H */
Packit Service b23acc