Blame src/nm-config-data.h

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