/* SPDX-License-Identifier: GPL-2.0+ */ /* * Copyright (C) 2011 Red Hat, Inc. * Copyright (C) 2013 Thomas Bechtold */ #ifndef __NETWORKMANAGER_CONFIG_H__ #define __NETWORKMANAGER_CONFIG_H__ #include "nm-config-data.h" #define NM_TYPE_CONFIG (nm_config_get_type()) #define NM_CONFIG(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), NM_TYPE_CONFIG, NMConfig)) #define NM_CONFIG_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), NM_TYPE_CONFIG, NMConfigClass)) #define NM_IS_CONFIG(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), NM_TYPE_CONFIG)) #define NM_IS_CONFIG_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), NM_TYPE_CONFIG)) #define NM_CONFIG_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), NM_TYPE_CONFIG, NMConfigClass)) /* Properties */ #define NM_CONFIG_CMD_LINE_OPTIONS "cmd-line-options" #define NM_CONFIG_ATOMIC_SECTION_PREFIXES "atomic-section-prefixes" /* Signals */ #define NM_CONFIG_SIGNAL_CONFIG_CHANGED "config-changed" #define NM_CONFIG_DEFAULT_CONNECTIVITY_INTERVAL 300 #define NM_CONFIG_DEFAULT_CONNECTIVITY_RESPONSE "NetworkManager is online" /* NOT LOCALIZED */ #define NM_CONFIG_KEYFILE_LIST_SEPARATOR ',' #define NM_CONFIG_KEYFILE_GROUPPREFIX_INTERN ".intern." #define NM_CONFIG_KEYFILE_GROUPPREFIX_CONNECTION "connection" #define NM_CONFIG_KEYFILE_GROUPPREFIX_DEVICE "device" #define NM_CONFIG_KEYFILE_GROUPPREFIX_GLOBAL_DNS_DOMAIN "global-dns-domain-" #define NM_CONFIG_KEYFILE_GROUPPREFIX_TEST_APPEND_STRINGLIST ".test-append-stringlist" #define NM_CONFIG_KEYFILE_GROUP_MAIN "main" #define NM_CONFIG_KEYFILE_GROUP_LOGGING "logging" #define NM_CONFIG_KEYFILE_GROUP_CONNECTIVITY "connectivity" #define NM_CONFIG_KEYFILE_GROUP_KEYFILE "keyfile" #define NM_CONFIG_KEYFILE_GROUP_IFUPDOWN "ifupdown" #define NM_CONFIG_KEYFILE_GROUP_GLOBAL_DNS "global-dns" #define NM_CONFIG_KEYFILE_GROUP_CONFIG ".config" #define NM_CONFIG_KEYFILE_KEY_MAIN_ASSUME_IPV6LL_ONLY "assume-ipv6ll-only" #define NM_CONFIG_KEYFILE_KEY_MAIN_AUTH_POLKIT "auth-polkit" #define NM_CONFIG_KEYFILE_KEY_MAIN_AUTOCONNECT_RETRIES_DEFAULT "autoconnect-retries-default" #define NM_CONFIG_KEYFILE_KEY_MAIN_CONFIGURE_AND_QUIT "configure-and-quit" #define NM_CONFIG_KEYFILE_KEY_MAIN_DEBUG "debug" #define NM_CONFIG_KEYFILE_KEY_MAIN_DHCP "dhcp" #define NM_CONFIG_KEYFILE_KEY_MAIN_DNS "dns" #define NM_CONFIG_KEYFILE_KEY_MAIN_HOSTNAME_MODE "hostname-mode" #define NM_CONFIG_KEYFILE_KEY_MAIN_IGNORE_CARRIER "ignore-carrier" #define NM_CONFIG_KEYFILE_KEY_MAIN_MONITOR_CONNECTION_FILES "monitor-connection-files" #define NM_CONFIG_KEYFILE_KEY_MAIN_NO_AUTO_DEFAULT "no-auto-default" #define NM_CONFIG_KEYFILE_KEY_MAIN_PLUGINS "plugins" #define NM_CONFIG_KEYFILE_KEY_MAIN_RC_MANAGER "rc-manager" #define NM_CONFIG_KEYFILE_KEY_MAIN_SLAVES_ORDER "slaves-order" #define NM_CONFIG_KEYFILE_KEY_MAIN_SYSTEMD_RESOLVED "systemd-resolved" #define NM_CONFIG_KEYFILE_KEY_LOGGING_AUDIT "audit" #define NM_CONFIG_KEYFILE_KEY_LOGGING_BACKEND "backend" #define NM_CONFIG_KEYFILE_KEY_LOGGING_DOMAINS "domains" #define NM_CONFIG_KEYFILE_KEY_LOGGING_LEVEL "level" #define NM_CONFIG_KEYFILE_KEY_CONNECTIVITY_ENABLED "enabled" #define NM_CONFIG_KEYFILE_KEY_CONNECTIVITY_INTERVAL "interval" #define NM_CONFIG_KEYFILE_KEY_CONNECTIVITY_RESPONSE "response" #define NM_CONFIG_KEYFILE_KEY_CONNECTIVITY_URI "uri" #define NM_CONFIG_KEYFILE_KEY_KEYFILE_PATH "path" #define NM_CONFIG_KEYFILE_KEY_KEYFILE_UNMANAGED_DEVICES "unmanaged-devices" #define NM_CONFIG_KEYFILE_KEY_KEYFILE_HOSTNAME "hostname" #define NM_CONFIG_KEYFILE_KEY_IFUPDOWN_MANAGED "managed" #define NM_CONFIG_KEYFILE_KEY_GLOBAL_DNS_SEARCHES "searches" #define NM_CONFIG_KEYFILE_KEY_GLOBAL_DNS_OPTIONS "options" #define NM_CONFIG_KEYFILE_KEY_GLOBAL_DNS_DOMAIN_SERVERS "servers" #define NM_CONFIG_KEYFILE_KEY_GLOBAL_DNS_DOMAIN_OPTIONS "options" #define NM_CONFIG_KEYFILE_KEY_DEVICE_MANAGED "managed" #define NM_CONFIG_KEYFILE_KEY_DEVICE_IGNORE_CARRIER "ignore-carrier" #define NM_CONFIG_KEYFILE_KEY_DEVICE_SRIOV_NUM_VFS "sriov-num-vfs" #define NM_CONFIG_KEYFILE_KEY_DEVICE_WIFI_BACKEND "wifi.backend" #define NM_CONFIG_KEYFILE_KEY_DEVICE_WIFI_SCAN_RAND_MAC_ADDRESS "wifi.scan-rand-mac-address" #define NM_CONFIG_KEYFILE_KEY_DEVICE_CARRIER_WAIT_TIMEOUT "carrier-wait-timeout" #define NM_CONFIG_KEYFILE_KEY_MATCH_DEVICE "match-device" #define NM_CONFIG_KEYFILE_KEY_STOP_MATCH "stop-match" #define NM_CONFIG_KEYFILE_KEY_ATOMIC_SECTION_WAS ".was" /* check-config-options skip */ #define NM_CONFIG_KEYFILE_KEY_CONFIG_ENABLE "enable" /* check-config-options skip */ #define NM_CONFIG_KEYFILE_KEYPREFIX_WAS ".was." #define NM_CONFIG_KEYFILE_KEYPREFIX_SET ".set." #define NM_CONFIG_KEYFILE_GROUP_INTERN_GLOBAL_DNS \ NM_CONFIG_KEYFILE_GROUPPREFIX_INTERN NM_CONFIG_KEYFILE_GROUP_GLOBAL_DNS #define NM_CONFIG_KEYFILE_GROUPPREFIX_INTERN_GLOBAL_DNS_DOMAIN \ NM_CONFIG_KEYFILE_GROUPPREFIX_INTERN NM_CONFIG_KEYFILE_GROUPPREFIX_GLOBAL_DNS_DOMAIN typedef struct NMConfigCmdLineOptions NMConfigCmdLineOptions; typedef enum { NM_CONFIG_STATE_PROPERTY_NONE, /* 1 set-argument: (gboolean enabled) */ NM_CONFIG_STATE_PROPERTY_NETWORKING_ENABLED, NM_CONFIG_STATE_PROPERTY_WIFI_ENABLED, NM_CONFIG_STATE_PROPERTY_WWAN_ENABLED, } NMConfigRunStatePropertyType; typedef enum { NM_CONFIG_CONFIGURE_AND_QUIT_INVALID = -1, NM_CONFIG_CONFIGURE_AND_QUIT_DISABLED = FALSE, NM_CONFIG_CONFIGURE_AND_QUIT_ENABLED = TRUE, NM_CONFIG_CONFIGURE_AND_QUIT_INITRD, } NMConfigConfigureAndQuitType; typedef struct { bool net_enabled; bool wifi_enabled; bool wwan_enabled; /* Whether the runstate is modified and not saved to disk. */ bool dirty; } NMConfigState; typedef struct _NMConfigClass NMConfigClass; GType nm_config_get_type(void); NMConfig *nm_config_get(void); const char *nm_config_change_flags_to_string(NMConfigChangeFlags flags, char *buf, gsize len); NMConfigData *nm_config_get_data(NMConfig *config); NMConfigData *nm_config_get_data_orig(NMConfig *config); #define NM_CONFIG_GET_DATA (nm_config_get_data(nm_config_get())) #define NM_CONFIG_GET_DATA_ORIG (nm_config_get_data_orig(nm_config_get())) const char * nm_config_get_log_level(NMConfig *config); const char * nm_config_get_log_domains(NMConfig *config); NMConfigConfigureAndQuitType nm_config_get_configure_and_quit(NMConfig *config); gboolean nm_config_get_is_debug(NMConfig *config); gboolean nm_config_get_first_start(NMConfig *config); const char *nm_config_get_no_auto_default_file(NMConfig *config); void nm_config_set_values(NMConfig *self, GKeyFile *keyfile_intern_new, gboolean allow_write, gboolean force_rewrite); /* for main.c only */ NMConfigCmdLineOptions *nm_config_cmd_line_options_new(gboolean first_start); void nm_config_cmd_line_options_free(NMConfigCmdLineOptions *cli); void nm_config_cmd_line_options_add_to_entries(NMConfigCmdLineOptions *cli, GOptionContext * opt_ctx); gboolean nm_config_get_no_auto_default_for_device(NMConfig *config, NMDevice *device); void nm_config_set_no_auto_default_for_device(NMConfig *config, NMDevice *device); NMConfig * nm_config_new(const NMConfigCmdLineOptions *cli, char **atomic_section_prefixes, GError **error); NMConfig * nm_config_setup(const NMConfigCmdLineOptions *cli, char **atomic_section_prefixes, GError **error); void nm_config_reload(NMConfig *config, NMConfigChangeFlags reload_flags, gboolean emit_warnings); const NMConfigState *nm_config_state_get(NMConfig *config); void _nm_config_state_set(NMConfig *config, gboolean allow_persist, gboolean force_persist, ...); #define nm_config_state_set(config, allow_persist, force_persist, ...) \ _nm_config_state_set(config, allow_persist, force_persist, ##__VA_ARGS__, 0) int nm_config_parse_boolean(const char *str, int default_value); GKeyFile *nm_config_create_keyfile(void); int nm_config_keyfile_get_boolean(const GKeyFile *keyfile, const char * section, const char * key, int default_value); gint64 nm_config_keyfile_get_int64(const GKeyFile *keyfile, const char * section, const char * key, guint base, gint64 min, gint64 max, gint64 fallback); char * nm_config_keyfile_get_value(const GKeyFile * keyfile, const char * section, const char * key, NMConfigGetValueFlags flags); void nm_config_keyfile_set_string_list(GKeyFile * keyfile, const char * group, const char * key, const char *const *strv, gssize len); gboolean nm_config_keyfile_has_global_dns_config(GKeyFile *keyfile, gboolean internal); GSList *nm_config_get_match_spec(const GKeyFile *keyfile, const char * group, const char * key, gboolean * out_has_key); void _nm_config_sort_groups(char **groups, gsize ngroups); gboolean nm_config_set_global_dns(NMConfig *self, NMGlobalDnsConfig *global_dns, GError **error); void nm_config_set_connectivity_check_enabled(NMConfig *self, gboolean enabled); /* internal defines ... */ extern guint _nm_config_match_nm_version; extern char *_nm_config_match_env; /*****************************************************************************/ #define NM_CONFIG_DEVICE_STATE_DIR "" NMRUNDIR "/devices" #define NM_CONFIG_DEFAULT_LOGGING_AUDIT_BOOL (nm_streq("" NM_CONFIG_DEFAULT_LOGGING_AUDIT, "true")) typedef enum { NM_CONFIG_DEVICE_STATE_MANAGED_TYPE_UNKNOWN = -1, NM_CONFIG_DEVICE_STATE_MANAGED_TYPE_UNMANAGED = 0, NM_CONFIG_DEVICE_STATE_MANAGED_TYPE_MANAGED = 1, } NMConfigDeviceStateManagedType; struct _NMConfigDeviceStateData { int ifindex; NMConfigDeviceStateManagedType managed; /* a value of zero means that no metric is set. */ guint32 route_metric_default_aspired; guint32 route_metric_default_effective; /* the UUID of the last settings-connection active * on the device. */ const char *connection_uuid; const char *perm_hw_addr_fake; /* whether the device was nm-owned (0/1) or -1 for * non-software devices. */ NMTernary nm_owned : 3; }; NMConfigDeviceStateData *nm_config_device_state_load(int ifindex); GHashTable * nm_config_device_state_load_all(void); gboolean nm_config_device_state_write(int ifindex, NMConfigDeviceStateManagedType managed, const char * perm_hw_addr_fake, const char * connection_uuid, NMTernary nm_owned, guint32 route_metric_default_aspired, guint32 route_metric_default_effective, const char * next_server, const char * root_path); void nm_config_device_state_prune_stale(GHashTable *preserve_ifindexes, NMPlatform *preserve_in_platform); const GHashTable * nm_config_device_state_get_all(NMConfig *self); const NMConfigDeviceStateData *nm_config_device_state_get(NMConfig *self, int ifindex); const char *const *nm_config_get_warnings(NMConfig *config); void nm_config_clear_warnings(NMConfig *config); /*****************************************************************************/ #endif /* __NETWORKMANAGER_CONFIG_H__ */