/* SPDX-License-Identifier: GPL-2.0-or-later */ /* * Copyright (C) 2010 - 2022 Red Hat, Inc. */ #include "libnm-client-aux-extern/nm-default-client.h" #include "connections.h" #include #include #include #include #if HAVE_EDITLINE_READLINE #include #else #include #include #endif #include #include #include "libnm-glib-aux/nm-dbus-aux.h" #include "libnmc-base/nm-client-utils.h" #include "libnmc-base/nm-vpn-helpers.h" #include "libnmc-setting/nm-meta-setting-access.h" #include "libnmc-base/nm-secret-agent-simple.h" #include "utils.h" #include "common.h" #include "settings.h" #include "devices.h" #include "polkit-agent.h" /*****************************************************************************/ typedef enum { PROPERTY_INF_FLAG_NONE = 0x0, PROPERTY_INF_FLAG_DISABLED = 0x1, /* Don't ask due to runtime decision. */ PROPERTY_INF_FLAG_ENABLED = 0x2, /* Override NM_META_PROPERTY_INF_FLAG_DONT_ASK due to runtime decision. */ PROPERTY_INF_FLAG_ALL = 0x3, } PropertyInfFlags; typedef char *(*CompEntryFunc)(const char *, int); typedef struct _OptionInfo { const NMMetaSettingInfoEditor *setting_info; const char *property; const char *option; gboolean (*check_and_set)(NmCli *nmc, NMConnection *connection, const struct _OptionInfo *option, const char *value, gboolean allow_reset, GError **error); CompEntryFunc generator_func; } OptionInfo; /* define some prompts for connection editor */ #define EDITOR_PROMPT_SETTING _("Setting name? ") #define EDITOR_PROMPT_PROPERTY _("Property name? ") #define EDITOR_PROMPT_CON_TYPE _("Enter connection type: ") /* define some other prompts */ #define PROMPT_CONNECTION _("Connection (name, UUID, or path): ") #define PROMPT_VPN_CONNECTION _("VPN connection (name, UUID, or path): ") #define PROMPT_CONNECTIONS _("Connection(s) (name, UUID, or path): ") #define PROMPT_ACTIVE_CONNECTIONS _("Connection(s) (name, UUID, path or apath): ") #define BASE_PROMPT "nmcli> " /*****************************************************************************/ static NM_UTILS_LOOKUP_STR_DEFINE( active_connection_state_to_string, NMActiveConnectionState, NM_UTILS_LOOKUP_DEFAULT(N_("unknown")), NM_UTILS_LOOKUP_ITEM(NM_ACTIVE_CONNECTION_STATE_ACTIVATING, N_("activating")), NM_UTILS_LOOKUP_ITEM(NM_ACTIVE_CONNECTION_STATE_ACTIVATED, N_("activated")), NM_UTILS_LOOKUP_ITEM(NM_ACTIVE_CONNECTION_STATE_DEACTIVATING, N_("deactivating")), NM_UTILS_LOOKUP_ITEM(NM_ACTIVE_CONNECTION_STATE_DEACTIVATED, N_("deactivated")), NM_UTILS_LOOKUP_ITEM_IGNORE(NM_ACTIVE_CONNECTION_STATE_UNKNOWN), ); static NM_UTILS_LOOKUP_STR_DEFINE( vpn_connection_state_to_string, NMVpnConnectionState, NM_UTILS_LOOKUP_DEFAULT(N_("unknown")), NM_UTILS_LOOKUP_ITEM(NM_VPN_CONNECTION_STATE_PREPARE, N_("VPN connecting (prepare)")), NM_UTILS_LOOKUP_ITEM(NM_VPN_CONNECTION_STATE_NEED_AUTH, N_("VPN connecting (need authentication)")), NM_UTILS_LOOKUP_ITEM(NM_VPN_CONNECTION_STATE_CONNECT, N_("VPN connecting")), NM_UTILS_LOOKUP_ITEM(NM_VPN_CONNECTION_STATE_IP_CONFIG_GET, N_("VPN connecting (getting IP configuration)")), NM_UTILS_LOOKUP_ITEM(NM_VPN_CONNECTION_STATE_ACTIVATED, N_("VPN connected")), NM_UTILS_LOOKUP_ITEM(NM_VPN_CONNECTION_STATE_FAILED, N_("VPN connection failed")), NM_UTILS_LOOKUP_ITEM(NM_VPN_CONNECTION_STATE_DISCONNECTED, N_("VPN disconnected")), NM_UTILS_LOOKUP_ITEM_IGNORE(NM_VPN_CONNECTION_STATE_UNKNOWN), ); /*****************************************************************************/ typedef struct { NmCli *nmc; char *orig_id; char *orig_uuid; char *new_id; } AddConnectionInfo; static AddConnectionInfo * _add_connection_info_new(NmCli *nmc, NMConnection *orig_connection, NMConnection *new_connection) { AddConnectionInfo *info; info = g_slice_new(AddConnectionInfo); *info = (AddConnectionInfo){ .nmc = nmc, .orig_id = orig_connection ? g_strdup(nm_connection_get_id(orig_connection)) : NULL, .orig_uuid = orig_connection ? g_strdup(nm_connection_get_uuid(orig_connection)) : NULL, .new_id = g_strdup(nm_connection_get_id(new_connection)), }; return info; } static void _add_connection_info_free(AddConnectionInfo *info) { g_free(info->orig_id); g_free(info->orig_uuid); g_free(info->new_id); nm_g_slice_free(info); } NM_AUTO_DEFINE_FCN(AddConnectionInfo *, _nm_auto_free_add_connection_info, _add_connection_info_free); #define nm_auto_free_add_connection_info nm_auto(_nm_auto_free_add_connection_info) /*****************************************************************************/ static guint progress_id = 0; /* ID of event source for displaying progress */ static void quit(void) { if (nm_clear_g_source(&progress_id)) nmc_terminal_erase_line(); g_main_loop_quit(loop); } typedef struct { char *data; gsize written; gsize length; NmCli *nmc; } PrintConnData; static void print_connection_chunk(GOutputStream *stream, PrintConnData *print_conn_data); static void print_connection_done(GObject *source_object, GAsyncResult *res, gpointer user_data) { GOutputStream *stream = G_OUTPUT_STREAM(source_object); PrintConnData *print_conn_data = user_data; NmCli *nmc = print_conn_data->nmc; GError *error = NULL; gssize written; written = g_output_stream_write_finish(stream, res, &error); if (written == -1) { g_string_printf(nmc->return_text, _("Error: Error writting connection: %s"), error->message); nmc->return_value = NMC_RESULT_ERROR_UNKNOWN; nmc->should_wait--; quit(); return; } print_conn_data->written += written; if (print_conn_data->written != print_conn_data->length) { g_return_if_fail(written); g_return_if_fail(print_conn_data->written < print_conn_data->length); print_connection_chunk(stream, print_conn_data); return; } g_free(print_conn_data->data); g_slice_free(PrintConnData, print_conn_data); nmc->should_wait--; quit(); } static void print_connection_chunk(GOutputStream *stream, PrintConnData *print_conn_data) { g_output_stream_write_async(stream, print_conn_data->data + print_conn_data->written, print_conn_data->length - print_conn_data->written, G_PRIORITY_DEFAULT, NULL, print_connection_done, print_conn_data); } static void nmc_print_connection_and_quit(NmCli *nmc, NMConnection *connection) { gs_free_error GError *error = NULL; nm_auto_unref_keyfile GKeyFile *keyfile = NULL; gs_unref_object GOutputStream *stream = NULL; PrintConnData *print_conn_data; if (!nm_connection_normalize(connection, NULL, NULL, &error)) goto error; keyfile = nm_keyfile_write(connection, NM_KEYFILE_HANDLER_FLAGS_NONE, NULL, NULL, &error); if (!keyfile) goto error; stream = g_unix_output_stream_new(STDOUT_FILENO, FALSE); print_conn_data = g_slice_new(PrintConnData); print_conn_data->data = g_key_file_to_data(keyfile, &print_conn_data->length, NULL); print_conn_data->written = 0; print_conn_data->nmc = nmc; print_connection_chunk(stream, print_conn_data); return; error: g_string_printf(nmc->return_text, _("Error: Error writting connection: %s"), error->message); nmc->return_value = NMC_RESULT_ERROR_UNKNOWN; nmc->should_wait--; quit(); } static const GPtrArray * nmc_get_connections(const NmCli *nmc) { if (nmc->offline) { g_return_val_if_fail(!nmc->client, nmc->offline_connections); return nmc->offline_connections; } else { g_return_val_if_fail(nmc->client, NULL); return nm_client_get_connections(nmc->client); } } static const GPtrArray * nmc_get_active_connections(const NmCli *nmc) { static const GPtrArray offline_active_connections = {.len = 0}; if (nmc->offline) { g_return_val_if_fail(!nmc->client, &offline_active_connections); return &offline_active_connections; } else { g_return_val_if_fail(nmc->client, &offline_active_connections); return nm_client_get_active_connections(nmc->client); } } /*****************************************************************************/ /* Essentially a version of nm_setting_connection_get_connection_type() that * prefers an alias instead of the settings name when in pretty print mode. * That is so that we print "wifi" instead of "802-11-wireless" in "nmcli c". */ static const char * connection_type_to_display(const char *type, NMMetaAccessorGetType get_type) { const NMMetaSettingInfoEditor *editor; int i; nm_assert( NM_IN_SET(get_type, NM_META_ACCESSOR_GET_TYPE_PRETTY, NM_META_ACCESSOR_GET_TYPE_PARSABLE)); if (!type) return NULL; if (get_type != NM_META_ACCESSOR_GET_TYPE_PRETTY) return type; for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) { editor = &nm_meta_setting_infos_editor[i]; if (nm_streq(type, editor->general->setting_name)) return editor->alias ?: type; } return type; } static int active_connection_get_state_ord(NMActiveConnection *active) { /* returns an integer related to @active's state, that can be used for sorting * active connections based on their activation state. */ if (!active) return -2; switch (nm_active_connection_get_state(active)) { case NM_ACTIVE_CONNECTION_STATE_UNKNOWN: return 0; case NM_ACTIVE_CONNECTION_STATE_DEACTIVATED: return 1; case NM_ACTIVE_CONNECTION_STATE_DEACTIVATING: return 2; case NM_ACTIVE_CONNECTION_STATE_ACTIVATING: return 3; case NM_ACTIVE_CONNECTION_STATE_ACTIVATED: return 4; } return -1; } int nmc_active_connection_cmp(NMActiveConnection *ac_a, NMActiveConnection *ac_b) { NMSettingIPConfig *s_ip; NMRemoteConnection *conn; NMIPConfig *da_ip; NMIPConfig *db_ip; int da_num_addrs; int db_num_addrs; int cmp = 0; /* Non-active sort last. */ NM_CMP_SELF(ac_a, ac_b); NM_CMP_DIRECT(active_connection_get_state_ord(ac_b), active_connection_get_state_ord(ac_a)); /* Shared connections (likely hotspots) go on the top if possible */ conn = nm_active_connection_get_connection(ac_a); s_ip = conn ? nm_connection_get_setting_ip6_config(NM_CONNECTION(conn)) : NULL; if (s_ip && nm_streq(nm_setting_ip_config_get_method(s_ip), NM_SETTING_IP6_CONFIG_METHOD_SHARED)) cmp++; conn = nm_active_connection_get_connection(ac_b); s_ip = conn ? nm_connection_get_setting_ip6_config(NM_CONNECTION(conn)) : NULL; if (s_ip && nm_streq(nm_setting_ip_config_get_method(s_ip), NM_SETTING_IP6_CONFIG_METHOD_SHARED)) cmp--; NM_CMP_RETURN(cmp); conn = nm_active_connection_get_connection(ac_a); s_ip = conn ? nm_connection_get_setting_ip4_config(NM_CONNECTION(conn)) : NULL; if (s_ip && nm_streq(nm_setting_ip_config_get_method(s_ip), NM_SETTING_IP4_CONFIG_METHOD_SHARED)) cmp++; conn = nm_active_connection_get_connection(ac_b); s_ip = conn ? nm_connection_get_setting_ip4_config(NM_CONNECTION(conn)) : NULL; if (s_ip && nm_streq(nm_setting_ip_config_get_method(s_ip), NM_SETTING_IP4_CONFIG_METHOD_SHARED)) cmp--; NM_CMP_RETURN(cmp); /* VPNs go next */ NM_CMP_DIRECT(!!nm_active_connection_get_vpn(ac_a), !!nm_active_connection_get_vpn(ac_b)); /* Default devices are prioritized */ NM_CMP_DIRECT(nm_active_connection_get_default(ac_a), nm_active_connection_get_default(ac_b)); /* Default IPv6 devices are prioritized */ NM_CMP_DIRECT(nm_active_connection_get_default6(ac_a), nm_active_connection_get_default6(ac_b)); /* Sort by number of addresses. */ da_ip = nm_active_connection_get_ip4_config(ac_a); da_num_addrs = da_ip ? nm_ip_config_get_addresses(da_ip)->len : 0; db_ip = nm_active_connection_get_ip4_config(ac_b); db_num_addrs = db_ip ? nm_ip_config_get_addresses(db_ip)->len : 0; da_ip = nm_active_connection_get_ip6_config(ac_a); da_num_addrs += da_ip ? nm_ip_config_get_addresses(da_ip)->len : 0; db_ip = nm_active_connection_get_ip6_config(ac_b); db_num_addrs += db_ip ? nm_ip_config_get_addresses(db_ip)->len : 0; NM_CMP_DIRECT(da_num_addrs, db_num_addrs); return 0; } static char * get_ac_device_string(NMActiveConnection *active) { GString *dev_str; const GPtrArray *devices; guint i; if (!active) return NULL; /* Get devices of the active connection */ dev_str = g_string_new(NULL); devices = nm_active_connection_get_devices(active); for (i = 0; i < devices->len; i++) { NMDevice *device = g_ptr_array_index(devices, i); const char *dev_iface = nm_device_get_iface(device); if (dev_iface) { g_string_append(dev_str, dev_iface); g_string_append_c(dev_str, ','); } } if (dev_str->len > 0) g_string_truncate(dev_str, dev_str->len - 1); /* Cut off last ',' */ return g_string_free(dev_str, FALSE); } /*****************************************************************************/ /* FIXME: The same or similar code for VPN info appears also in nm-applet (applet-dialogs.c), * and in gnome-control-center as well. It could probably be shared somehow. */ static const char * get_vpn_connection_type(NMConnection *connection) { NMSettingVpn *s_vpn; const char *type, *p; s_vpn = nm_connection_get_setting_vpn(connection); if (!s_vpn) return NULL; /* The service type is in form of "org.freedesktop.NetworkManager.vpnc". * Extract end part after last dot, e.g. "vpnc" */ type = nm_setting_vpn_get_service_type(nm_connection_get_setting_vpn(connection)); if (!type) return NULL; p = strrchr(type, '.'); return p ? p + 1 : type; } /* VPN parameters can be found at: * http://git.gnome.org/browse/network-manager-openvpn/tree/src/nm-openvpn-service.h * http://git.gnome.org/browse/network-manager-vpnc/tree/src/nm-vpnc-service.h * http://git.gnome.org/browse/network-manager-pptp/tree/src/nm-pptp-service.h * http://git.gnome.org/browse/network-manager-openconnect/tree/src/nm-openconnect-service.h * http://git.gnome.org/browse/network-manager-openswan/tree/src/nm-openswan-service.h * See also 'properties' directory in these plugins. */ static const char * find_vpn_gateway_key(const char *vpn_type) { if (vpn_type) { if (nm_streq(vpn_type, "openvpn")) return "remote"; if (nm_streq(vpn_type, "vpnc")) return "IPSec gateway"; if (nm_streq(vpn_type, "pptp")) return "gateway"; if (nm_streq(vpn_type, "openconnect")) return "gateway"; if (nm_streq(vpn_type, "openswan")) return "right"; if (nm_streq(vpn_type, "libreswan")) return "right"; if (nm_streq(vpn_type, "ssh")) return "remote"; if (nm_streq(vpn_type, "l2tp")) return "gateway"; } return NULL; } static const char * find_vpn_username_key(const char *vpn_type) { if (vpn_type) { if (nm_streq(vpn_type, "openvpn")) return "username"; if (nm_streq(vpn_type, "vpnc")) return "Xauth username"; if (nm_streq(vpn_type, "pptp")) return "user"; if (nm_streq(vpn_type, "openconnect")) return "username"; if (nm_streq(vpn_type, "openswan")) return "leftxauthusername"; if (nm_streq(vpn_type, "libreswan")) return "leftxauthusername"; if (nm_streq(vpn_type, "l2tp")) return "user"; } return NULL; } enum VpnDataItem { VPN_DATA_ITEM_GATEWAY, VPN_DATA_ITEM_USERNAME }; static const char * get_vpn_data_item(NMConnection *connection, enum VpnDataItem vpn_data_item) { const char *type; const char *key = NULL; type = get_vpn_connection_type(connection); switch (vpn_data_item) { case VPN_DATA_ITEM_GATEWAY: key = find_vpn_gateway_key(type); break; case VPN_DATA_ITEM_USERNAME: key = find_vpn_username_key(type); break; default: break; } if (!key) return NULL; return nm_setting_vpn_get_data_item(nm_connection_get_setting_vpn(connection), key); } /*****************************************************************************/ typedef struct { NMConnection *connection; NMActiveConnection *primary_active; GPtrArray *all_active; bool show_active_fields; } MetagenConShowRowData; static MetagenConShowRowData * _metagen_con_show_row_data_new_for_connection(NMRemoteConnection *connection, gboolean show_active_fields) { MetagenConShowRowData *row_data; row_data = g_slice_new0(MetagenConShowRowData); row_data->connection = g_object_ref(NM_CONNECTION(connection)); row_data->show_active_fields = show_active_fields; return row_data; } static MetagenConShowRowData * _metagen_con_show_row_data_new_for_active_connection(NMRemoteConnection *connection, NMActiveConnection *active, gboolean show_active_fields) { MetagenConShowRowData *row_data; row_data = g_slice_new0(MetagenConShowRowData); if (connection) row_data->connection = g_object_ref(NM_CONNECTION(connection)); row_data->primary_active = g_object_ref(active); row_data->show_active_fields = show_active_fields; return row_data; } static void _metagen_con_show_row_data_add_active_connection(MetagenConShowRowData *row_data, NMActiveConnection *active) { if (!row_data->primary_active) { row_data->primary_active = g_object_ref(active); return; } if (!row_data->all_active) { row_data->all_active = g_ptr_array_new_with_free_func(g_object_unref); g_ptr_array_add(row_data->all_active, g_object_ref(row_data->primary_active)); } g_ptr_array_add(row_data->all_active, g_object_ref(active)); } static void _metagen_con_show_row_data_init_primary_active(MetagenConShowRowData *row_data) { NMActiveConnection *ac, *best_ac; guint i; if (!row_data->all_active) return; best_ac = row_data->all_active->pdata[0]; for (i = 1; i < row_data->all_active->len; i++) { ac = row_data->all_active->pdata[i]; if (active_connection_get_state_ord(ac) > active_connection_get_state_ord(best_ac)) best_ac = ac; } if (row_data->primary_active != best_ac) { g_object_unref(row_data->primary_active); row_data->primary_active = g_object_ref(best_ac); } nm_clear_pointer(&row_data->all_active, g_ptr_array_unref); } static void _metagen_con_show_row_data_destroy(gpointer data) { MetagenConShowRowData *row_data = data; if (!row_data) return; g_clear_object(&row_data->connection); g_clear_object(&row_data->primary_active); nm_clear_pointer(&row_data->all_active, g_ptr_array_unref); g_slice_free(MetagenConShowRowData, row_data); } static const char * _con_show_fcn_get_id(NMConnection *c, NMActiveConnection *ac) { NMSettingConnection *s_con = NULL; const char *s; if (c) s_con = nm_connection_get_setting_connection(c); s = s_con ? nm_setting_connection_get_id(s_con) : NULL; if (!s && ac) { /* note that if we have no s_con, that usually means that the user has no permissions * to see the connection. We still fall to get the ID from the active-connection, * which exposes it despite the user having no permissions. * * That might be unexpected, because the user is shown an ID, which he later * is unable to resolve in other operations. */ s = nm_active_connection_get_id(ac); } return s; } static const char * _con_show_fcn_get_type(NMConnection *c, NMActiveConnection *ac, NMMetaAccessorGetType get_type) { NMSettingConnection *s_con = NULL; const char *s; if (c) s_con = nm_connection_get_setting_connection(c); s = s_con ? nm_setting_connection_get_connection_type(s_con) : NULL; if (!s && ac) { /* see _con_show_fcn_get_id() for why we fallback to get the value * from @ac. */ s = nm_active_connection_get_connection_type(ac); } return connection_type_to_display(s, get_type); } const char * nmc_connection_check_deprecated(NMConnection *c) { NMSettingWirelessSecurity *s_wsec; const char *key_mgmt; const char *type; type = nm_connection_get_connection_type(c); if (strcmp(type, NM_SETTING_WIMAX_SETTING_NAME) == 0) return _("WiMax is no longer supported"); s_wsec = nm_connection_get_setting_wireless_security(c); if (s_wsec) { key_mgmt = nm_setting_wireless_security_get_key_mgmt(s_wsec); if (NM_IN_STRSET(key_mgmt, "ieee8021x", "none")) return _("WEP encryption is known to be insecure"); } return NULL; } static NMMetaColor _connection_to_color(NMConnection *c, NMActiveConnection *ac) { if (ac) return nmc_active_connection_state_to_color(ac); if (nmc_connection_check_deprecated(c)) return NM_META_COLOR_CONNECTION_DEPRECATED; return NM_META_COLOR_CONNECTION_UNKNOWN; } static gconstpointer _metagen_con_show_get_fcn(NMC_META_GENERIC_INFO_GET_FCN_ARGS) { const MetagenConShowRowData *row_data = target; NMConnection *c = row_data->connection; NMActiveConnection *ac = row_data->primary_active; NMSettingConnection *s_con = NULL; const char *s; char *s_mut; NMC_HANDLE_COLOR(_connection_to_color(c, ac)); if (c) s_con = nm_connection_get_setting_connection(c); if (!row_data->show_active_fields) { /* we are not supposed to show any fields of the active connection. * We only tracked the primary_active to get the coloring right. * From now on, there is no active connection. */ ac = NULL; /* in this mode, we expect that we are called only with connections that * have a [connection] setting and a UUID. Otherwise, the connection is * effectively invisible to the user, and should be hidden. * * But in that case, we expect that the caller pre-filtered this row out. * So assert(). */ nm_assert(s_con); nm_assert(nm_setting_connection_get_uuid(s_con)); } nm_assert( NM_IN_SET(get_type, NM_META_ACCESSOR_GET_TYPE_PRETTY, NM_META_ACCESSOR_GET_TYPE_PARSABLE)); switch (info->info_type) { case NMC_GENERIC_INFO_TYPE_CON_SHOW_NAME: return _con_show_fcn_get_id(c, ac); case NMC_GENERIC_INFO_TYPE_CON_SHOW_UUID: s = s_con ? nm_setting_connection_get_uuid(s_con) : NULL; if (!s && ac) { /* see _con_show_fcn_get_id() for why we fallback to get the value * from @ac. */ s = nm_active_connection_get_uuid(ac); } return s; case NMC_GENERIC_INFO_TYPE_CON_SHOW_TYPE: return _con_show_fcn_get_type(c, ac, get_type); case NMC_GENERIC_INFO_TYPE_CON_SHOW_TIMESTAMP: case NMC_GENERIC_INFO_TYPE_CON_SHOW_TIMESTAMP_REAL: if (!s_con) return NULL; { guint64 timestamp; time_t timestamp_real; timestamp = nm_setting_connection_get_timestamp(s_con); if (info->info_type == NMC_GENERIC_INFO_TYPE_CON_SHOW_TIMESTAMP) return (*out_to_free = g_strdup_printf("%" G_GUINT64_FORMAT, timestamp)); else { struct tm localtime_result; if (!timestamp) { if (get_type == NM_META_ACCESSOR_GET_TYPE_PRETTY) return _("never"); return "never"; } timestamp_real = timestamp; s_mut = g_malloc0(128); strftime(s_mut, 127, "%c", localtime_r(×tamp_real, &localtime_result)); return (*out_to_free = s_mut); } } case NMC_GENERIC_INFO_TYPE_CON_SHOW_AUTOCONNECT: if (!s_con) return NULL; return nmc_meta_generic_get_bool(nm_setting_connection_get_autoconnect(s_con), get_type); case NMC_GENERIC_INFO_TYPE_CON_SHOW_AUTOCONNECT_PRIORITY: if (!s_con) return NULL; return (*out_to_free = g_strdup_printf("%d", nm_setting_connection_get_autoconnect_priority(s_con))); case NMC_GENERIC_INFO_TYPE_CON_SHOW_READONLY: if (!s_con) return NULL; return nmc_meta_generic_get_bool(nm_setting_connection_get_read_only(s_con), get_type); case NMC_GENERIC_INFO_TYPE_CON_SHOW_DBUS_PATH: if (!c) return NULL; return nm_connection_get_path(c); case NMC_GENERIC_INFO_TYPE_CON_SHOW_ACTIVE: return nmc_meta_generic_get_bool(!!ac, get_type); case NMC_GENERIC_INFO_TYPE_CON_SHOW_DEVICE: if (ac) return (*out_to_free = get_ac_device_string(ac)); return NULL; case NMC_GENERIC_INFO_TYPE_CON_SHOW_STATE: return nmc_meta_generic_get_str_i18n( ac ? active_connection_state_to_string(nm_active_connection_get_state(ac)) : NULL, get_type); case NMC_GENERIC_INFO_TYPE_CON_SHOW_ACTIVE_PATH: if (ac) return nm_object_get_path(NM_OBJECT(ac)); return NULL; case NMC_GENERIC_INFO_TYPE_CON_SHOW_SLAVE: if (!s_con) return NULL; return nm_setting_connection_get_slave_type(s_con); case NMC_GENERIC_INFO_TYPE_CON_SHOW_FILENAME: if (!NM_IS_REMOTE_CONNECTION(c)) return NULL; return nm_remote_connection_get_filename(NM_REMOTE_CONNECTION(c)); default: break; } g_return_val_if_reached(NULL); } const NmcMetaGenericInfo *const metagen_con_show[_NMC_GENERIC_INFO_TYPE_CON_SHOW_NUM + 1] = { #define _METAGEN_CON_SHOW(type, name) \ [type] = NMC_META_GENERIC(name, .info_type = type, .get_fcn = _metagen_con_show_get_fcn) _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_NAME, "NAME"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_UUID, "UUID"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_TYPE, "TYPE"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_TIMESTAMP, "TIMESTAMP"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_TIMESTAMP_REAL, "TIMESTAMP-REAL"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_AUTOCONNECT, "AUTOCONNECT"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_AUTOCONNECT_PRIORITY, "AUTOCONNECT-PRIORITY"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_READONLY, "READONLY"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_DBUS_PATH, "DBUS-PATH"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_ACTIVE, "ACTIVE"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_DEVICE, "DEVICE"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_STATE, "STATE"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_ACTIVE_PATH, "ACTIVE-PATH"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_SLAVE, "SLAVE"), _METAGEN_CON_SHOW(NMC_GENERIC_INFO_TYPE_CON_SHOW_FILENAME, "FILENAME"), }; #define NMC_FIELDS_CON_SHOW_COMMON "NAME,UUID,TYPE,DEVICE" /*****************************************************************************/ static gconstpointer _metagen_con_active_general_get_fcn(NMC_META_GENERIC_INFO_GET_FCN_ARGS) { NMActiveConnection *ac = target; NMConnection *c; NMSettingConnection *s_con = NULL; NMDevice *dev; guint i; const char *s; NMC_HANDLE_COLOR(NM_META_COLOR_NONE); nm_assert( NM_IN_SET(get_type, NM_META_ACCESSOR_GET_TYPE_PRETTY, NM_META_ACCESSOR_GET_TYPE_PARSABLE)); c = NM_CONNECTION(nm_active_connection_get_connection(ac)); if (c) s_con = nm_connection_get_setting_connection(c); switch (info->info_type) { case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_NAME: return nm_active_connection_get_id(ac); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_UUID: return nm_active_connection_get_uuid(ac); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DEVICES: case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_IP_IFACE: { GString *str = NULL; const GPtrArray *devices; s = NULL; devices = nm_active_connection_get_devices(ac); if (devices) { for (i = 0; i < devices->len; i++) { NMDevice *device = g_ptr_array_index(devices, i); const char *iface; if (info->info_type == NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DEVICES) { iface = nm_device_get_iface(device); } else { iface = nm_device_get_ip_iface(device); } if (!iface) continue; if (!s) { s = iface; continue; } if (!str) str = g_string_new(s); g_string_append_c(str, ','); g_string_append(str, iface); } } if (str) return (*out_to_free = g_string_free(str, FALSE)); return s; } case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_STATE: return nmc_meta_generic_get_str_i18n( active_connection_state_to_string(nm_active_connection_get_state(ac)), get_type); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DEFAULT: return nmc_meta_generic_get_bool(nm_active_connection_get_default(ac), get_type); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DEFAULT6: return nmc_meta_generic_get_bool(nm_active_connection_get_default6(ac), get_type); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_SPEC_OBJECT: return nm_active_connection_get_specific_object_path(ac); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_VPN: return nmc_meta_generic_get_bool(NM_IS_VPN_CONNECTION(ac), get_type); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DBUS_PATH: return nm_object_get_path(NM_OBJECT(ac)); case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_CON_PATH: return c ? nm_connection_get_path(c) : NULL; case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_ZONE: /* this is really ugly, because the zone is not a property of the active-connection, * but the settings-connection profile. There is no guarantee, that they agree. */ return s_con ? nm_setting_connection_get_zone(s_con) : NULL; case NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_MASTER_PATH: dev = nm_active_connection_get_master(ac); return dev ? nm_object_get_path(NM_OBJECT(dev)) : NULL; default: break; } g_return_val_if_reached(NULL); } const NmcMetaGenericInfo *const metagen_con_active_general[_NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_NUM + 1] = { #define _METAGEN_CON_ACTIVE_GENERAL(type, name) \ [type] = \ NMC_META_GENERIC(name, .info_type = type, .get_fcn = _metagen_con_active_general_get_fcn) _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_NAME, "NAME"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_UUID, "UUID"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DEVICES, "DEVICES"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_IP_IFACE, "IP-IFACE"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_STATE, "STATE"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DEFAULT, "DEFAULT"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DEFAULT6, "DEFAULT6"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_SPEC_OBJECT, "SPEC-OBJECT"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_VPN, "VPN"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_DBUS_PATH, "DBUS-PATH"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_CON_PATH, "CON-PATH"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_ZONE, "ZONE"), _METAGEN_CON_ACTIVE_GENERAL(NMC_GENERIC_INFO_TYPE_CON_ACTIVE_GENERAL_MASTER_PATH, "MASTER-PATH"), }; /*****************************************************************************/ static gconstpointer _metagen_con_active_vpn_get_fcn(NMC_META_GENERIC_INFO_GET_FCN_ARGS) { NMActiveConnection *ac = target; NMConnection *c; NMSettingVpn *s_vpn = NULL; NMVpnConnectionState vpn_state; guint i; const char *s; char **arr = NULL; nm_assert(NM_IS_VPN_CONNECTION(ac)); NMC_HANDLE_COLOR(NM_META_COLOR_NONE); nm_assert( NM_IN_SET(get_type, NM_META_ACCESSOR_GET_TYPE_PRETTY, NM_META_ACCESSOR_GET_TYPE_PARSABLE)); c = NM_CONNECTION(nm_active_connection_get_connection(ac)); if (c) s_vpn = nm_connection_get_setting_vpn(c); switch (info->info_type) { case NMC_GENERIC_INFO_TYPE_CON_VPN_TYPE: return c ? get_vpn_connection_type(c) : NULL; case NMC_GENERIC_INFO_TYPE_CON_VPN_USERNAME: if (s_vpn && (s = nm_setting_vpn_get_user_name(s_vpn))) return s; return c ? get_vpn_data_item(c, VPN_DATA_ITEM_USERNAME) : NULL; case NMC_GENERIC_INFO_TYPE_CON_VPN_GATEWAY: return c ? get_vpn_data_item(c, VPN_DATA_ITEM_GATEWAY) : NULL; case NMC_GENERIC_INFO_TYPE_CON_VPN_BANNER: s = nm_vpn_connection_get_banner(NM_VPN_CONNECTION(ac)); if (s) return (*out_to_free = g_strescape(s, "")); return NULL; case NMC_GENERIC_INFO_TYPE_CON_VPN_VPN_STATE: vpn_state = nm_vpn_connection_get_vpn_state(NM_VPN_CONNECTION(ac)); return (*out_to_free = nmc_meta_generic_get_enum_with_detail(NMC_META_GENERIC_GET_ENUM_TYPE_DASH, vpn_state, vpn_connection_state_to_string(vpn_state), get_type)); case NMC_GENERIC_INFO_TYPE_CON_VPN_CFG: if (!NM_FLAGS_HAS(get_flags, NM_META_ACCESSOR_GET_FLAGS_ACCEPT_STRV)) return NULL; if (s_vpn) { gs_free char **arr2 = NULL; guint n; arr2 = (char **) nm_setting_vpn_get_data_keys(s_vpn, &n); if (!n) goto arr_out; nm_assert(arr2 && !arr2[n]); for (i = 0; i < n; i++) { const char *k = arr2[i]; const char *v; nm_assert(k); v = nm_setting_vpn_get_data_item(s_vpn, k); /* update the arr array in-place. Previously it contained * the constant keys, now it contains the strdup'ed output text. */ arr2[i] = g_strdup_printf("%s = %s", k, v); } arr = g_steal_pointer(&arr2); } goto arr_out; default: break; } g_return_val_if_reached(NULL); arr_out: NM_SET_OUT(out_is_default, !arr || !arr[0]); *out_flags |= NM_META_ACCESSOR_GET_OUT_FLAGS_STRV; *out_to_free = arr; return arr; } const NmcMetaGenericInfo *const metagen_con_active_vpn[_NMC_GENERIC_INFO_TYPE_CON_ACTIVE_VPN_NUM + 1] = { #define _METAGEN_CON_ACTIVE_VPN(type, name) \ [type] = NMC_META_GENERIC(name, .info_type = type, .get_fcn = _metagen_con_active_vpn_get_fcn) _METAGEN_CON_ACTIVE_VPN(NMC_GENERIC_INFO_TYPE_CON_VPN_TYPE, "TYPE"), _METAGEN_CON_ACTIVE_VPN(NMC_GENERIC_INFO_TYPE_CON_VPN_USERNAME, "USERNAME"), _METAGEN_CON_ACTIVE_VPN(NMC_GENERIC_INFO_TYPE_CON_VPN_GATEWAY, "GATEWAY"), _METAGEN_CON_ACTIVE_VPN(NMC_GENERIC_INFO_TYPE_CON_VPN_BANNER, "BANNER"), _METAGEN_CON_ACTIVE_VPN(NMC_GENERIC_INFO_TYPE_CON_VPN_VPN_STATE, "VPN-STATE"), _METAGEN_CON_ACTIVE_VPN(NMC_GENERIC_INFO_TYPE_CON_VPN_CFG, "CFG"), }; /*****************************************************************************/ #define NMC_FIELDS_SETTINGS_NAMES_ALL \ NM_SETTING_CONNECTION_SETTING_NAME \ "," NM_SETTING_MATCH_SETTING_NAME "," NM_SETTING_WIRED_SETTING_NAME \ "," NM_SETTING_VETH_SETTING_NAME "," NM_SETTING_802_1X_SETTING_NAME \ "," NM_SETTING_WIRELESS_SETTING_NAME "," NM_SETTING_WIRELESS_SECURITY_SETTING_NAME \ "," NM_SETTING_IP4_CONFIG_SETTING_NAME "," NM_SETTING_IP6_CONFIG_SETTING_NAME \ "," NM_SETTING_SERIAL_SETTING_NAME "," NM_SETTING_WIFI_P2P_SETTING_NAME \ "," NM_SETTING_PPP_SETTING_NAME "," NM_SETTING_PPPOE_SETTING_NAME \ "," NM_SETTING_ADSL_SETTING_NAME "," NM_SETTING_GSM_SETTING_NAME \ "," NM_SETTING_CDMA_SETTING_NAME "," NM_SETTING_BLUETOOTH_SETTING_NAME \ "," NM_SETTING_OLPC_MESH_SETTING_NAME "," NM_SETTING_VPN_SETTING_NAME \ "," NM_SETTING_INFINIBAND_SETTING_NAME "," NM_SETTING_BOND_SETTING_NAME \ "," NM_SETTING_BOND_PORT_SETTING_NAME "," NM_SETTING_VLAN_SETTING_NAME \ "," NM_SETTING_BRIDGE_SETTING_NAME "," NM_SETTING_BRIDGE_PORT_SETTING_NAME \ "," NM_SETTING_TEAM_SETTING_NAME "," NM_SETTING_TEAM_PORT_SETTING_NAME \ "," NM_SETTING_OVS_BRIDGE_SETTING_NAME "," NM_SETTING_OVS_INTERFACE_SETTING_NAME \ "," NM_SETTING_OVS_PATCH_SETTING_NAME "," NM_SETTING_OVS_PORT_SETTING_NAME \ "," NM_SETTING_DCB_SETTING_NAME "," NM_SETTING_TUN_SETTING_NAME \ "," NM_SETTING_IP_TUNNEL_SETTING_NAME "," NM_SETTING_MACSEC_SETTING_NAME \ "," NM_SETTING_MACVLAN_SETTING_NAME "," NM_SETTING_VXLAN_SETTING_NAME \ "," NM_SETTING_VRF_SETTING_NAME "," NM_SETTING_WPAN_SETTING_NAME \ "," NM_SETTING_6LOWPAN_SETTING_NAME "," NM_SETTING_WIREGUARD_SETTING_NAME \ "," NM_SETTING_PROXY_SETTING_NAME "," NM_SETTING_TC_CONFIG_SETTING_NAME \ "," NM_SETTING_SRIOV_SETTING_NAME "," NM_SETTING_ETHTOOL_SETTING_NAME \ "," NM_SETTING_OVS_DPDK_SETTING_NAME \ "," NM_SETTING_HOSTNAME_SETTING_NAME /* NM_SETTING_DUMMY_SETTING_NAME NM_SETTING_WIMAX_SETTING_NAME */ const NmcMetaGenericInfo *const nmc_fields_con_active_details_groups[] = { NMC_META_GENERIC_WITH_NESTED("GENERAL", metagen_con_active_general), /* 0 */ NMC_META_GENERIC_WITH_NESTED("IP4", metagen_ip4_config), /* 1 */ NMC_META_GENERIC_WITH_NESTED("DHCP4", metagen_dhcp_config), /* 2 */ NMC_META_GENERIC_WITH_NESTED("IP6", metagen_ip6_config), /* 3 */ NMC_META_GENERIC_WITH_NESTED("DHCP6", metagen_dhcp_config), /* 4 */ NMC_META_GENERIC_WITH_NESTED("VPN", metagen_con_active_vpn), /* 5 */ NULL, }; /* Pseudo group names for 'connection show ' */ /* e.g.: nmcli -f profile con show my-eth0 */ /* e.g.: nmcli -f active con show my-eth0 */ #define CON_SHOW_DETAIL_GROUP_PROFILE "profile" #define CON_SHOW_DETAIL_GROUP_ACTIVE "active" /* for readline TAB completion in editor */ typedef struct { NmCli *nmc; char *con_type; NMConnection *connection; NMSetting *setting; const char *property; char **words; } TabCompletionInfo; static TabCompletionInfo nmc_tab_completion; /*****************************************************************************/ static void usage(void) { g_printerr( _("Usage: nmcli connection { COMMAND | help }\n\n" "COMMAND := { show | up | down | add | modify | clone | edit | delete | monitor | reload " "| load | import | export }\n\n" " show [--active] [--order ]\n" " show [--active] [id | uuid | path | apath] ...\n\n" " up [[id | uuid | path] ] [ifname ] [ap ] [passwd-file ]\n\n" " down [id | uuid | path | apath] ...\n\n" " add COMMON_OPTIONS TYPE_SPECIFIC_OPTIONS SLAVE_OPTIONS IP_OPTIONS [-- " "([+|-]. )+]\n\n" " modify [--temporary] [id | uuid | path] ([+|-]. )+\n\n" " clone [--temporary] [id | uuid | path ] \n\n" " edit [id | uuid | path] \n" " edit [type ] [con-name ]\n\n" " delete [id | uuid | path] \n\n" " monitor [id | uuid | path] ...\n\n" " reload\n\n" " load [ ... ]\n\n" " import [--temporary] type file \n\n" " export [id | uuid | path] []\n\n")); } static void usage_connection_show(void) { g_printerr( _("Usage: nmcli connection show { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [--active] [--order ]\n" "\n" "List in-memory and on-disk connection profiles, some of which may also be\n" "active if a device is using that connection profile. Without a parameter, all\n" "profiles are listed. When --active option is specified, only the active\n" "profiles are shown. --order allows custom connection ordering (see manual page).\n" "\n" "ARGUMENTS := [--active] [id | uuid | path | apath] ...\n" "\n" "Show details for specified connections. By default, both static configuration\n" "and active connection data are displayed. It is possible to filter the output\n" "using global '--fields' option. Refer to the manual page for more information.\n" "When --active option is specified, only the active profiles are taken into\n" "account. Use global --show-secrets option to reveal associated secrets as well.\n")); } static void usage_connection_up(void) { g_printerr(_("Usage: nmcli connection up { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path] [ifname ] [ap ] [nsp ] " "[passwd-file ]\n" "\n" "Activate a connection on a device. The profile to activate is identified by its\n" "name, UUID or D-Bus path.\n" "\n" "ARGUMENTS := ifname [ap ] [nsp ] [passwd-file ]\n" "\n" "Activate a device with a connection. The connection profile is selected\n" "automatically by NetworkManager.\n" "\n" "ifname - specifies the device to active the connection on\n" "ap - specifies AP to connect to (only valid for Wi-Fi)\n" "nsp - specifies NSP to connect to (only valid for WiMAX)\n" "passwd-file - file with password(s) required to activate the connection\n\n")); } static void usage_connection_down(void) { g_printerr(_("Usage: nmcli connection down { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path | apath] ...\n" "\n" "Deactivate a connection from a device (without preventing the device from\n" "further auto-activation). The profile to deactivate is identified by its name,\n" "UUID or D-Bus path.\n\n")); } static void usage_connection_add(void) { g_printerr(_("Usage: nmcli connection add { ARGUMENTS | help }\n" "\n" "ARGUMENTS := COMMON_OPTIONS TYPE_SPECIFIC_OPTIONS SLAVE_OPTIONS IP_OPTIONS [-- " "([+|-]. )+]\n\n" " COMMON_OPTIONS:\n" " type \n" " [ifname | \"*\"]\n" " [con-name ]\n" " [autoconnect yes|no]\n" " [save yes|no]\n" " [master ]\n" " [slave-type ]\n\n" " TYPE_SPECIFIC_OPTIONS:\n" " ethernet: [mac ]\n" " [cloned-mac ]\n" " [mtu ]\n\n" " wifi: ssid \n" " [mac ]\n" " [cloned-mac ]\n" " [mtu ]\n" " [mode infrastructure|ap|adhoc]\n\n" " wimax: [mac ]\n" " [nsp ]\n\n" " pppoe: username \n" " [password ]\n" " [service ]\n" " [mtu ]\n" " [mac ]\n\n" " gsm: apn \n" " [user ]\n" " [password ]\n\n" " cdma: [user ]\n" " [password ]\n\n" " infiniband: [mac ]\n" " [mtu ]\n" " [transport-mode datagram | connected]\n" " [parent ]\n" " [p-key ]\n\n" " bluetooth: [addr ]\n" " [bt-type panu|nap|dun-gsm|dun-cdma]\n\n" " vlan: dev \n" " id \n" " [flags ]\n" " [ingress ]\n" " [egress ]\n" " [mtu ]\n\n" " bond: [mode balance-rr (0) | active-backup (1) | balance-xor (2) | " "broadcast (3) |\n" " 802.3ad (4) | balance-tlb (5) | balance-alb (6)]\n" " [primary ]\n" " [miimon ]\n" " [downdelay ]\n" " [updelay ]\n" " [arp-interval ]\n" " [arp-ip-target ]\n" " [lacp-rate slow (0) | fast (1)]\n\n" " bond-slave: master \n" " [queue-id <0-65535>]\n\n" " team: [config |]\n\n" " team-slave: master \n" " [config |]\n\n" " bridge: [stp yes|no]\n" " [priority ]\n" " [forward-delay <2-30>]\n" " [hello-time <1-10>]\n" " [max-age <6-40>]\n" " [ageing-time <0-1000000>]\n" " [multicast-snooping yes|no]\n" " [mac ]\n\n" " bridge-slave: master \n" " [priority <0-63>]\n" " [path-cost <1-65535>]\n" " [hairpin yes|no]\n\n" " vpn: vpn-type " "vpnc|openvpn|pptp|openconnect|openswan|libreswan|ssh|l2tp|iodine|...\n" " [user ]\n\n" " olpc-mesh: ssid \n" " [channel <1-13>]\n" " [dhcp-anycast ]\n\n" " adsl: username \n" " protocol pppoa|pppoe|ipoatm\n" " [password ]\n" " [encapsulation vcmux|llc]\n\n" " tun: mode tun|tap\n" " [owner ]\n" " [group ]\n" " [pi yes|no]\n" " [vnet-hdr yes|no]\n" " [multi-queue yes|no]\n\n" " ip-tunnel: mode ipip|gre|sit|isatap|vti|ip6ip6|ipip6|ip6gre|vti6\n" " remote \n" " [local ]\n" " [dev ]\n\n" " macsec: dev \n" " mode \n" " [cak ckn ]\n" " [encrypt yes|no]\n" " [port 1-65534]\n\n\n" " macvlan: dev \n" " mode vepa|bridge|private|passthru|source\n" " [tap yes|no]\n\n" " vxlan: id \n" " [remote ]\n" " [local ]\n" " [dev ]\n" " [source-port-min <0-65535>]\n" " [source-port-max <0-65535>]\n" " [destination-port <0-65535>]\n\n" " wpan: [short-addr <0x0000-0xffff>]\n" " [pan-id <0x0000-0xffff>]\n" " [page ]\n" " [channel ]\n" " [mac ]\n\n" " 6lowpan: dev \n" " dummy:\n\n" " SLAVE_OPTIONS:\n" " bridge: [priority <0-63>]\n" " [path-cost <1-65535>]\n" " [hairpin yes|no]\n\n" " team: [config |]\n\n" " bond: [queue-id <0-65535>]\n\n" " IP_OPTIONS:\n" " [ip4 ] [gw4 ]\n" " [ip6 ] [gw6 ]\n\n")); } static void usage_connection_modify(void) { g_printerr( _("Usage: nmcli connection modify { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path] ([+|-]. )+\n" "\n" "Modify one or more properties of the connection profile.\n" "The profile is identified by its name, UUID or D-Bus path. For multi-valued\n" "properties you can use optional '+' or '-' prefix to the property name.\n" "The '+' sign allows appending items instead of overwriting the whole value.\n" "The '-' sign allows removing selected items instead of the whole value.\n" "\n" "ARGUMENTS := remove \n" "\n" "Remove a setting from the connection profile.\n" "\n" "Examples:\n" "nmcli con mod home-wifi wifi.ssid rakosnicek\n" "nmcli con mod em1-1 ipv4.method manual ipv4.addr \"192.168.1.2/24, 10.10.1.5/8\"\n" "nmcli con mod em1-1 +ipv4.dns 8.8.4.4\n" "nmcli con mod em1-1 -ipv4.dns 1\n" "nmcli con mod em1-1 -ipv6.addr \"abbe::cafe/56\"\n" "nmcli con mod bond0 +bond.options mii=500\n" "nmcli con mod bond0 -bond.options downdelay\n" "nmcli con mod em1-1 remove sriov\n\n")); } static void usage_connection_clone(void) { g_printerr(_("Usage: nmcli connection clone { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [--temporary] [id | uuid | path] \n" "\n" "Clone an existing connection profile. The newly created connection will be\n" "the exact copy of the , except the uuid property (will be generated) and\n" "id (provided as argument).\n\n")); } static void usage_connection_edit(void) { g_printerr(_("Usage: nmcli connection edit { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path] \n" "\n" "Edit an existing connection profile in an interactive editor.\n" "The profile is identified by its name, UUID or D-Bus path\n" "\n" "ARGUMENTS := [type ] [con-name ]\n" "\n" "Add a new connection profile in an interactive editor.\n\n")); } static void usage_connection_delete(void) { g_printerr(_("Usage: nmcli connection delete { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path] , ...\n" "\n" "Delete connection profiles.\n" "The profiles are identified by their name, UUID or D-Bus path.\n\n")); } static void usage_connection_monitor(void) { g_printerr(_("Usage: nmcli connection monitor { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path] ...\n" "\n" "Monitor connection profile activity.\n" "This command prints a line whenever the specified connection changes.\n" "Monitors all connection profiles in case none is specified.\n\n")); } static void usage_connection_reload(void) { g_printerr(_("Usage: nmcli connection reload { help }\n" "\n" "Reload all connection files from disk.\n\n")); } static void usage_connection_load(void) { g_printerr(_("Usage: nmcli connection load { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [...]\n" "\n" "Load/reload one or more connection files from disk. Use this after manually\n" "editing a connection file to ensure that NetworkManager is aware of its latest\n" "state.\n\n")); } static void usage_connection_import(void) { g_printerr( _("Usage: nmcli connection import { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [--temporary] type file \n" "\n" "Import an external/foreign configuration as a NetworkManager connection profile.\n" "The type of the input file is specified by type option.\n" "Only VPN configurations are supported at the moment. The configuration\n" "is imported by NetworkManager VPN plugins.\n\n")); } static void usage_connection_export(void) { g_printerr(_("Usage: nmcli connection export { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [id | uuid | path] []\n" "\n" "Export a connection. Only VPN connections are supported at the moment.\n" "The data are directed to standard output or to a file if a name is given.\n\n")); } static void usage_connection_migrate(void) { g_printerr(_("Usage: nmcli connection migrate { ARGUMENTS | help }\n" "\n" "ARGUMENTS := [--plugin ] [id | uuid | path] , ...\n" "\n" "Migrate connection profiles to a different settings plugin,\n" "such as \"keyfile\" (default) or \"ifcfg-rh\".\n\n")); } static char * construct_header_name(const char *base, const char *spec) { if (spec == NULL) return g_strdup(base); return g_strdup_printf("%s (%s)", base, spec); } static int get_ac_for_connection_cmp(gconstpointer pa, gconstpointer pb) { NMActiveConnection *ac_a = *((NMActiveConnection *const *) pa); NMActiveConnection *ac_b = *((NMActiveConnection *const *) pb); NM_CMP_RETURN(nmc_active_connection_cmp(ac_a, ac_b)); NM_CMP_DIRECT_STRCMP0(nm_active_connection_get_id(ac_a), nm_active_connection_get_id(ac_b)); NM_CMP_DIRECT_STRCMP0(nm_active_connection_get_connection_type(ac_a), nm_active_connection_get_connection_type(ac_b)); NM_CMP_DIRECT_STRCMP0(nm_object_get_path(NM_OBJECT(ac_a)), nm_object_get_path(NM_OBJECT(ac_b))); g_return_val_if_reached(0); } static NMActiveConnection * get_ac_for_connection(const GPtrArray *active_cons, NMConnection *connection, GPtrArray **out_result) { guint i; NMActiveConnection *best_candidate = NULL; GPtrArray *result = out_result ? *out_result : NULL; for (i = 0; i < active_cons->len; i++) { NMActiveConnection *candidate = g_ptr_array_index(active_cons, i); NMRemoteConnection *con; con = nm_active_connection_get_connection(candidate); if (NM_CONNECTION(con) != connection) continue; if (!out_result) return candidate; if (!result) result = g_ptr_array_new_with_free_func(g_object_unref); g_ptr_array_add(result, g_object_ref(candidate)); } if (result) { g_ptr_array_sort(result, get_ac_for_connection_cmp); best_candidate = result->pdata[0]; } NM_SET_OUT(out_result, result); return best_candidate; } typedef struct { GMainLoop *loop; NMConnection *local; const char *setting_name; } GetSecretsData; static void got_secrets(GObject *source_object, GAsyncResult *res, gpointer user_data) { NMRemoteConnection *remote = NM_REMOTE_CONNECTION(source_object); GetSecretsData *data = user_data; gs_unref_variant GVariant *secrets = NULL; secrets = nm_remote_connection_get_secrets_finish(remote, res, NULL); if (secrets) { gs_free_error GError *error = NULL; if (!nm_connection_update_secrets(data->local, NULL, secrets, &error) && error) { g_printerr(_("Error updating secrets for %s: %s\n"), data->setting_name, error->message); } } g_main_loop_quit(data->loop); } /* Put secrets into local connection. */ static void update_secrets_in_connection(NMRemoteConnection *remote, NMConnection *local) { GetSecretsData data = { 0, }; GType setting_type; int i; data.local = local; data.loop = g_main_loop_new(NULL, FALSE); for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) { setting_type = nm_meta_setting_infos[i].get_setting_gtype(); if (!nm_connection_get_setting(NM_CONNECTION(remote), setting_type)) continue; if (!nm_meta_setting_info_editor_has_secrets( nm_meta_setting_info_editor_find_by_gtype(setting_type))) continue; data.setting_name = nm_meta_setting_infos[i].setting_name; nm_remote_connection_get_secrets_async(remote, nm_meta_setting_infos[i].setting_name, NULL, got_secrets, &data); g_main_loop_run(data.loop); } g_main_loop_unref(data.loop); } static gboolean nmc_connection_profile_details(NMConnection *connection, NmCli *nmc) { GError *error = NULL; GArray *print_settings_array; GPtrArray *prop_array = NULL; guint i; char *fields_str; char *fields_all = NMC_FIELDS_SETTINGS_NAMES_ALL; char *fields_common = NMC_FIELDS_SETTINGS_NAMES_ALL; const char *base_hdr = _("Connection profile details"); gboolean was_output = FALSE; if (!nmc->required_fields || g_ascii_strcasecmp(nmc->required_fields, "common") == 0) fields_str = fields_common; else if (!nmc->required_fields || g_ascii_strcasecmp(nmc->required_fields, "all") == 0) fields_str = fields_all; else fields_str = nmc->required_fields; print_settings_array = parse_output_fields(fields_str, (const NMMetaAbstractInfo *const *) nm_meta_setting_infos_editor_p(), TRUE, &prop_array, &error); if (!print_settings_array) { g_return_val_if_fail(error, FALSE); g_string_printf(nmc->return_text, _("Error: 'connection show': %s"), error->message); g_error_free(error); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return FALSE; } /* Main header */ { gs_free char *header_name = NULL; gs_free NmcOutputField *row = NULL; gs_unref_array GArray *out_indices = NULL; header_name = construct_header_name(base_hdr, nm_connection_get_id(connection)); out_indices = parse_output_fields( NMC_FIELDS_SETTINGS_NAMES_ALL, (const NMMetaAbstractInfo *const *) nm_meta_setting_infos_editor_p(), FALSE, NULL, NULL); row = g_new0(NmcOutputField, _NM_META_SETTING_TYPE_NUM + 1); for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) row[i].info = (const NMMetaAbstractInfo *) &nm_meta_setting_infos_editor[i]; print_required_fields(&nmc->nmc_config, &nmc->pager_data, NMC_OF_FLAG_MAIN_HEADER_ONLY, out_indices, header_name, 0, row); } /* Loop through the required settings and print them. */ for (i = 0; i < print_settings_array->len; i++) { NMSetting *setting; int section_idx = nm_g_array_index(print_settings_array, int, i); const char *prop_name = (const char *) g_ptr_array_index(prop_array, i); if (NM_IN_SET(nmc->nmc_config.print_output, NMC_PRINT_NORMAL, NMC_PRINT_PRETTY) && !nmc->nmc_config.multiline_output && was_output) g_print("\n"); /* Empty line */ was_output = FALSE; setting = nm_connection_get_setting_by_name( connection, nm_meta_setting_infos_editor[section_idx].general->setting_name); if (setting) { setting_details(&nmc->nmc_config, setting, prop_name); was_output = TRUE; } } g_array_free(print_settings_array, TRUE); if (prop_array) g_ptr_array_free(prop_array, TRUE); return TRUE; } NMMetaColor nmc_active_connection_state_to_color(NMActiveConnection *ac) { NMActiveConnectionState state; if (NM_FLAGS_HAS(nm_active_connection_get_state_flags(ac), NM_ACTIVATION_STATE_FLAG_EXTERNAL)) return NM_META_COLOR_CONNECTION_EXTERNAL; state = nm_active_connection_get_state(ac); if (state == NM_ACTIVE_CONNECTION_STATE_ACTIVATING) return NM_META_COLOR_CONNECTION_ACTIVATING; else if (state == NM_ACTIVE_CONNECTION_STATE_ACTIVATED) return NM_META_COLOR_CONNECTION_ACTIVATED; else if (state > NM_ACTIVE_CONNECTION_STATE_ACTIVATED) return NM_META_COLOR_CONNECTION_DISCONNECTING; else return NM_META_COLOR_CONNECTION_UNKNOWN; } static gboolean nmc_active_connection_details(NMActiveConnection *acon, NmCli *nmc) { GError *error = NULL; GArray *print_groups; GPtrArray *group_fields = NULL; int i; const char *fields_str = NULL; const char *base_hdr = _("Active connection details"); gboolean was_output = FALSE; if (!nmc->required_fields || g_ascii_strcasecmp(nmc->required_fields, "common") == 0) { /* pass */ } else if (!nmc->required_fields || g_ascii_strcasecmp(nmc->required_fields, "all") == 0) { /* pass */ } else fields_str = nmc->required_fields; print_groups = parse_output_fields( fields_str, (const NMMetaAbstractInfo *const *) nmc_fields_con_active_details_groups, TRUE, &group_fields, &error); if (!print_groups) { g_return_val_if_fail(error, FALSE); g_string_printf(nmc->return_text, _("Error: 'connection show': %s"), error->message); g_error_free(error); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return FALSE; } /* Main header */ { gs_free char *header_name = NULL; gs_free NmcOutputField *row = NULL; gs_unref_array GArray *out_indices = NULL; header_name = construct_header_name(base_hdr, nm_active_connection_get_uuid(acon)); out_indices = parse_output_fields( NULL, (const NMMetaAbstractInfo *const *) nmc_fields_con_active_details_groups, FALSE, NULL, NULL); row = g_new0(NmcOutputField, G_N_ELEMENTS(nmc_fields_con_active_details_groups) + 1); for (i = 0; nmc_fields_con_active_details_groups[i]; i++) row[i].info = (const NMMetaAbstractInfo *) nmc_fields_con_active_details_groups[i]; print_required_fields(&nmc->nmc_config, &nmc->pager_data, NMC_OF_FLAG_MAIN_HEADER_ONLY, out_indices, header_name, 0, row); } /* Loop through the groups and print them. */ for (i = 0; i < print_groups->len; i++) { int group_idx = nm_g_array_index(print_groups, int, i); char *group_fld = (char *) g_ptr_array_index(group_fields, i); if (NM_IN_SET(nmc->nmc_config.print_output, NMC_PRINT_NORMAL, NMC_PRINT_PRETTY) && !nmc->nmc_config.multiline_output && was_output) g_print("\n"); was_output = FALSE; if (nmc_fields_con_active_details_groups[group_idx]->nested == metagen_con_active_general) { gs_free char *f = NULL; if (group_fld) f = g_strdup_printf("GENERAL.%s", group_fld); nmc_print(&nmc->nmc_config, (gpointer[]){acon, NULL}, NULL, NULL, NMC_META_GENERIC_GROUP("GENERAL", metagen_con_active_general, N_("GROUP")), f, NULL); was_output = TRUE; continue; } /* IP4 */ if (g_ascii_strcasecmp(nmc_fields_con_active_details_groups[group_idx]->name, nmc_fields_con_active_details_groups[1]->name) == 0) { gboolean b1 = FALSE; NMIPConfig *cfg4 = nm_active_connection_get_ip4_config(acon); b1 = print_ip_config(cfg4, AF_INET, &nmc->nmc_config, group_fld); was_output = was_output || b1; } /* DHCP4 */ if (g_ascii_strcasecmp(nmc_fields_con_active_details_groups[group_idx]->name, nmc_fields_con_active_details_groups[2]->name) == 0) { gboolean b1 = FALSE; NMDhcpConfig *dhcp4 = nm_active_connection_get_dhcp4_config(acon); b1 = print_dhcp_config(dhcp4, AF_INET, &nmc->nmc_config, group_fld); was_output = was_output || b1; } /* IP6 */ if (g_ascii_strcasecmp(nmc_fields_con_active_details_groups[group_idx]->name, nmc_fields_con_active_details_groups[3]->name) == 0) { gboolean b1 = FALSE; NMIPConfig *cfg6 = nm_active_connection_get_ip6_config(acon); b1 = print_ip_config(cfg6, AF_INET6, &nmc->nmc_config, group_fld); was_output = was_output || b1; } /* DHCP6 */ if (g_ascii_strcasecmp(nmc_fields_con_active_details_groups[group_idx]->name, nmc_fields_con_active_details_groups[4]->name) == 0) { gboolean b1 = FALSE; NMDhcpConfig *dhcp6 = nm_active_connection_get_dhcp6_config(acon); b1 = print_dhcp_config(dhcp6, AF_INET6, &nmc->nmc_config, group_fld); was_output = was_output || b1; } if (nmc_fields_con_active_details_groups[group_idx]->nested == metagen_con_active_vpn) { if (NM_IS_VPN_CONNECTION(acon)) { nmc_print(&nmc->nmc_config, (gpointer[]){acon, NULL}, NULL, NULL, NMC_META_GENERIC_GROUP("VPN", metagen_con_active_vpn, N_("NAME")), group_fld, NULL); was_output = TRUE; } continue; } } g_array_free(print_groups, TRUE); if (group_fields) g_ptr_array_free(group_fields, TRUE); return TRUE; } static gboolean split_required_fields_for_con_show(const char *input, char **profile_flds, char **active_flds, GError **error) { gs_free const char **fields = NULL; const char *const *iter; nm_auto_free_gstring GString *str1 = NULL; nm_auto_free_gstring GString *str2 = NULL; gboolean group_profile = FALSE; gboolean group_active = FALSE; gboolean do_free; if (!input) { *profile_flds = NULL; *active_flds = NULL; return TRUE; } str1 = g_string_new(NULL); str2 = g_string_new(NULL); fields = nm_strsplit_set_with_empty(input, ","); for (iter = fields; iter && *iter; iter++) { char *s_mutable = (char *) (*iter); char *dot; gboolean is_all; gboolean is_common; gboolean found; int i; g_strstrip(s_mutable); dot = strchr(s_mutable, '.'); if (dot) *dot = '\0'; is_all = !dot && g_ascii_strcasecmp(s_mutable, "all") == 0; is_common = !dot && g_ascii_strcasecmp(s_mutable, "common") == 0; found = FALSE; for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) { if (is_all || is_common || !g_ascii_strcasecmp(s_mutable, nm_meta_setting_infos[i].setting_name)) { if (dot) *dot = '.'; g_string_append(str1, s_mutable); g_string_append_c(str1, ','); found = TRUE; break; } } if (found) continue; for (i = 0; nmc_fields_con_active_details_groups[i]; i++) { if (is_all || is_common || !g_ascii_strcasecmp(s_mutable, nmc_fields_con_active_details_groups[i]->name)) { if (dot) *dot = '.'; g_string_append(str2, s_mutable); g_string_append_c(str2, ','); found = TRUE; break; } } if (!found) { if (dot) *dot = '.'; if (!g_ascii_strcasecmp(s_mutable, CON_SHOW_DETAIL_GROUP_PROFILE)) group_profile = TRUE; else if (!g_ascii_strcasecmp(s_mutable, CON_SHOW_DETAIL_GROUP_ACTIVE)) group_active = TRUE; else { gs_free char *allowed1 = nm_meta_abstract_infos_get_names_str( (const NMMetaAbstractInfo *const *) nm_meta_setting_infos_editor_p(), NULL); gs_free char *allowed2 = nm_meta_abstract_infos_get_names_str( (const NMMetaAbstractInfo *const *) nmc_fields_con_active_details_groups, NULL); g_set_error(error, NMCLI_ERROR, 0, _("invalid field '%s'; allowed fields: %s and %s, or %s,%s"), s_mutable, allowed1, allowed2, CON_SHOW_DETAIL_GROUP_PROFILE, CON_SHOW_DETAIL_GROUP_ACTIVE); return FALSE; } } } /* Handle pseudo groups: profile, active */ if (group_profile) { if (str1->len > 0) { g_set_error(error, NMCLI_ERROR, 0, _("'%s' has to be alone"), CON_SHOW_DETAIL_GROUP_PROFILE); return FALSE; } g_string_assign(str1, "all,"); } if (group_active) { if (str2->len > 0) { g_set_error(error, NMCLI_ERROR, 0, _("'%s' has to be alone"), CON_SHOW_DETAIL_GROUP_ACTIVE); return FALSE; } g_string_assign(str2, "all,"); } if (str1->len > 0) g_string_truncate(str1, str1->len - 1); if (str2->len > 0) g_string_truncate(str2, str2->len - 1); do_free = (str1->len == 0); *profile_flds = g_string_free(g_steal_pointer(&str1), do_free); do_free = (str2->len == 0); *active_flds = g_string_free(g_steal_pointer(&str2), do_free); return TRUE; } typedef enum { NMC_SORT_ACTIVE = 1, NMC_SORT_ACTIVE_INV = -1, NMC_SORT_NAME = 2, NMC_SORT_NAME_INV = -2, NMC_SORT_TYPE = 3, NMC_SORT_TYPE_INV = -3, NMC_SORT_PATH = 4, NMC_SORT_PATH_INV = -4, } NmcSortOrder; typedef struct { NmCli *nmc; const GArray *order; gboolean show_active_fields; } ConShowSortInfo; static int con_show_get_items_cmp(gconstpointer pa, gconstpointer pb, gpointer user_data) { const ConShowSortInfo *sort_info = user_data; const MetagenConShowRowData *row_data_a = *((const MetagenConShowRowData *const *) pa); const MetagenConShowRowData *row_data_b = *((const MetagenConShowRowData *const *) pb); NMConnection *c_a = row_data_a->connection; NMConnection *c_b = row_data_b->connection; NMActiveConnection *ac_a = row_data_a->primary_active; NMActiveConnection *ac_b = row_data_b->primary_active; NMActiveConnection *ac_a_effective = sort_info->show_active_fields ? ac_a : NULL; NMActiveConnection *ac_b_effective = sort_info->show_active_fields ? ac_b : NULL; /* first sort active-connections which are invisible, i.e. that have no connection */ if (!c_a && c_b) return -1; if (!c_b && c_a) return 1; /* we have two connections... */ if (c_a && c_b && c_a != c_b) { const NmcSortOrder *order_arr; guint i, order_len; NMMetaAccessorGetType get_type = nmc_print_output_to_accessor_get_type(sort_info->nmc->nmc_config.print_output); if (sort_info->order) { order_arr = nm_g_array_first_p(sort_info->order, NmcSortOrder); order_len = sort_info->order->len; } else { static const NmcSortOrder def[] = {NMC_SORT_ACTIVE, NMC_SORT_NAME, NMC_SORT_PATH}; /* Note: the default order does not consider whether a column is shown. * That means, the selection of the output fields, does not affect the * order (although there could be an argument that it should). */ order_arr = def; order_len = G_N_ELEMENTS(def); } for (i = 0; i < order_len; i++) { NmcSortOrder item = order_arr[i]; switch (item) { case NMC_SORT_ACTIVE: NM_CMP_RETURN(nmc_active_connection_cmp(ac_b, ac_a)); break; case NMC_SORT_ACTIVE_INV: NM_CMP_RETURN(nmc_active_connection_cmp(ac_a, ac_b)); break; case NMC_SORT_TYPE: NM_CMP_DIRECT_STRCMP0(_con_show_fcn_get_type(c_a, ac_a_effective, get_type), _con_show_fcn_get_type(c_b, ac_b_effective, get_type)); break; case NMC_SORT_TYPE_INV: NM_CMP_DIRECT_STRCMP0(_con_show_fcn_get_type(c_b, ac_b_effective, get_type), _con_show_fcn_get_type(c_a, ac_a_effective, get_type)); break; case NMC_SORT_NAME: NM_CMP_RETURN(nm_utf8_collate0(_con_show_fcn_get_id(c_a, ac_a_effective), _con_show_fcn_get_id(c_b, ac_b_effective))); break; case NMC_SORT_NAME_INV: NM_CMP_RETURN(nm_utf8_collate0(_con_show_fcn_get_id(c_b, ac_b_effective), _con_show_fcn_get_id(c_a, ac_a_effective))); break; case NMC_SORT_PATH: NM_CMP_RETURN(nm_utils_dbus_path_cmp(nm_connection_get_path(c_a), nm_connection_get_path(c_b))); break; case NMC_SORT_PATH_INV: NM_CMP_RETURN(nm_utils_dbus_path_cmp(nm_connection_get_path(c_b), nm_connection_get_path(c_a))); break; default: nm_assert_not_reached(); break; } } NM_CMP_DIRECT(!!nmc_connection_check_deprecated(c_a), !!nmc_connection_check_deprecated(c_b)); NM_CMP_DIRECT_STRCMP0(nm_connection_get_uuid(c_a), nm_connection_get_uuid(c_b)); NM_CMP_DIRECT_STRCMP0(nm_connection_get_path(c_a), nm_connection_get_path(c_b)); } NM_CMP_DIRECT_STRCMP0(nm_object_get_path(NM_OBJECT(ac_a)), nm_object_get_path(NM_OBJECT(ac_b))); g_return_val_if_reached(0); } static GPtrArray * con_show_get_items(NmCli *nmc, gboolean active_only, gboolean show_active_fields, GArray *order) { gs_unref_hashtable GHashTable *row_hash = NULL; GHashTableIter hiter; GPtrArray *result; const GPtrArray *arr; NMRemoteConnection *c; MetagenConShowRowData *row_data; guint i; const ConShowSortInfo sort_info = { .nmc = nmc, .order = order, .show_active_fields = show_active_fields, }; row_hash = g_hash_table_new(nm_direct_hash, NULL); arr = nmc_get_connections(nmc); for (i = 0; i < arr->len; i++) { /* Note: libnm will not expose connection that are invisible * to the user but currently inactive. * * That differs from get-active-connection(). If an invisible connection * is active, we can get its NMActiveConnection. We can even obtain * the corresponding NMRemoteConnection (although, of course it has * no visible settings). * * I think this inconsistency is a bug in libnm. Anyway, the result is, * that we print invisible connections if they are active, but otherwise * we exclude them. */ c = arr->pdata[i]; g_hash_table_insert(row_hash, c, _metagen_con_show_row_data_new_for_connection(c, show_active_fields)); } arr = nmc_get_active_connections(nmc); for (i = 0; i < arr->len; i++) { NMActiveConnection *ac = arr->pdata[i]; c = nm_active_connection_get_connection(ac); if (!show_active_fields && !c) { /* the active connection has no connection, and we don't show * any active fields. Skip this row. */ continue; } row_data = c ? g_hash_table_lookup(row_hash, c) : NULL; if (show_active_fields || !c) { /* the active connection either has no connection (in which we create a * connection-less row), or we are interested in showing each active * connection in its own row. Add a row. */ if (row_data) { /* we create a rowdata for this connection earlier. We drop it, because this * connection is tracked via the rowdata of the active connection. */ g_hash_table_remove(row_hash, c); _metagen_con_show_row_data_destroy(row_data); } row_data = _metagen_con_show_row_data_new_for_active_connection(c, ac, show_active_fields); g_hash_table_insert(row_hash, ac, row_data); continue; } /* we add the active connection to the row for the referenced * connection. We need to group them this way, to print the proper * color (activated or not) based on primary_active. */ if (!row_data) { /* this is unexpected. The active connection references a connection that * seemingly no longer exists. It's a bug in libnm. Add a row nonetheless. */ row_data = _metagen_con_show_row_data_new_for_connection(c, show_active_fields); g_hash_table_insert(row_hash, c, row_data); } _metagen_con_show_row_data_add_active_connection(row_data, ac); } result = g_ptr_array_new_with_free_func(_metagen_con_show_row_data_destroy); g_hash_table_iter_init(&hiter, row_hash); while (g_hash_table_iter_next(&hiter, NULL, (gpointer *) &row_data)) { if (active_only && !row_data->primary_active) { /* We only print connections that are active. Skip this row. */ _metagen_con_show_row_data_destroy(row_data); continue; } if (!show_active_fields) { NMSettingConnection *s_con; nm_assert(NM_IS_REMOTE_CONNECTION(row_data->connection)); s_con = nm_connection_get_setting_connection(row_data->connection); if (!s_con || !nm_setting_connection_get_uuid(s_con)) { /* we are in a mode, where we only print rows for connection. * For that we require that all rows are visible to the user, * meaning: the have a [connection] setting and a UUID. * * Otherwise, this connection is likely invisible to the user. * Skip it. */ _metagen_con_show_row_data_destroy(row_data); continue; } _metagen_con_show_row_data_init_primary_active(row_data); } else nm_assert(!row_data->all_active); g_ptr_array_add(result, row_data); } g_ptr_array_sort_with_data(result, con_show_get_items_cmp, (gpointer) &sort_info); return result; } static GArray * parse_preferred_connection_order(const char *order, GError **error) { gs_free const char **strv = NULL; const char *const *iter; const char *str; GArray *order_arr; NmcSortOrder val; gboolean inverse, unique; guint i; strv = nm_strsplit_set(order, ":"); if (!strv) { g_set_error(error, NMCLI_ERROR, 0, _("incorrect string '%s' of '--order' option"), order); return NULL; } order_arr = g_array_sized_new(FALSE, FALSE, sizeof(NmcSortOrder), 4); for (iter = strv; iter && *iter; iter++) { str = *iter; inverse = FALSE; if (str[0] == '-') inverse = TRUE; if (str[0] == '+' || str[0] == '-') str++; if (matches(str, "active")) val = inverse ? NMC_SORT_ACTIVE_INV : NMC_SORT_ACTIVE; else if (matches(str, "name")) val = inverse ? NMC_SORT_NAME_INV : NMC_SORT_NAME; else if (matches(str, "type")) val = inverse ? NMC_SORT_TYPE_INV : NMC_SORT_TYPE; else if (matches(str, "path")) val = inverse ? NMC_SORT_PATH_INV : NMC_SORT_PATH; else { g_array_unref(order_arr); order_arr = NULL; g_set_error(error, NMCLI_ERROR, 0, _("incorrect item '%s' in '--order' option"), *iter); break; } /* Check for duplicates and ignore them. */ unique = TRUE; for (i = 0; i < order_arr->len; i++) { if (abs(nm_g_array_index(order_arr, NmcSortOrder, i)) - abs(val) == 0) { unique = FALSE; break; } } /* Value is ok and unique, add it to the array */ if (unique) g_array_append_val(order_arr, val); } return order_arr; } static NMConnection * get_connection(NmCli *nmc, int *argc, const char *const **argv, const char **out_selector, const char **out_value, GPtrArray **out_result, GError **error) { const GPtrArray *connections; NMConnection *connection = NULL; const char *selector = NULL; NM_SET_OUT(out_selector, NULL); NM_SET_OUT(out_value, NULL); if (nmc->offline_connections && nmc->offline_connections->len) return nmc->offline_connections->pdata[0]; g_return_val_if_fail(!nmc->offline, NULL); if (*argc == 0) { g_set_error_literal(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("No connection specified")); return NULL; } if (*argc == 1 && nmc->complete) nmc_complete_strings(**argv, "id", "uuid", "path", "filename"); if (NM_IN_STRSET(**argv, "id", "uuid", "path", "filename")) { if (*argc == 1) { if (!nmc->complete) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("%s argument is missing"), selector); return NULL; } } else { selector = **argv; (*argv)++; (*argc)--; } } NM_SET_OUT(out_selector, selector); NM_SET_OUT(out_value, **argv); connections = nm_client_get_connections(nmc->client); connection = nmc_find_connection(connections, selector, **argv, out_result, *argc == 1 && nmc->complete); if (!connection) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_NOT_FOUND, _("unknown connection '%s'"), **argv); } next_arg(nmc, argc, argv, NULL); return connection; } static void do_connections_show(const NMCCommand *cmd, NmCli *nmc, int argc, const char *const *argv) { gs_free_error GError *err = NULL; gs_free char *profile_flds = NULL; gs_free char *active_flds = NULL; gboolean active_only = FALSE; gs_unref_array GArray *order = NULL; guint i; int option; /* check connection show options [--active] [--order ] */ while ((option = next_arg(nmc, &argc, &argv, "--active", "--order", NULL)) > 0) { switch (option) { case 1: /* --active */ active_only = TRUE; break; case 2: /* --order */ argc--; argv++; if (!argc) { g_set_error_literal(&err, NMCLI_ERROR, 0, _("'--order' argument is missing")); goto finish; } order = parse_preferred_connection_order(*argv, &err); if (err) goto finish; break; default: g_return_if_reached(); break; } } if (argc == 0) { const char *fields_str = NULL; gs_unref_ptrarray GPtrArray *items = NULL; gs_free NMMetaSelectionResultList *selection = NULL; gboolean show_active_fields = TRUE; if (nmc->complete) goto finish; if (!nmc->required_fields || g_ascii_strcasecmp(nmc->required_fields, "common") == 0) fields_str = NMC_FIELDS_CON_SHOW_COMMON; else if (!nmc->required_fields || g_ascii_strcasecmp(nmc->required_fields, "all") == 0) { /* pass */ } else fields_str = nmc->required_fields; /* determine whether the user wants to see any fields that are related to active-connections * (e.g. the apath, the current state, or the device where the profile is active). * * If that's the case, then we will show one line for each active connection. In case * a profile has multiple active connections, it will be listed multiple times. * If that's not the case, we filter out these duplicate lines. */ selection = nm_meta_selection_create_parse_list( (const NMMetaAbstractInfo *const *) metagen_con_show, fields_str, FALSE, NULL); if (selection && selection->num > 0) { show_active_fields = FALSE; for (i = 0; i < selection->num; i++) { const NmcMetaGenericInfo *info = (const NmcMetaGenericInfo *) selection->items[i].info; if (NM_IN_SET(info->info_type, NMC_GENERIC_INFO_TYPE_CON_SHOW_DEVICE, NMC_GENERIC_INFO_TYPE_CON_SHOW_STATE, NMC_GENERIC_INFO_TYPE_CON_SHOW_ACTIVE, NMC_GENERIC_INFO_TYPE_CON_SHOW_ACTIVE_PATH)) { show_active_fields = TRUE; break; } } } nm_cli_spawn_pager(&nmc->nmc_config, &nmc->pager_data); items = con_show_get_items(nmc, active_only, show_active_fields, order); g_ptr_array_add(items, NULL); if (!nmc_print(&nmc->nmc_config, items->pdata, NULL, active_only ? _("NetworkManager active profiles") : _("NetworkManager connection profiles"), (const NMMetaAbstractInfo *const *) metagen_con_show, fields_str, &err)) goto finish; } else { gboolean new_line = FALSE; gboolean without_fields = (nmc->required_fields == NULL); const GPtrArray *active_cons = nmc_get_active_connections(nmc); /* multiline mode is default for 'connection show ' */ if (!nmc->mode_specified) nmc->nmc_config_mutable.multiline_output = TRUE; /* Split required fields into the settings and active ones. */ if (!split_required_fields_for_con_show(nmc->required_fields, &profile_flds, &active_flds, &err)) goto finish; nm_clear_g_free(&nmc->required_fields); /* Before printing the connections check if we have a "--show-secret" * option after the connection ids */ if (!nmc->nmc_config.show_secrets && !nmc->complete) { int argc_cp = argc; const char *const *argv_cp = argv; do { if (NM_IN_STRSET(*argv_cp, "id", "uuid", "path", "filename", "apath")) { argc_cp--; argv_cp++; } } while (next_arg(nmc, &argc_cp, &argv_cp, NULL) != -1); } while (argc > 0) { const GPtrArray *connections; gboolean res; NMConnection *con; gs_unref_object NMActiveConnection *explicit_acon = NULL; const char *selector = NULL; gs_unref_ptrarray GPtrArray *found_cons = NULL; gboolean explicit_acon_handled = FALSE; guint i_found_cons; if (argc == 1 && nmc->complete) nmc_complete_strings(*argv, "id", "uuid", "path", "filename", "apath"); if (NM_IN_STRSET(*argv, "id", "uuid", "path", "filename", "apath")) { selector = *argv; argc--; argv++; if (!argc) { g_string_printf(nmc->return_text, _("Error: %s argument is missing."), *(argv - 1)); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; goto finish; } } /* Try to find connection by id, uuid or path first */ connections = nmc_get_connections(nmc); con = nmc_find_connection(connections, selector, *argv, &found_cons, argc == 1 && nmc->complete); if (!con && NM_IN_STRSET(selector, NULL, "apath")) { /* Try apath too */ explicit_acon = nmc_find_active_connection(active_cons, "apath", *argv, NULL, argc == 1 && nmc->complete); if (explicit_acon) { if (!selector && !nm_streq0(*argv, nm_object_get_path(NM_OBJECT(explicit_acon)))) { /* we matched the apath based on the last component alone (note the full D-Bus path). * That is how nmc_find_active_connection() works, if you pass in a selector. * Reject it. */ explicit_acon = NULL; } nm_g_object_ref(explicit_acon); } } if (!con && !explicit_acon) { g_string_printf(nmc->return_text, _("Error: %s - no such connection profile."), *argv); nmc->return_value = NMC_RESULT_ERROR_NOT_FOUND; goto finish; } /* Print connection details: * Usually we have both static and active connection. * But when a connection is private to a user, another user * may see only the active connection. */ if (nmc->complete) { next_arg(nmc, &argc, &argv, NULL); continue; } explicit_acon_handled = FALSE; i_found_cons = 0; for (;;) { gs_unref_ptrarray GPtrArray *found_acons = NULL; if (explicit_acon) { if (explicit_acon_handled) break; explicit_acon_handled = TRUE; /* the user referenced an "apath". In this case, we can only have at most one connection * and one apath. */ con = NM_CONNECTION(nm_active_connection_get_connection(explicit_acon)); } else { if (i_found_cons >= found_cons->len) break; con = found_cons->pdata[i_found_cons++]; get_ac_for_connection(active_cons, con, &found_acons); } if (active_only && !explicit_acon && !found_acons) { /* this connection is not interesting, we only print active ones. */ continue; } nm_assert(explicit_acon || con); if (new_line) g_print("\n"); new_line = TRUE; if (without_fields || profile_flds) { if (con) { nmc->required_fields = profile_flds; if (nmc->nmc_config.show_secrets) update_secrets_in_connection(NM_REMOTE_CONNECTION(con), con); res = nmc_connection_profile_details(con, nmc); nmc->required_fields = NULL; if (!res) goto finish; } } if (without_fields || active_flds) { guint l = explicit_acon ? 1 : (found_acons ? found_acons->len : 0); for (i = 0; i < l; i++) { NMActiveConnection *acon; if (i > 0) { /* if there are multiple active connections, separate them with newline. * that is a bit odd, because we already separate connections with newlines, * and commonly don't separate the connection from the first active connection. */ g_print("\n"); } if (explicit_acon) acon = explicit_acon; else acon = found_acons->pdata[i]; nmc->required_fields = active_flds; res = nmc_active_connection_details(acon, nmc); nmc->required_fields = NULL; if (!res) goto finish; } } } next_arg(nmc, &argc, &argv, NULL); } } finish: if (err) { g_string_printf(nmc->return_text, _("Error: %s."), err->message); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; } } static NMActiveConnection * get_default_active_connection(NmCli *nmc, NMDevice **device) { NMActiveConnection *default_ac = NULL; NMDevice *non_default_device = NULL; NMActiveConnection *non_default_ac = NULL; const GPtrArray *connections; guint i; g_return_val_if_fail(nmc, NULL); g_return_val_if_fail(device, NULL); g_return_val_if_fail(*device == NULL, NULL); connections = nmc_get_active_connections(nmc); for (i = 0; i < connections->len; i++) { NMActiveConnection *candidate = g_ptr_array_index(connections, i); const GPtrArray *devices; devices = nm_active_connection_get_devices(candidate); if (!devices->len) continue; if (nm_active_connection_get_default(candidate)) { if (!default_ac) { *device = g_ptr_array_index(devices, 0); default_ac = candidate; } } else { if (!non_default_ac) { non_default_device = g_ptr_array_index(devices, 0); non_default_ac = candidate; } } } /* Prefer the default connection if one exists, otherwise return the first * non-default connection. */ if (!default_ac && non_default_ac) { default_ac = non_default_ac; *device = non_default_device; } return default_ac; } /* Find a device to activate the connection on. * IN: connection: connection to activate * iface: device interface name to use (optional) * ap: access point to use (optional; valid just for 802-11-wireless) * nsp: Network Service Provider to use (option; valid only for wimax) * OUT: device: found device * spec_object: specific_object path of NMAccessPoint * RETURNS: TRUE when a device is found, FALSE otherwise. */ static gboolean find_device_for_connection(NmCli *nmc, NMConnection *connection, const char *iface, const char *ap, const char *nsp, NMDevice **device, const char **spec_object, GError **error) { NMSettingConnection *s_con; const char *con_type; guint i, j; g_return_val_if_fail(nmc, FALSE); g_return_val_if_fail(iface || ap || nsp, FALSE); g_return_val_if_fail(device && *device == NULL, FALSE); g_return_val_if_fail(spec_object && *spec_object == NULL, FALSE); g_return_val_if_fail(error == NULL || *error == NULL, FALSE); s_con = nm_connection_get_setting_connection(connection); g_return_val_if_fail(s_con, FALSE); con_type = nm_setting_connection_get_connection_type(s_con); if (nm_streq(con_type, NM_SETTING_VPN_SETTING_NAME)) { /* VPN connections */ NMActiveConnection *active = NULL; if (iface) { *device = nm_client_get_device_by_iface(nmc->client, iface); if (*device) active = nm_device_get_active_connection(*device); if (!active) { g_set_error(error, NMCLI_ERROR, 0, _("no active connection on device '%s'"), iface); return FALSE; } *spec_object = nm_object_get_path(NM_OBJECT(active)); return TRUE; } else { active = get_default_active_connection(nmc, device); if (!active) { g_set_error_literal(error, NMCLI_ERROR, 0, _("no active connection or device")); return FALSE; } *spec_object = nm_object_get_path(NM_OBJECT(active)); return TRUE; } } else { /* Other connections */ NMDevice *found_device = NULL; const GPtrArray *devices = nm_client_get_devices(nmc->client); gboolean found_device_with_name = FALSE; for (i = 0; i < devices->len && !found_device; i++) { NMDevice *dev = g_ptr_array_index(devices, i); if (iface) { const char *dev_iface = nm_device_get_iface(dev); if (!nm_streq0(dev_iface, iface)) continue; found_device_with_name = TRUE; if (!nm_device_connection_compatible(dev, connection, error)) { g_prefix_error(error, _("device '%s' not compatible with connection '%s': "), iface, nm_setting_connection_get_id(s_con)); return FALSE; } } else { if (!nm_device_connection_compatible(dev, connection, NULL)) continue; } found_device = dev; if (ap && nm_streq(con_type, NM_SETTING_WIRELESS_SETTING_NAME) && NM_IS_DEVICE_WIFI(dev)) { gs_free char *bssid_up = g_ascii_strup(ap, -1); const GPtrArray *aps = nm_device_wifi_get_access_points(NM_DEVICE_WIFI(dev)); found_device = NULL; /* Mark as not found; set to the device again later, only if AP matches */ for (j = 0; j < aps->len; j++) { NMAccessPoint *candidate_ap = g_ptr_array_index(aps, j); const char *candidate_bssid = nm_access_point_get_bssid(candidate_ap); if (nm_streq0(bssid_up, candidate_bssid)) { found_device = dev; *spec_object = nm_object_get_path(NM_OBJECT(candidate_ap)); break; } } } } if (!found_device) { if (iface) { if (found_device_with_name) { g_set_error(error, NMCLI_ERROR, 0, _("device '%s' not compatible with connection '%s'"), iface, nm_setting_connection_get_id(s_con)); } else { g_set_error(error, NMCLI_ERROR, 0, _("device '%s' not found for connection '%s'"), iface, nm_setting_connection_get_id(s_con)); } } else { g_set_error(error, NMCLI_ERROR, 0, _("no device found for connection '%s'"), nm_setting_connection_get_id(s_con)); } return FALSE; } *device = found_device; return TRUE; } } typedef struct { NmCli *nmc; NMDevice *device; NMActiveConnection *active; } ActivateConnectionInfo; static void active_connection_hint(GString *return_text, NMActiveConnection *active, NMDevice *device) { NMRemoteConnection *connection; nm_auto_free_gstring GString *hint = NULL; const GPtrArray *devices; guint i; if (!active) return; if (!nm_streq(NM_CONFIG_DEFAULT_LOGGING_BACKEND, "journal")) return; connection = nm_active_connection_get_connection(active); g_return_if_fail(connection); hint = g_string_new("journalctl -xe "); g_string_append_printf(hint, "NM_CONNECTION=%s", nm_connection_get_uuid(NM_CONNECTION(connection))); if (device) g_string_append_printf(hint, " + NM_DEVICE=%s", nm_device_get_iface(device)); else { devices = nm_active_connection_get_devices(active); for (i = 0; i < devices->len; i++) { g_string_append_printf(hint, " + NM_DEVICE=%s", nm_device_get_iface(NM_DEVICE(g_ptr_array_index(devices, i)))); } } g_string_append(return_text, "\n"); g_string_append_printf(return_text, _("Hint: use '%s' to get more details."), hint->str); } static void activate_connection_info_finish(ActivateConnectionInfo *info); static void check_activated(ActivateConnectionInfo *info) { NMActiveConnectionState ac_state; NmCli *nmc = info->nmc; const char *reason = NULL; ac_state = nmc_activation_get_effective_state(info->active, info->device, &reason); switch (ac_state) { case NM_ACTIVE_CONNECTION_STATE_ACTIVATED: if (nmc->nmc_config.print_output == NMC_PRINT_PRETTY) nmc_terminal_erase_line(); if (reason) { g_print(_("Connection successfully activated (%s) (D-Bus active path: %s)\n"), reason, nm_object_get_path(NM_OBJECT(info->active))); } else { g_print(_("Connection successfully activated (D-Bus active path: %s)\n"), nm_object_get_path(NM_OBJECT(info->active))); } activate_connection_info_finish(info); break; case NM_ACTIVE_CONNECTION_STATE_DEACTIVATED: nm_assert(reason); g_string_printf(nmc->return_text, _("Error: Connection activation failed: %s"), reason); active_connection_hint(nmc->return_text, info->active, info->device); nmc->return_value = NMC_RESULT_ERROR_CON_ACTIVATION; activate_connection_info_finish(info); break; case NM_ACTIVE_CONNECTION_STATE_ACTIVATING: if (nmc->secret_agent) { NMRemoteConnection *connection = nm_active_connection_get_connection(info->active); nm_secret_agent_simple_enable(nmc->secret_agent, nm_connection_get_path(NM_CONNECTION(connection))); } break; default: break; } } static void device_state_cb(NMDevice *device, GParamSpec *pspec, ActivateConnectionInfo *info) { check_activated(info); } static void active_connection_state_cb(NMActiveConnection *active, NMActiveConnectionState state, NMActiveConnectionStateReason reason, ActivateConnectionInfo *info) { check_activated(info); } static void set_nmc_error_timeout(NmCli *nmc) { g_string_printf(nmc->return_text, _("Error: Timeout expired (%d seconds)"), nmc->timeout); nmc->return_value = NMC_RESULT_ERROR_TIMEOUT_EXPIRED; } static gboolean activate_connection_timeout_cb(gpointer user_data) { ActivateConnectionInfo *info = user_data; /* Time expired -> exit nmcli */ set_nmc_error_timeout(info->nmc); activate_connection_info_finish(info); return FALSE; } static gboolean progress_cb(gpointer user_data) { const char *str = (const char *) user_data; nmc_terminal_show_progress(str); return TRUE; } static gboolean progress_active_connection_cb(gpointer user_data) { NMActiveConnection *active = user_data; const char *str; NMDevice *device; NMActiveConnectionState ac_state; const GPtrArray *ac_devs; ac_state = nm_active_connection_get_state(active); if (ac_state == NM_ACTIVE_CONNECTION_STATE_ACTIVATING) { /* If the connection is activating, the device state * is more interesting. */ ac_devs = nm_active_connection_get_devices(active); device = ac_devs->len > 0 ? g_ptr_array_index(ac_devs, 0) : NULL; } else { device = NULL; } str = device ? gettext(nmc_device_state_to_string_with_external(device)) : active_connection_state_to_string(ac_state); nmc_terminal_show_progress(str); return TRUE; } static void activate_connection_info_finish(ActivateConnectionInfo *info) { if (info->device) { g_signal_handlers_disconnect_by_func(info->device, G_CALLBACK(device_state_cb), info); g_object_unref(info->device); } if (info->active) { g_signal_handlers_disconnect_by_func(info->active, G_CALLBACK(active_connection_state_cb), info); g_object_unref(info->active); } g_free(info); quit(); } static void activate_connection_cb(GObject *client, GAsyncResult *result, gpointer user_data) { ActivateConnectionInfo *info = (ActivateConnectionInfo *) user_data; NmCli *nmc = info->nmc; NMDevice *device = info->device; NMActiveConnection *active; NMActiveConnectionState state; const GPtrArray *ac_devs; GError *error = NULL; info->active = active = nm_client_activate_connection_finish(NM_CLIENT(client), result, &error); if (error) { g_string_printf(nmc->return_text, _("Error: Connection activation failed: %s"), error->message); g_error_free(error); active_connection_hint(nmc->return_text, info->active, info->device); nmc->return_value = NMC_RESULT_ERROR_CON_ACTIVATION; activate_connection_info_finish(info); } else { state = nm_active_connection_get_state(active); if (!device && !nm_active_connection_get_vpn(active)) { /* device could be NULL for virtual devices. Fill it here. */ ac_devs = nm_active_connection_get_devices(active); device = ac_devs->len > 0 ? g_ptr_array_index(ac_devs, 0) : NULL; if (device) info->device = g_object_ref(device); } if (nmc->nowait_flag || state == NM_ACTIVE_CONNECTION_STATE_ACTIVATED) { /* User doesn't want to wait or already activated */ if (state == NM_ACTIVE_CONNECTION_STATE_ACTIVATED) { if (nmc->nmc_config.print_output == NMC_PRINT_PRETTY) nmc_terminal_erase_line(); g_print(_("Connection successfully activated (D-Bus active path: %s)\n"), nm_object_get_path(NM_OBJECT(active))); } activate_connection_info_finish(info); } else { /* Monitor the active connection and device (if available) states */ g_signal_connect(active, "state-changed", G_CALLBACK(active_connection_state_cb), info); if (device) g_signal_connect(device, "notify::" NM_DEVICE_STATE, G_CALLBACK(device_state_cb), info); /* Both active_connection_state_cb () and device_state_cb () will just * call check_activated (info). So, just call it once directly after * connecting on both the signals of the objects and skip the call to * the callbacks. */ check_activated(info); /* Start progress indication showing VPN states */ if (nmc->nmc_config.print_output == NMC_PRINT_PRETTY) { if (progress_id) g_source_remove(progress_id); progress_id = g_timeout_add(120, progress_active_connection_cb, active); } /* Start timer not to loop forever when signals are not emitted */ g_timeout_add_seconds(nmc->timeout, activate_connection_timeout_cb, info); } } } static gboolean nmc_activate_connection(NmCli *nmc, NMConnection *connection, const char *ifname, const char *ap, const char *nsp, const char *pwds, GAsyncReadyCallback callback, GError **error) { ActivateConnectionInfo *info; GHashTable *pwds_hash; NMDevice *device = NULL; const char *spec_object = NULL; gboolean device_found; g_return_val_if_fail(nmc, FALSE); g_return_val_if_fail(error == NULL || *error == NULL, FALSE); if (connection && (ifname || ap || nsp)) { gs_free_error GError *local = NULL; device_found = find_device_for_connection(nmc, connection, ifname, ap, nsp, &device, &spec_object, &local); if (!device_found) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_CON_ACTIVATION, "%s", local->message); return FALSE; } } else if (ifname) { device = nm_client_get_device_by_iface(nmc->client, ifname); if (!device) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_NOT_FOUND, _("unknown device '%s'."), ifname); return FALSE; } } else if (!connection) { g_set_error_literal(error, NMCLI_ERROR, NMC_RESULT_ERROR_NOT_FOUND, _("neither a valid connection nor device given")); return FALSE; } /* Parse passwords given in passwords file */ { gs_free_error GError *local = NULL; gssize error_line; pwds_hash = nmc_utils_read_passwd_file(pwds, &error_line, &local); if (!pwds_hash) { if (error_line >= 0) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("invalid passwd-file '%s' at line %zd: %s"), pwds, error_line, local->message); } else { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("invalid passwd-file '%s': %s"), pwds, local->message); } return FALSE; } } if (nmc->pwds_hash) g_hash_table_destroy(nmc->pwds_hash); nmc->pwds_hash = pwds_hash; nmc->secret_agent = nm_secret_agent_simple_new("nmcli-connect"); if (nmc->secret_agent) { g_signal_connect(nmc->secret_agent, NM_SECRET_AGENT_SIMPLE_REQUEST_SECRETS, G_CALLBACK(nmc_secrets_requested), nmc); } info = g_malloc0(sizeof(ActivateConnectionInfo)); info->nmc = nmc; if (device) info->device = g_object_ref(device); nm_client_activate_connection_async(nmc->client, connection, device, spec_object, NULL, callback, info); return TRUE; } static void do_connection_up(const NMCCommand *cmd, NmCli *nmc, int argc, const char *const *argv) { NMConnection *connection = NULL; const char *ifname = NULL; const char *ap = NULL; const char *nsp = NULL; const char *pwds = NULL; gs_free_error GError *error = NULL; gs_strfreev char **arg_arr = NULL; int arg_num; const char *const **argv_ptr; int *argc_ptr; /* * Set default timeout for connection activation. * Activation can take quite a long time, use 90 seconds. */ if (nmc->timeout == -1) nmc->timeout = 90; next_arg(nmc, &argc, &argv, NULL); argv_ptr = &argv; argc_ptr = &argc; if (argc == 0 && nmc->ask) { gs_free char *line = NULL; /* nmc_do_cmd() should not call this with argc=0. */ g_return_if_fail(!nmc->complete); line = nmc_readline(&nmc->nmc_config, PROMPT_CONNECTION); nmc_string_to_arg_array(line, NULL, TRUE, &arg_arr, &arg_num); argv_ptr = (const char *const **) &arg_arr; argc_ptr = &arg_num; } if (argc > 0 && !nm_streq(*argv, "ifname")) { connection = get_connection(nmc, argc_ptr, argv_ptr, NULL, NULL, NULL, &error); if (!connection) { g_string_printf(nmc->return_text, _("Error: %s."), error->message); nmc->return_value = error->code; return; } } while (argc > 0) { if (argc == 1 && nmc->complete) nmc_complete_strings(*argv, "ifname", "ap", "passwd-file"); if (nm_streq(*argv, "ifname")) { argc--; argv++; if (!argc) { g_string_printf(nmc->return_text, _("Error: %s argument is missing."), *(argv - 1)); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return; } ifname = *argv; if (argc == 1 && nmc->complete) nmc_complete_device(nmc->client, ifname, ap != NULL); } else if (nm_streq(*argv, "ap")) { argc--; argv++; if (!argc) { g_string_printf(nmc->return_text, _("Error: %s argument is missing."), *(argv - 1)); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return; } ap = *argv; if (argc == 1 && nmc->complete) nmc_complete_bssid(nmc->client, ifname, ap); } else if (nm_streq(*argv, "passwd-file")) { argc--; argv++; if (!argc) { g_string_printf(nmc->return_text, _("Error: %s argument is missing."), *(argv - 1)); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return; } if (argc == 1 && nmc->complete) nmc->return_value = NMC_RESULT_COMPLETE_FILE; pwds = *argv; } else if (!nmc->complete) { g_string_printf(nmc->return_text, _("Error: invalid extra argument '%s'."), *argv); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return; } next_arg(nmc, &argc, &argv, NULL); } if (nmc->complete) return; /* Use nowait_flag instead of should_wait because exiting has to be postponed till * active_connection_state_cb() is called. That gives NM time to check our permissions * and we can follow activation progress. */ nmc->nowait_flag = (nmc->timeout == 0); nmc->should_wait++; if (!nmc_activate_connection(nmc, connection, ifname, ap, nsp, pwds, activate_connection_cb, &error)) { g_string_printf(nmc->return_text, _("Error: %s."), error->message); nmc->should_wait--; nmc->return_value = error->code; return; } /* Start progress indication */ if (nmc->nmc_config.print_output == NMC_PRINT_PRETTY) progress_id = g_timeout_add(120, progress_cb, _("preparing")); } /*****************************************************************************/ typedef struct { NmCli *nmc; /* a list of object that is relevant for the callback. The object * type differs, and depends on the type of callback. */ GPtrArray *obj_list; guint timeout_id; GCancellable *cancellable; } ConnectionCbInfo; static void connection_removed_cb(NMClient *client, NMConnection *connection, ConnectionCbInfo *info); static void down_active_connection_state_cb(NMActiveConnection *active, GParamSpec *pspec, ConnectionCbInfo *info); static void connection_cb_info_obj_list_destroy(ConnectionCbInfo *info, gpointer obj) { nm_assert(info); nm_assert(info->obj_list); nm_assert(G_IS_OBJECT(obj)); g_signal_handlers_disconnect_by_func(obj, down_active_connection_state_cb, info); g_object_unref(obj); } static gssize connection_cb_info_obj_list_idx(ConnectionCbInfo *info, gpointer obj) { guint i; nm_assert(info); nm_assert(info->obj_list); nm_assert(G_IS_OBJECT(obj)); for (i = 0; i < info->obj_list->len; i++) { if (info->obj_list->pdata[i] == obj) return i; } return -1; } static gpointer connection_cb_info_obj_list_has(ConnectionCbInfo *info, gpointer obj) { gssize idx; idx = connection_cb_info_obj_list_idx(info, obj); if (idx >= 0) return info->obj_list->pdata[idx]; return NULL; } static gpointer connection_cb_info_obj_list_steal(ConnectionCbInfo *info, gpointer obj) { gssize idx; idx = connection_cb_info_obj_list_idx(info, obj); if (idx >= 0) { g_ptr_array_remove_index(info->obj_list, idx); return obj; } return NULL; } static void connection_cb_info_finish(ConnectionCbInfo *info, gpointer obj) { if (obj) { obj = connection_cb_info_obj_list_steal(info, obj); if (obj) connection_cb_info_obj_list_destroy(info, obj); } else { while (info->obj_list->len > 0) { obj = info->obj_list->pdata[info->obj_list->len - 1]; g_ptr_array_remove_index(info->obj_list, info->obj_list->len - 1); connection_cb_info_obj_list_destroy(info, obj); } } if (info->obj_list->len > 0) return; nm_clear_g_source(&info->timeout_id); nm_clear_g_cancellable(&info->cancellable); g_ptr_array_free(info->obj_list, TRUE); g_signal_handlers_disconnect_by_func(info->nmc->client, connection_removed_cb, info); g_slice_free(ConnectionCbInfo, info); quit(); } /*****************************************************************************/ static void connection_removed_cb(NMClient *client, NMConnection *connection, ConnectionCbInfo *info) { if (!connection_cb_info_obj_list_has(info, connection)) return; g_print(_("Connection '%s' (%s) successfully deleted.\n"), nm_connection_get_id(connection), nm_connection_get_uuid(connection)); connection_cb_info_finish(info, connection); } static void down_active_connection_state_cb(NMActiveConnection *active, GParamSpec *pspec, ConnectionCbInfo *info) { if (nm_active_connection_get_state(active) < NM_ACTIVE_CONNECTION_STATE_DEACTIVATED) return; if (info->nmc->nmc_config.print_output == NMC_PRINT_PRETTY) nmc_terminal_erase_line(); g_print(_("Connection '%s' successfully deactivated (D-Bus active path: %s)\n"), nm_active_connection_get_id(active), nm_object_get_path(NM_OBJECT(active))); g_signal_handlers_disconnect_by_func(G_OBJECT(active), down_active_connection_state_cb, info); connection_cb_info_finish(info, active); } static gboolean connection_op_timeout_cb(gpointer user_data) { ConnectionCbInfo *info = user_data; set_nmc_error_timeout(info->nmc); connection_cb_info_finish(info, NULL); return G_SOURCE_REMOVE; } static void do_connection_down(const NMCCommand *cmd, NmCli *nmc, int argc, const char *const *argv) { NMActiveConnection *active; ConnectionCbInfo *info = NULL; const GPtrArray *active_cons; gs_strfreev char **arg_arr = NULL; const char *const *arg_ptr; int arg_num; guint i; gs_unref_ptrarray GPtrArray *found_active_cons = NULL; if (nmc->timeout == -1) nmc->timeout = 10; next_arg(nmc, &argc, &argv, NULL); arg_ptr = argv; arg_num = argc; if (argc == 0) { /* nmc_do_cmd() should not call this with argc=0. */ g_return_if_fail(!nmc->complete); if (nmc->ask) { gs_free char *line = NULL; line = nmc_readline(&nmc->nmc_config, PROMPT_ACTIVE_CONNECTIONS); nmc_string_to_arg_array(line, NULL, TRUE, &arg_arr, &arg_num); arg_ptr = (const char *const *) arg_arr; } if (arg_num == 0) { g_string_printf(nmc->return_text, _("Error: No connection specified.")); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return; } } /* Get active connections */ active_cons = nmc_get_active_connections(nmc); while (arg_num > 0) { const char *selector = NULL; if (arg_num == 1 && nmc->complete) nmc_complete_strings(*arg_ptr, "id", "uuid", "path", "filename", "apath"); if (NM_IN_STRSET(*arg_ptr, "id", "uuid", "path", "filename", "apath")) { selector = *arg_ptr; arg_num--; arg_ptr++; if (!arg_num) { g_string_printf(nmc->return_text, _("Error: %s argument is missing."), selector); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; return; } } active = nmc_find_active_connection(active_cons, selector, *arg_ptr, &found_active_cons, arg_num == 1 && nmc->complete); if (!active) { if (!nmc->complete) g_printerr(_("Error: '%s' is not an active connection.\n"), *arg_ptr); g_string_printf(nmc->return_text, _("Error: not all active connections found.")); nmc->return_value = NMC_RESULT_ERROR_NOT_FOUND; } next_arg(nmc->ask ? NULL : nmc, &arg_num, &arg_ptr, NULL); } if (!found_active_cons) { g_string_printf(nmc->return_text, _("Error: no active connection provided.")); nmc->return_value = NMC_RESULT_ERROR_NOT_FOUND; return; } nm_assert(found_active_cons->len > 0); if (nmc->complete) return; if (nmc->timeout > 0) { nmc->should_wait++; info = g_slice_new0(ConnectionCbInfo); info->nmc = nmc; info->obj_list = g_ptr_array_sized_new(found_active_cons->len); for (i = 0; i < found_active_cons->len; i++) { active = found_active_cons->pdata[i]; g_ptr_array_add(info->obj_list, g_object_ref(active)); g_signal_connect(active, "notify::" NM_ACTIVE_CONNECTION_STATE, G_CALLBACK(down_active_connection_state_cb), info); } info->timeout_id = g_timeout_add_seconds(nmc->timeout, connection_op_timeout_cb, info); } for (i = 0; i < found_active_cons->len; i++) { GError *error = NULL; active = found_active_cons->pdata[i]; if (!nm_client_deactivate_connection(nmc->client, active, NULL, &error)) { g_print(_("Connection '%s' deactivation failed: %s\n"), nm_active_connection_get_id(active), error->message); g_clear_error(&error); if (info) { /* coverity thinks that info might be freed already while we still iterate * the loop. But it cannot, because connection_cb_info_finish() only does some * kind of ref-counting that ensures info stays alive long enough. */ /* coverity[pass_freed_arg] */ g_signal_handlers_disconnect_by_func(active, down_active_connection_state_cb, info); connection_cb_info_finish(info, active); } } } } /*****************************************************************************/ /* * Return the most appropriate name for the connection of a type 'name' possibly with given 'slave_type' * if exists, else return the 'name'. The returned string must not be freed. */ static const char * get_name_alias_toplevel(const char *name, const char *slave_type) { const NMMetaSettingInfoEditor *setting_info; if (slave_type) { const char *slave_name; if (nm_meta_setting_info_valid_parts_for_slave_type(slave_type, &slave_name)) return slave_name ?: name; return name; } setting_info = nm_meta_setting_info_editor_find_by_name(name, FALSE); if (setting_info) return setting_info->alias ?: setting_info->general->setting_name; return name; } /* * Construct a string with names and aliases from the arrays formatted as: * "name (alias), name, name (alias), name, name" * * Returns: string; the caller is responsible for freeing it. */ static char * get_valid_options_string(const NMMetaSettingValidPartItem *const *array, const NMMetaSettingValidPartItem *const *array_slv) { const NMMetaSettingValidPartItem *const *iter = array; GString *str; int i; str = g_string_sized_new(150); for (i = 0; i < 2; i++, iter = array_slv) { for (; iter && *iter; iter++) { const NMMetaSettingInfoEditor *setting_info = (*iter)->setting_info; if (str->len) g_string_append(str, ", "); if (setting_info->alias) g_string_append_printf(str, "%s (%s)", setting_info->general->setting_name, setting_info->alias); else g_string_append(str, setting_info->general->setting_name); } } return g_string_free(str, FALSE); } static char * get_valid_options_string_toplevel(void) { GString *str; int i; str = g_string_sized_new(150); for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) { const NMMetaSettingInfoEditor *setting_info = &nm_meta_setting_infos_editor[i]; if (!setting_info->valid_parts) continue; if (str->len) g_string_append(str, ", "); if (setting_info->alias) g_string_append_printf(str, "%s (%s)", setting_info->general->setting_name, setting_info->alias); else g_string_append(str, setting_info->general->setting_name); } if (str->len) g_string_append(str, ", "); g_string_append(str, "bond-slave, bridge-slave, team-slave"); return g_string_free(str, FALSE); } static const NMMetaSettingValidPartItem *const * get_valid_settings_array(const char *con_type) { const NMMetaSettingInfoEditor *setting_info; /* No connection type yet? Return settings for a generic connection * (just the "connection" setting), which always makes sense. */ if (!con_type) return nm_meta_setting_info_valid_parts_default; setting_info = nm_meta_setting_info_editor_find_by_name(con_type, FALSE); if (setting_info) return setting_info->valid_parts ?: NM_PTRARRAY_EMPTY(const NMMetaSettingValidPartItem *); return NULL; } static char * _construct_property_name(const char *setting_name, const char *property_name, NMMetaAccessorModifier modifier) { return g_strdup_printf("%s%s.%s\n", (modifier == NM_META_ACCESSOR_MODIFIER_ADD ? "+" : (modifier == NM_META_ACCESSOR_MODIFIER_DEL ? "-" : "")), setting_name, property_name); } /* get_valid_properties_string: * @array: base properties for the current connection type * @array_slv: slave properties (or ipv4/ipv6 ones) for the current connection type * @modifier: to prepend to each element of the returned list * @prefix: only properties matching the prefix will be returned * @postfix: required prefix on the property args; if a empty string is passed, is * assumed that the @prefix is a shortcut, so it should not be completed * but left as is (and an additional check for shortcut ambiguity is performed) * * Returns a list of properties compatible with the current connection type * for the shell autocompletion functionality. * * Returns: list of property.arg elements */ static char * get_valid_properties_string(const NMMetaSettingValidPartItem *const *array, const NMMetaSettingValidPartItem *const *array_slv, NMMetaAccessorModifier modifier, const char *prefix, const char *postfix) { const NMMetaSettingValidPartItem *const *iter = array; const char *prop_name = NULL; GString *str; guint i, j; gboolean full_match = FALSE; g_return_val_if_fail(prefix, NULL); str = g_string_sized_new(1024); for (i = 0; i < 2; i++, iter = array_slv) { for (; !full_match && iter && *iter; iter++) { const NMMetaSettingInfoEditor *setting_info = (*iter)->setting_info; if (!(g_str_has_prefix(setting_info->general->setting_name, prefix)) && (!setting_info->alias || !g_str_has_prefix(setting_info->alias, prefix))) { continue; } /* If postix (so prefix is terminated by a dot), check * that prefix is not ambiguous */ if (postfix) { /* If we have a perfect match, no need to look for others * prefix and no check on ambiguity should be performed. * Moreover, erase previous matches from output string */ if (nm_streq(prefix, setting_info->general->setting_name) || nm_streq0(prefix, setting_info->alias)) { g_string_erase(str, 0, -1); full_match = TRUE; } else if (prop_name) return g_string_free(str, TRUE); prop_name = prefix; } else prop_name = setting_info->general->setting_name; /* Search the array with the arguments of the current property */ for (j = 0; j < setting_info->properties_num; j++) { gs_free char *ss1 = NULL; const char *arg_name; arg_name = setting_info->properties[j]->property_name; /* If required, expand the alias too */ if (!postfix && setting_info->alias) { gs_free char *ss2 = NULL; ss2 = _construct_property_name(setting_info->alias, arg_name, modifier); g_string_append(str, ss2); } if (postfix && !g_str_has_prefix(arg_name, postfix)) continue; ss1 = _construct_property_name(prop_name, arg_name, modifier); g_string_append(str, ss1); } } } return g_string_free(str, FALSE); } /* * Check if 'val' is valid string in either array->name or array->alias for * both array parameters (array & array_slv). * It accepts shorter string provided they are not ambiguous. * 'val' == NULL doesn't hurt. * * Returns: pointer to array->name string or NULL on failure. * The returned string must not be freed. */ static const char * check_valid_name(const char *val, const NMMetaSettingValidPartItem *const *array, const NMMetaSettingValidPartItem *const *array_slv, GError **error) { const NMMetaSettingValidPartItem *const *iter; gs_unref_ptrarray GPtrArray *tmp_arr = NULL; const char *str; GError *tmp_err = NULL; int i; g_return_val_if_fail(array, NULL); /* Create a temporary array that can be used in nmc_string_is_valid() */ tmp_arr = g_ptr_array_sized_new(32); iter = array; for (i = 0; i < 2; i++, iter = array_slv) { for (; iter && *iter; iter++) { const NMMetaSettingInfoEditor *setting_info = (*iter)->setting_info; g_ptr_array_add(tmp_arr, (gpointer) setting_info->general->setting_name); if (setting_info->alias) g_ptr_array_add(tmp_arr, (gpointer) setting_info->alias); } } g_ptr_array_add(tmp_arr, (gpointer) NULL); /* Check string validity */ str = nmc_string_is_valid(val, (const char **) tmp_arr->pdata, &tmp_err); if (!str) { if (nm_g_error_matches(tmp_err, NM_UTILS_ERROR, NM_UTILS_ERROR_AMBIGUOUS)) g_propagate_error(error, tmp_err); else { /* We want to handle aliases, so construct own error message */ gs_free char *err_str = NULL; err_str = get_valid_options_string(array, array_slv); g_set_error(error, 1, 0, _("'%s' not among [%s]"), val, err_str); g_clear_error(&tmp_err); } return NULL; } /* Return a pointer to the found string in passed 'array' */ iter = array; for (i = 0; i < 2; i++, iter = array_slv) { for (; iter && *iter; iter++) { const NMMetaSettingInfoEditor *setting_info = (*iter)->setting_info; if (nm_streq(setting_info->general->setting_name, str) || nm_streq0(setting_info->alias, str)) { return setting_info->general->setting_name; } } } /* We should not really come here */ g_set_error(error, 1, 0, _("Unknown error")); return NULL; } static const char * check_valid_name_toplevel(const char *val, const char **slave_type, GError **error) { gs_unref_ptrarray GPtrArray *tmp_arr = NULL; const NMMetaSettingInfoEditor *setting_info; gs_free_error GError *tmp_err = NULL; const char *str; int i; NM_SET_OUT(slave_type, NULL); /* Create a temporary array that can be used in nmc_string_is_valid() */ tmp_arr = g_ptr_array_sized_new(32); for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) { setting_info = &nm_meta_setting_infos_editor[i]; g_ptr_array_add(tmp_arr, (gpointer) setting_info->general->setting_name); if (setting_info->alias) g_ptr_array_add(tmp_arr, (gpointer) setting_info->alias); } g_ptr_array_add(tmp_arr, "bond-slave"); g_ptr_array_add(tmp_arr, "bridge-slave"); g_ptr_array_add(tmp_arr, "team-slave"); g_ptr_array_add(tmp_arr, (gpointer) NULL); /* Check string validity */ str = nmc_string_is_valid(val, (const char **) tmp_arr->pdata, &tmp_err); if (!str) { if (nm_g_error_matches(tmp_err, NM_UTILS_ERROR, NM_UTILS_ERROR_AMBIGUOUS)) g_propagate_error(error, g_steal_pointer(&tmp_err)); else { /* We want to handle aliases, so construct own error message */ gs_free char *err_str = NULL; err_str = get_valid_options_string_toplevel(); g_set_error(error, 1, 0, _("'%s' not among [%s]"), val, err_str); } return NULL; } if (nm_streq(str, "bond-slave")) { NM_SET_OUT(slave_type, NM_SETTING_BOND_SETTING_NAME); return NM_SETTING_WIRED_SETTING_NAME; } else if (nm_streq(str, "bridge-slave")) { NM_SET_OUT(slave_type, NM_SETTING_BRIDGE_SETTING_NAME); return NM_SETTING_WIRED_SETTING_NAME; } else if (nm_streq(str, "team-slave")) { NM_SET_OUT(slave_type, NM_SETTING_TEAM_SETTING_NAME); return NM_SETTING_WIRED_SETTING_NAME; } setting_info = nm_meta_setting_info_editor_find_by_name(str, TRUE); if (setting_info) return setting_info->general->setting_name; /* We should not really come here */ g_set_error(error, 1, 0, _("Unknown error")); return NULL; } static gboolean is_setting_mandatory(NMConnection *connection, NMSetting *setting) { NMSettingConnection *s_con; const char *c_type; const NMMetaSettingValidPartItem *const *item; const char *name; const char *s_type; guint i; s_con = nm_connection_get_setting_connection(connection); g_return_val_if_fail(s_con, FALSE); c_type = nm_setting_connection_get_connection_type(s_con); s_type = nm_setting_connection_get_slave_type(s_con); name = nm_setting_get_name(setting); for (i = 0; i < 2; i++) { if (i == 0) item = get_valid_settings_array(c_type); else item = nm_meta_setting_info_valid_parts_for_slave_type(s_type, NULL); for (; item && *item; item++) { if (nm_streq(name, (*item)->setting_info->general->setting_name)) return (*item)->mandatory; } } return FALSE; } /*****************************************************************************/ static const char * _strip_master_prefix(const char *master, const char *(**func)(NMConnection *) ) { if (!master) return NULL; if (g_str_has_prefix(master, "ifname/")) { master = master + strlen("ifname/"); if (func) *func = nm_connection_get_interface_name; } else if (g_str_has_prefix(master, "uuid/")) { master = master + strlen("uuid/"); if (func) *func = nm_connection_get_uuid; } else if (g_str_has_prefix(master, "id/")) { master = master + strlen("id/"); if (func) *func = nm_connection_get_id; } return master; } /* normalized_master_for_slave: * @connections: list af all connections * @master: UUID, ifname or ID of the master connection * @type: virtual connection type (bond, team, bridge, ...) or %NULL * @out_type: type of the connection that matched * * Check whether master is a valid interface name, UUID or ID of some connection, * possibly of a specified @type. * First UUID and ifname are checked. If they don't match, ID is checked * and replaced by UUID on a match. * * Returns: identifier of master connection if found, %NULL otherwise */ static const char * normalized_master_for_slave(const GPtrArray *connections, const char *master, const char *type, const char **out_type) { NMConnection *connection; NMSettingConnection *s_con; const char *con_type = NULL, *id, *uuid, *ifname; guint i; const char *found_by_id = NULL; const char *out_type_by_id = NULL; const char *out_master = NULL; const char *(*func)(NMConnection *) = NULL; if (!master) return NULL; master = _strip_master_prefix(master, &func); for (i = 0; i < connections->len; i++) { connection = NM_CONNECTION(connections->pdata[i]); s_con = nm_connection_get_setting_connection(connection); g_return_val_if_fail(s_con, NULL); con_type = nm_setting_connection_get_connection_type(s_con); if (type && !nm_streq0(con_type, type)) continue; if (func) { /* There was a prefix; only compare to that type. */ if (nm_streq0(master, func(connection))) { if (out_type) *out_type = con_type; if (func == nm_connection_get_id) out_master = nm_connection_get_uuid(connection); else out_master = master; break; } } else { id = nm_connection_get_id(connection); uuid = nm_connection_get_uuid(connection); ifname = nm_connection_get_interface_name(connection); if (NM_IN_STRSET(master, uuid, ifname)) { out_master = master; if (out_type) *out_type = con_type; break; } if (!found_by_id && nm_streq0(master, id)) { out_type_by_id = con_type; found_by_id = uuid; } } } if (!out_master) { out_master = found_by_id; if (out_type) *out_type = out_type_by_id; } if (!out_master) { g_print(_("Warning: master='%s' doesn't refer to any existing profile.\n"), master); out_master = master; if (out_type) *out_type = type; } return out_master; } #define WORD_YES "yes" #define WORD_NO "no" static const char * prompt_yes_no(gboolean default_yes, char *delim) { static char prompt[128] = {0}; if (!delim) delim = ""; g_snprintf(prompt, sizeof(prompt), "(%s/%s) [%s]%s ", WORD_YES, WORD_NO, default_yes ? WORD_YES : WORD_NO, delim); return prompt; } static NMSetting * is_setting_valid(NMConnection *connection, const NMMetaSettingValidPartItem *const *valid_settings_main, const NMMetaSettingValidPartItem *const *valid_settings_slave, const char *setting) { const char *setting_name; if (!(setting_name = check_valid_name(setting, valid_settings_main, valid_settings_slave, NULL))) return NULL; return nm_connection_get_setting_by_name(connection, setting_name); } static char * is_property_valid(NMSetting *setting, const char *property, GError **error) { gs_strfreev char **valid_props = NULL; const char *prop_name; valid_props = nmc_setting_get_valid_properties(setting); prop_name = nmc_string_is_valid(property, (const char **) valid_props, error); return g_strdup(prop_name); } static char * unique_master_iface_ifname(const GPtrArray *connections, const char *try_name) { char *new_name; guint num = 0; guint i; new_name = g_strdup(try_name); again: for (i = 0; i < connections->len; i++) { NMConnection *connection = connections->pdata[i]; if (nm_streq0(new_name, nm_connection_get_interface_name(connection))) { num++; g_free(new_name); new_name = g_strdup_printf("%s%u", try_name, num); goto again; } } return new_name; } static void set_default_interface_name(NmCli *nmc, NMSettingConnection *s_con) { const char *default_name; const char *con_type; if (nm_setting_connection_get_interface_name(s_con)) return; con_type = nm_setting_connection_get_connection_type(s_con); /* Set a sensible bond/team/bridge interface name by default */ if (nm_streq0(con_type, NM_SETTING_BOND_SETTING_NAME)) default_name = "nm-bond"; else if (nm_streq0(con_type, NM_SETTING_TEAM_SETTING_NAME)) default_name = "nm-team"; else if (nm_streq0(con_type, NM_SETTING_BRIDGE_SETTING_NAME)) default_name = "nm-bridge"; else default_name = NULL; if (default_name) { const GPtrArray *connections; gs_free char *ifname = NULL; connections = nmc_get_connections(nmc); ifname = unique_master_iface_ifname(connections, default_name); g_object_set(s_con, NM_SETTING_CONNECTION_INTERFACE_NAME, ifname, NULL); } } /*****************************************************************************/ static PropertyInfFlags _dynamic_options_set(const NMMetaAbstractInfo *abstract_info, PropertyInfFlags mask, PropertyInfFlags set) { static GHashTable *cache = NULL; gpointer p; PropertyInfFlags v, v2; if (G_UNLIKELY(!cache)) cache = g_hash_table_new(nm_direct_hash, NULL); if (g_hash_table_lookup_extended(cache, (gpointer) abstract_info, NULL, &p)) v = GPOINTER_TO_UINT(p); else v = 0; v2 = (v & ~mask) | (mask & set); if (v != v2) g_hash_table_insert(cache, (gpointer) abstract_info, GUINT_TO_POINTER(v2)); return v2; } static PropertyInfFlags _dynamic_options_get(const NMMetaAbstractInfo *abstract_info) { return _dynamic_options_set(abstract_info, 0, 0); } /*****************************************************************************/ static gboolean _meta_property_needs_bond_hack(const NMMetaPropertyInfo *property_info) { /* hack: the bond property data is handled special and not generically. * Eventually, get rid of explicitly checking whether we handle a bond. */ if (!property_info) g_return_val_if_reached(FALSE); return property_info->property_typ_data && property_info->property_typ_data->nested == &nm_meta_property_typ_data_bond; } static char ** _meta_abstract_complete(const NMMetaAbstractInfo *abstract_info, const char *text) { const char *const *values; char **values_to_free = NULL; const NMMetaOperationContext ctx = { .connection = nmc_tab_completion.connection, }; values = nm_meta_abstract_info_complete(abstract_info, nmc_meta_environment, (gpointer) nmc_meta_environment_arg, &ctx, text, NULL, &values_to_free); if (values) return values_to_free ?: g_strdupv((char **) values); return NULL; } static char * _meta_abstract_generator(const char *text, int state) { if (nmc_tab_completion.words) { return nmc_rl_gen_func_basic(text, state, (const char *const *) nmc_tab_completion.words); } return NULL; } static void _meta_abstract_get(const NMMetaAbstractInfo *abstract_info, const NMMetaSettingInfoEditor **out_setting_info, const char **out_setting_name, const char **out_property_name, const char **out_option, NMMetaPropertyInfFlags *out_inf_flags, const char **out_prompt, const char **out_def_hint) { const NMMetaPropertyInfo *info = (const NMMetaPropertyInfo *) abstract_info; NM_SET_OUT(out_option, info->property_alias); NM_SET_OUT(out_setting_info, info->setting_info); NM_SET_OUT(out_setting_name, info->setting_info->general->setting_name); NM_SET_OUT(out_property_name, info->property_name); NM_SET_OUT(out_option, info->property_alias); NM_SET_OUT(out_inf_flags, info->inf_flags); NM_SET_OUT(out_prompt, info->prompt); NM_SET_OUT(out_def_hint, info->def_hint); } static const OptionInfo *_meta_abstract_get_option_info(const NMMetaAbstractInfo *abstract_info); /* * Mark options in option_info as relevant. * The questionnaire (for --ask) will ask for them. */ static void enable_options(const char *setting_name, const char *property, const char *const *opts) { const NMMetaPropertyInfo *property_info; property_info = nm_meta_property_info_find_by_name(setting_name, property); if (!property_info) g_return_if_reached(); if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; if (opts) { if (!bi->base.property_alias || !g_strv_contains(opts, bi->base.property_alias)) continue; } _dynamic_options_set((const NMMetaAbstractInfo *) bi, PROPERTY_INF_FLAG_ENABLED | PROPERTY_INF_FLAG_DISABLED, PROPERTY_INF_FLAG_ENABLED); } return; } if (!property_info->is_cli_option) g_return_if_reached(); if (opts) { if (!property_info->property_alias || !g_strv_contains(opts, property_info->property_alias)) return; } _dynamic_options_set((const NMMetaAbstractInfo *) property_info, PROPERTY_INF_FLAG_ENABLED | PROPERTY_INF_FLAG_DISABLED, PROPERTY_INF_FLAG_ENABLED); } /* * Mark options in option_info as irrelevant (because we learned they make no sense * or they have been set via different means). * The questionnaire (for --ask) will not ask for them. */ static void disable_options(const char *setting_name, const char *property) { const NMMetaPropertyInfo *property_infos_local[2]; const NMMetaPropertyInfo *const *property_infos; guint p; if (property) { const NMMetaPropertyInfo *pi; pi = nm_meta_property_info_find_by_name(setting_name, property); if (!pi) g_return_if_reached(); if (!_meta_property_needs_bond_hack(pi) && !pi->is_cli_option) return; property_infos_local[0] = pi; property_infos_local[1] = NULL; property_infos = property_infos_local; } else { const NMMetaSettingInfoEditor *setting_info; setting_info = nm_meta_setting_info_editor_find_by_name(setting_name, FALSE); if (!setting_info) g_return_if_reached(); property_infos = setting_info->properties; if (!property_infos) return; } for (p = 0; property_infos[p]; p++) { const NMMetaPropertyInfo *property_info = property_infos[p]; if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; _dynamic_options_set((const NMMetaAbstractInfo *) bi, PROPERTY_INF_FLAG_DISABLED, PROPERTY_INF_FLAG_DISABLED); } nm_assert(p == 0 && !property_infos[1]); } else { if (property_info->is_cli_option) _dynamic_options_set((const NMMetaAbstractInfo *) property_info, PROPERTY_INF_FLAG_DISABLED, PROPERTY_INF_FLAG_DISABLED); } } } /* * Reset marks done with enable_options() and disable_options(). * Ensures correct operation in case more than one connection is added in a single * nmcli session. */ static void reset_options(void) { NMMetaSettingType s; for (s = 0; s < _NM_META_SETTING_TYPE_NUM; s++) { const NMMetaPropertyInfo *const *property_infos; guint p; property_infos = nm_meta_setting_infos_editor[s].properties; if (!property_infos) continue; for (p = 0; property_infos[p]; p++) { const NMMetaPropertyInfo *property_info = property_infos[p]; if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; _dynamic_options_set((const NMMetaAbstractInfo *) bi, PROPERTY_INF_FLAG_ALL, 0); } } else { if (property_info->is_cli_option) _dynamic_options_set((const NMMetaAbstractInfo *) property_info, PROPERTY_INF_FLAG_ALL, 0); } } } } static gboolean set_property(NMClient *client, NMConnection *connection, const char *setting_name, const char *property, const char *value, NMMetaAccessorModifier modifier, GError **error) { gs_free char *property_name = NULL; gs_free_error GError *local = NULL; NMSetting *setting; nm_assert(setting_name && setting_name[0]); nm_assert(NM_IN_SET(modifier, NM_META_ACCESSOR_MODIFIER_SET, NM_META_ACCESSOR_MODIFIER_ADD, NM_META_ACCESSOR_MODIFIER_DEL)); setting = nm_connection_get_setting_by_name(connection, setting_name); if (!setting) { setting = nm_meta_setting_info_editor_new_setting( nm_meta_setting_info_editor_find_by_name(setting_name, FALSE), NM_META_ACCESSOR_SETTING_INIT_TYPE_CLI); nm_connection_add_setting(connection, setting); } property_name = is_property_valid(setting, property, &local); if (!property_name) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: invalid property '%s': %s."), property, local->message); return FALSE; } if (!nmc_setting_set_property(client, setting, property_name, ((modifier == NM_META_ACCESSOR_MODIFIER_DEL && !value) ? NM_META_ACCESSOR_MODIFIER_SET : modifier), value, &local)) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, modifier != NM_META_ACCESSOR_MODIFIER_DEL ? _("Error: failed to modify %s.%s: %s.") : _("Error: failed to remove a value from %s.%s: %s."), setting_name, property, local->message); return FALSE; } /* Don't ask for this property in interactive mode. */ disable_options(setting_name, property_name); return TRUE; } static gboolean set_option(NmCli *nmc, NMConnection *connection, const NMMetaAbstractInfo *abstract_info, const char *value, gboolean allow_reset, GError **error) { const char *setting_name, *property_name, *option_name; NMMetaPropertyInfFlags inf_flags; const OptionInfo *option; option = _meta_abstract_get_option_info(abstract_info); _dynamic_options_set(abstract_info, PROPERTY_INF_FLAG_DISABLED, PROPERTY_INF_FLAG_DISABLED); _meta_abstract_get(abstract_info, NULL, &setting_name, &property_name, &option_name, &inf_flags, NULL, NULL); if (option && option->check_and_set) { return option->check_and_set(nmc, connection, option, value, allow_reset, error); } else if (value || allow_reset) { return set_property(nmc->client, connection, setting_name, property_name, value, !value ? NM_META_ACCESSOR_MODIFIER_DEL : (inf_flags & NM_META_PROPERTY_INF_FLAG_MULTI ? NM_META_ACCESSOR_MODIFIER_ADD : NM_META_ACCESSOR_MODIFIER_SET), error); } return TRUE; } /* * Return relevant NameItem[] tables for given connection (based on connection type * and slave type. */ static gboolean con_settings(NMConnection *connection, const NMMetaSettingValidPartItem *const **type_settings, const NMMetaSettingValidPartItem *const **slv_settings, GError **error) { const char *con_type; NMSettingConnection *s_con; g_return_val_if_fail(type_settings, FALSE); g_return_val_if_fail(slv_settings, FALSE); s_con = nm_connection_get_setting_connection(connection); g_return_val_if_fail(s_con, FALSE); con_type = nm_setting_connection_get_slave_type(s_con); *slv_settings = nm_meta_setting_info_valid_parts_for_slave_type(con_type, NULL); if (!*slv_settings) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: invalid slave type; %s."), con_type); return FALSE; } con_type = nm_setting_connection_get_connection_type(s_con); *type_settings = get_valid_settings_array(con_type); if (!*type_settings) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: invalid connection type; %s."), con_type); return FALSE; } return TRUE; } /* * Make sure all required settings are in place (should be called when * it's possible that a type is already set). */ static void ensure_settings(NMConnection *connection, const NMMetaSettingValidPartItem *const *item) { NMSetting *setting; for (; item && *item; item++) { if (!(*item)->mandatory) continue; if (nm_connection_get_setting_by_name(connection, (*item)->setting_info->general->setting_name)) continue; setting = nm_meta_setting_info_editor_new_setting((*item)->setting_info, NM_META_ACCESSOR_SETTING_INIT_TYPE_CLI); nm_connection_add_setting(connection, setting); } } /*****************************************************************************/ static char * gen_func_bool_values_l10n(const char *text, int state) { const char *words[] = {WORD_YES, WORD_NO, NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_func_bt_type(const char *text, int state) { const char *words[] = {"panu", "nap", "dun-gsm", "dun-cdma", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_func_bond_mode(const char *text, int state) { const char *words[] = {"balance-rr", "active-backup", "balance-xor", "broadcast", "802.3ad", "balance-tlb", "balance-alb", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_func_bond_mon_mode(const char *text, int state) { const char *words[] = {"miimon", "arp", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_func_bond_lacp_rate(const char *text, int state) { const char *words[] = {"slow", "fast", NULL}; return nmc_rl_gen_func_basic(text, state, words); } /*****************************************************************************/ static gboolean enable_type_settings_and_options(NmCli *nmc, NMConnection *con, GError **error) { const NMMetaSettingValidPartItem *const *type_settings; const NMMetaSettingValidPartItem *const *slv_settings; NMSettingConnection *s_con; s_con = nm_connection_get_setting_connection(con); g_return_val_if_fail(s_con, FALSE); if (nm_setting_connection_get_slave_type(s_con)) enable_options(NM_SETTING_CONNECTION_SETTING_NAME, NM_SETTING_CONNECTION_MASTER, NULL); if (NM_IN_STRSET(nm_setting_connection_get_connection_type(s_con), NM_SETTING_BLUETOOTH_SETTING_NAME, NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BRIDGE_SETTING_NAME, NM_SETTING_DUMMY_SETTING_NAME, NM_SETTING_OVS_BRIDGE_SETTING_NAME, NM_SETTING_OVS_PATCH_SETTING_NAME, NM_SETTING_OVS_PORT_SETTING_NAME, NM_SETTING_TEAM_SETTING_NAME, NM_SETTING_VETH_SETTING_NAME, NM_SETTING_VRF_SETTING_NAME, NM_SETTING_WIREGUARD_SETTING_NAME)) { enable_options(NM_SETTING_CONNECTION_SETTING_NAME, NM_SETTING_CONNECTION_INTERFACE_NAME, NULL); } if (!con_settings(con, &type_settings, &slv_settings, error)) return FALSE; ensure_settings(con, slv_settings); ensure_settings(con, type_settings); /* For some software connection types we generate the interface name for the user. */ set_default_interface_name(nmc, s_con); return TRUE; } static gboolean set_connection_type(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { GError *local = NULL; const char *slave_type = NULL; value = check_valid_name_toplevel(value, &slave_type, &local); if (!value) { if (!allow_reset) return TRUE; g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: bad connection type: %s"), local->message); g_clear_error(&local); return FALSE; } if (slave_type) { if (!set_property(nmc->client, con, NM_SETTING_CONNECTION_SETTING_NAME, NM_SETTING_CONNECTION_SLAVE_TYPE, slave_type, NM_META_ACCESSOR_MODIFIER_SET, error)) { return FALSE; } } if (!set_property(nmc->client, con, option->setting_info->general->setting_name, option->property, value, NM_META_ACCESSOR_MODIFIER_SET, error)) return FALSE; return enable_type_settings_and_options(nmc, con, error); } static gboolean set_connection_iface(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { if (value) { /* Special value of '*' means no specific interface name */ if (nm_streq(value, "*")) value = NULL; } else if (!allow_reset) { return TRUE; } return set_property(nmc->client, con, option->setting_info->general->setting_name, option->property, value, NM_META_ACCESSOR_MODIFIER_SET, error); } static gboolean set_connection_master(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { const GPtrArray *connections; NMSettingConnection *s_con; const char *slave_type; s_con = nm_connection_get_setting_connection(con); g_return_val_if_fail(s_con, FALSE); if (!value) { if (!allow_reset) return TRUE; g_set_error_literal(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: master is required")); return FALSE; } slave_type = nm_setting_connection_get_slave_type(s_con); connections = nmc_get_connections(nmc); value = normalized_master_for_slave(connections, value, slave_type, &slave_type); if (!set_property(nmc->client, con, NM_SETTING_CONNECTION_SETTING_NAME, NM_SETTING_CONNECTION_SLAVE_TYPE, slave_type, NM_META_ACCESSOR_MODIFIER_SET, error)) { return FALSE; } return set_property(nmc->client, con, option->setting_info->general->setting_name, option->property, value, NM_META_ACCESSOR_MODIFIER_SET, error); } static gboolean set_bond_option(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { NMSettingBond *s_bond; gs_free char *name = NULL; char *p; s_bond = nm_connection_get_setting_bond(con); g_return_val_if_fail(s_bond, FALSE); name = g_strdup(option->option); for (p = name; p[0]; p++) { if (p[0] == '-') p[0] = '_'; } if (nm_str_is_empty(value)) { if (allow_reset) { nm_setting_bond_remove_option(s_bond, name); return TRUE; } } else { if (!_nm_meta_setting_bond_add_option(NM_SETTING(s_bond), name, value, error)) return FALSE; } if (nm_streq(name, NM_SETTING_BOND_OPTION_MODE)) { value = nm_setting_bond_get_option_by_name(s_bond, name); if (nm_streq(value, "active-backup")) { enable_options(NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BOND_OPTIONS, NM_MAKE_STRV("primary")); } } return TRUE; } static gboolean set_bond_monitoring_mode(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { NMSettingBond *s_bond; gs_free char *monitor_mode = NULL; const char *miimon_opts[] = {"miimon", "downdelay", "updelay", NULL}; const char *arp_opts[] = {"arp-interval", "arp-ip-target", NULL}; s_bond = nm_connection_get_setting_bond(con); g_return_val_if_fail(s_bond, FALSE); if (value) { monitor_mode = g_strdup(value); g_strstrip(monitor_mode); } else { monitor_mode = g_strdup(NM_META_TEXT_WORD_MIIMON); } if (matches(monitor_mode, NM_META_TEXT_WORD_MIIMON)) enable_options(NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BOND_OPTIONS, miimon_opts); else if (matches(monitor_mode, NM_META_TEXT_WORD_ARP)) enable_options(NM_SETTING_BOND_SETTING_NAME, NM_SETTING_BOND_OPTIONS, arp_opts); else { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: '%s' is not a valid monitoring mode; use '%s' or '%s'.\n"), monitor_mode, NM_META_TEXT_WORD_MIIMON, NM_META_TEXT_WORD_ARP); return FALSE; } return TRUE; } static gboolean set_bluetooth_type(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { NMSetting *setting; if (!value) return TRUE; /* 'dun' type requires adding 'gsm' or 'cdma' setting */ if (NM_IN_STRSET(value, NM_SETTING_BLUETOOTH_TYPE_DUN, NM_SETTING_BLUETOOTH_TYPE_DUN "-gsm")) { value = NM_SETTING_BLUETOOTH_TYPE_DUN; setting = nm_meta_setting_info_editor_new_setting( &nm_meta_setting_infos_editor[NM_META_SETTING_TYPE_GSM], NM_META_ACCESSOR_SETTING_INIT_TYPE_CLI); nm_connection_add_setting(con, setting); } else if (NM_IN_STRSET(value, NM_SETTING_BLUETOOTH_TYPE_DUN "-cdma")) { value = NM_SETTING_BLUETOOTH_TYPE_DUN; setting = nm_setting_cdma_new(); nm_connection_add_setting(con, setting); } else if (NM_IN_STRSET(value, NM_SETTING_BLUETOOTH_TYPE_PANU, NM_SETTING_BLUETOOTH_TYPE_NAP)) { /* no op */ } else { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: 'bt-type': '%s' not valid; use [%s, %s, %s (%s), %s]."), value, NM_SETTING_BLUETOOTH_TYPE_PANU, NM_SETTING_BLUETOOTH_TYPE_NAP, NM_SETTING_BLUETOOTH_TYPE_DUN, NM_SETTING_BLUETOOTH_TYPE_DUN "-gsm", NM_SETTING_BLUETOOTH_TYPE_DUN "-cdma"); return FALSE; } return set_property(nmc->client, con, option->setting_info->general->setting_name, option->property, value, NM_META_ACCESSOR_MODIFIER_SET, error); } static gboolean set_ip4_address(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { NMSettingIPConfig *s_ip4; if (!value) return TRUE; s_ip4 = nm_connection_get_setting_ip4_config(con); if (!s_ip4) { s_ip4 = (NMSettingIPConfig *) nm_setting_ip4_config_new(); nm_connection_add_setting(con, NM_SETTING(s_ip4)); g_object_set(s_ip4, NM_SETTING_IP_CONFIG_METHOD, NM_SETTING_IP4_CONFIG_METHOD_MANUAL, NULL); } return set_property(nmc->client, con, option->setting_info->general->setting_name, option->property, value, NM_META_ACCESSOR_MODIFIER_ADD, error); } static gboolean set_ip6_address(NmCli *nmc, NMConnection *con, const OptionInfo *option, const char *value, gboolean allow_reset, GError **error) { NMSettingIPConfig *s_ip6; if (!value) return TRUE; s_ip6 = nm_connection_get_setting_ip6_config(con); if (!s_ip6) { s_ip6 = (NMSettingIPConfig *) nm_setting_ip6_config_new(); nm_connection_add_setting(con, NM_SETTING(s_ip6)); g_object_set(s_ip6, NM_SETTING_IP_CONFIG_METHOD, NM_SETTING_IP6_CONFIG_METHOD_MANUAL, NULL); } return set_property(nmc->client, con, option->setting_info->general->setting_name, option->property, value, NM_META_ACCESSOR_MODIFIER_ADD, error); } /*****************************************************************************/ static const OptionInfo * _meta_abstract_get_option_info(const NMMetaAbstractInfo *abstract_info) { static const OptionInfo option_info[] = { #define OPTION_INFO(name, property_name_, property_alias_, check_and_set_, generator_func_) \ { \ .setting_info = &nm_meta_setting_infos_editor[NM_META_SETTING_TYPE_##name], \ .property = property_name_, \ .option = property_alias_, \ .check_and_set = check_and_set_, \ .generator_func = generator_func_, \ } OPTION_INFO(CONNECTION, NM_SETTING_CONNECTION_TYPE, "type", set_connection_type, NULL), OPTION_INFO(CONNECTION, NM_SETTING_CONNECTION_INTERFACE_NAME, "ifname", set_connection_iface, NULL), OPTION_INFO(CONNECTION, NM_SETTING_CONNECTION_MASTER, "master", set_connection_master, NULL), OPTION_INFO(BLUETOOTH, NM_SETTING_BLUETOOTH_TYPE, "bt-type", set_bluetooth_type, gen_func_bt_type), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "mode", set_bond_option, gen_func_bond_mode), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "primary", set_bond_option, nmc_rl_gen_func_ifnames), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, NULL, set_bond_monitoring_mode, gen_func_bond_mon_mode), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "miimon", set_bond_option, NULL), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "downdelay", set_bond_option, NULL), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "updelay", set_bond_option, NULL), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "arp-interval", set_bond_option, NULL), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "arp-ip-target", set_bond_option, NULL), OPTION_INFO(BOND, NM_SETTING_BOND_OPTIONS, "lacp-rate", set_bond_option, gen_func_bond_lacp_rate), OPTION_INFO(IP4_CONFIG, NM_SETTING_IP_CONFIG_ADDRESSES, "ip4", set_ip4_address, NULL), OPTION_INFO(IP6_CONFIG, NM_SETTING_IP_CONFIG_ADDRESSES, "ip6", set_ip6_address, NULL), {0}, }; const char *property_name, *option; const NMMetaSettingInfoEditor *setting_info; const OptionInfo *candidate; _meta_abstract_get(abstract_info, &setting_info, NULL, &property_name, &option, NULL, NULL, NULL); for (candidate = option_info; candidate->setting_info; candidate++) { if (candidate->setting_info == setting_info && nm_streq0(candidate->property, property_name) && nm_streq0(candidate->option, option)) { return candidate; } } return NULL; } static gboolean option_relevant(NMConnection *connection, const NMMetaAbstractInfo *abstract_info) { const char *setting_name; NMMetaPropertyInfFlags inf_flags; _meta_abstract_get(abstract_info, NULL, &setting_name, NULL, NULL, &inf_flags, NULL, NULL); if ((inf_flags & NM_META_PROPERTY_INF_FLAG_DONT_ASK) && !(_dynamic_options_get(abstract_info) & PROPERTY_INF_FLAG_ENABLED)) return FALSE; if (_dynamic_options_get(abstract_info) & PROPERTY_INF_FLAG_DISABLED) return FALSE; if (!nm_connection_get_setting_by_name(connection, setting_name)) return FALSE; return TRUE; } /*****************************************************************************/ static void complete_property_name(NmCli *nmc, NMConnection *connection, NMMetaAccessorModifier modifier, const char *prefix, const char *postfix) { NMSettingConnection *s_con; const NMMetaSettingValidPartItem *const *valid_settings_main; const NMMetaSettingValidPartItem *const *valid_settings_slave; const char *connection_type = NULL; const char *slave_type = NULL; gs_free char *word_list = NULL; NMMetaSettingType s; connection_type = nm_connection_get_connection_type(connection); s_con = nm_connection_get_setting_connection(connection); if (s_con) slave_type = nm_setting_connection_get_slave_type(s_con); valid_settings_main = get_valid_settings_array(connection_type); valid_settings_slave = nm_meta_setting_info_valid_parts_for_slave_type(slave_type, NULL); word_list = get_valid_properties_string(valid_settings_main, valid_settings_slave, modifier, prefix, postfix); if (word_list) g_print("%s", word_list); if (modifier != NM_META_ACCESSOR_MODIFIER_SET) return; for (s = 0; s < _NM_META_SETTING_TYPE_NUM; s++) { const NMMetaPropertyInfo *const *property_infos; guint p; if (!nm_connection_get_setting_by_name( connection, nm_meta_setting_infos_editor[s].general->setting_name)) continue; property_infos = nm_meta_setting_infos_editor[s].properties; if (!property_infos) continue; for (p = 0; property_infos[p]; p++) { const NMMetaPropertyInfo *property_info = property_infos[p]; if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; if (!bi->base.property_alias || !g_str_has_prefix(bi->base.property_alias, prefix)) continue; g_print("%s\n", bi->base.property_alias); } } else { if (!property_info->is_cli_option) continue; if (!property_info->property_alias || !g_str_has_prefix(property_info->property_alias, prefix)) continue; g_print("%s\n", property_info->property_alias); } } } } static void run_rl_generator(rl_compentry_func_t *generator_func, const char *prefix) { int state = 0; char *str; while ((str = generator_func(prefix, state))) { g_print("%s\n", str); g_free(str); if (state == 0) state = 1; } } static gboolean complete_option(NmCli *nmc, const NMMetaAbstractInfo *abstract_info, const char *prefix, NMConnection *context_connection) { const OptionInfo *candidate; const char *const *values; gs_strfreev char **values_to_free = NULL; gboolean complete_filename = FALSE; const NMMetaOperationContext ctx = { .connection = context_connection, }; values = nm_meta_abstract_info_complete(abstract_info, nmc_meta_environment, (gpointer) nmc_meta_environment_arg, &ctx, prefix, &complete_filename, &values_to_free); if (complete_filename) { nmc->return_value = NMC_RESULT_COMPLETE_FILE; return TRUE; } if (values) { for (; values[0]; values++) g_print("%s\n", values[0]); return TRUE; } candidate = _meta_abstract_get_option_info(abstract_info); if (candidate && candidate->generator_func) { run_rl_generator(candidate->generator_func, prefix); return TRUE; } return FALSE; } static void complete_existing_setting(NmCli *nmc, NMConnection *connection, const char *prefix) { gs_free NMSetting **settings = NULL; const NMMetaSettingInfoEditor *editor; guint i; settings = nm_connection_get_settings(connection, NULL); for (i = 0; settings && settings[i]; i++) { editor = nm_meta_setting_info_editor_find_by_setting(settings[i]); if (!prefix || g_str_has_prefix(editor->general->setting_name, prefix)) g_print("%s\n", editor->general->setting_name); if (editor->alias) { if (!prefix || g_str_has_prefix(editor->alias, prefix)) g_print("%s\n", editor->alias); } } } static void complete_property(NmCli *nmc, const char *setting_name, const char *property, const char *prefix, NMConnection *connection) { const NMMetaPropertyInfo *property_info; property_info = nm_meta_property_info_find_by_name(setting_name, property); if (property_info) complete_option(nmc, (const NMMetaAbstractInfo *) property_info, prefix, connection); } /*****************************************************************************/ static gboolean connection_remove_setting(NMConnection *connection, NMSetting *setting, GError **error) { gboolean mandatory; g_return_val_if_fail(setting, FALSE); mandatory = is_setting_mandatory(connection, setting); if (!mandatory) { nm_connection_remove_setting(connection, G_OBJECT_TYPE(setting)); return TRUE; } g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: setting '%s' is mandatory and cannot be removed."), nm_setting_get_name(setting)); return FALSE; } static gboolean get_value(const char **value, int *argc, const char *const **argv, const char *option, GError **error) { if (!**argv) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: value for '%s' is missing."), option); return FALSE; } /* Empty string will reset the value to default */ if (**argv[0] == '\0') *value = NULL; else *value = *argv[0]; (*argc)--; (*argv)++; return TRUE; } gboolean nmc_process_connection_properties(NmCli *nmc, NMConnection *connection, int *argc, const char *const **argv, gboolean allow_setting_removal, GError **error) { /* First check if we have a slave-type, as this would mean we will not * have ip properties but possibly others, slave-type specific. */ /* Go through arguments and set properties */ do { const NMMetaSettingValidPartItem *const *type_settings; const NMMetaSettingValidPartItem *const *slv_settings; NMMetaAccessorModifier modifier; const char *option_orig; const char *option; const char *value = NULL; const char *tmp; const NMMetaAbstractInfo *chosen = NULL; const char *chosen_setting_name = NULL; const char *chosen_option = NULL; NMMetaSettingType s; if (!con_settings(connection, &type_settings, &slv_settings, error)) return FALSE; ensure_settings(connection, slv_settings); ensure_settings(connection, type_settings); if (*argc <= 0) { g_set_error_literal(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: . argument is missing.")); return FALSE; } nm_assert(argv); nm_assert(*argv); nm_assert(**argv); option_orig = **argv; switch (option_orig[0]) { case '+': modifier = NM_META_ACCESSOR_MODIFIER_ADD; option = &option_orig[1]; break; case '-': modifier = NM_META_ACCESSOR_MODIFIER_DEL; option = &option_orig[1]; break; default: modifier = NM_META_ACCESSOR_MODIFIER_SET; option = option_orig; break; } if (allow_setting_removal && modifier == NM_META_ACCESSOR_MODIFIER_SET && nm_streq(option, "remove")) { NMSetting *ss; const char *setting_name; (*argc)--; (*argv)++; if (*argc == 1 && nmc->complete) { complete_existing_setting(nmc, connection, value); return TRUE; } if (!*argc) { g_set_error_literal(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: missing setting.")); return FALSE; } setting_name = **argv; (*argc)--; (*argv)++; ss = is_setting_valid(connection, type_settings, slv_settings, setting_name); if (!ss) { if (!check_valid_name(setting_name, type_settings, slv_settings, NULL)) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: invalid setting argument '%s'."), setting_name); return FALSE; } continue; } if (!connection_remove_setting(connection, ss, error)) return FALSE; continue; } if ((tmp = strchr(option, '.'))) { gs_free char *option_sett = g_strndup(option, tmp - option); const char *option_prop = &tmp[1]; const char *option_sett_expanded; GError *local = NULL; /* This seems like a . (such as "connection.id" or "bond.mode"), * optionally prefixed with "+| or "-". */ if (*argc == 1 && nmc->complete) complete_property_name(nmc, connection, modifier, option_sett, option_prop); option_sett_expanded = check_valid_name(option_sett, type_settings, slv_settings, &local); if (!option_sett_expanded) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: invalid or not allowed setting '%s': %s."), option_sett, local->message); g_clear_error(&local); return FALSE; } (*argc)--; (*argv)++; if (!get_value(&value, argc, argv, option_orig, error)) return FALSE; if (!*argc && nmc->complete) { complete_property(nmc, option_sett, option_prop, value ?: "", connection); return TRUE; } if (!set_property(nmc->client, connection, option_sett_expanded, option_prop, value, modifier, error)) return FALSE; continue; } /* Let's see if this is an property alias (such as "id", "mode", "type" or "con-name")*/ for (s = 0; s < _NM_META_SETTING_TYPE_NUM; s++) { const NMMetaPropertyInfo *const *property_infos; guint p; if (!check_valid_name(nm_meta_setting_infos[s].setting_name, type_settings, slv_settings, NULL)) continue; property_infos = nm_meta_setting_infos_editor[s].properties; if (!property_infos) continue; for (p = 0; property_infos[p]; p++) { const NMMetaPropertyInfo *property_info = property_infos[p]; if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; if (!nm_streq0(bi->base.property_alias, option)) continue; if (chosen) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: '%s' is ambiguous (%s.%s or %s.%s)."), option, chosen_setting_name, chosen_option, nm_meta_setting_infos[s].setting_name, option); return FALSE; } chosen_setting_name = nm_meta_setting_infos[s].setting_name; chosen_option = option; chosen = (const NMMetaAbstractInfo *) bi; } } else { if (!property_info->is_cli_option) continue; if (!nm_streq0(property_info->property_alias, option)) continue; if (chosen) { g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: '%s' is ambiguous (%s.%s or %s.%s)."), option, chosen_setting_name, chosen_option, nm_meta_setting_infos[s].setting_name, option); return FALSE; } chosen_setting_name = nm_meta_setting_infos[s].setting_name; chosen_option = option; chosen = (const NMMetaAbstractInfo *) property_info; } } } if (!chosen) { if (*argc == 1 && nmc->complete) { if (allow_setting_removal && g_str_has_prefix("remove", option)) g_print("remove\n"); complete_property_name(nmc, connection, modifier, option, NULL); } g_set_error(error, NMCLI_ERROR, NMC_RESULT_ERROR_USER_INPUT, _("Error: invalid . '%s'."), option); return FALSE; } if (*argc == 1 && nmc->complete) complete_property_name(nmc, connection, modifier, option, NULL); (*argc)--; (*argv)++; if (!get_value(&value, argc, argv, option_orig, error)) return FALSE; if (!*argc && nmc->complete) complete_option(nmc, chosen, value ?: "", connection); if (!set_option(nmc, connection, chosen, value, TRUE, error)) return FALSE; } while (*argc); return TRUE; } static void connection_warnings(NmCli *nmc, NMConnection *connection) { const GPtrArray *connections; guint i, found; const char *id; const char *deprecated; deprecated = nmc_connection_check_deprecated(NM_CONNECTION(connection)); if (deprecated) g_printerr(_("Warning: %s.\n"), deprecated); connections = nmc_get_connections(nmc); id = nm_connection_get_id(connection); found = 0; for (i = 0; i < connections->len; i++) { NMConnection *candidate = NM_CONNECTION(connections->pdata[i]); if ((NMConnection *) connection == candidate) continue; if (nm_streq0(nm_connection_get_id(candidate), id)) found++; } if (found > 0) { g_printerr(g_dngettext(GETTEXT_PACKAGE, "Warning: There is another connection with the name '%1$s'. " "Reference the connection by its uuid '%2$s'\n", "Warning: There are %3$u other connections with the name " "'%1$s'. Reference the connection by its uuid '%2$s'\n", found), id, nm_connection_get_uuid(NM_CONNECTION(connection)), found); } } static void add_connection_cb(GObject *client, GAsyncResult *result, gpointer user_data) { nm_auto_free_add_connection_info AddConnectionInfo *info = user_data; NmCli *nmc = info->nmc; NMRemoteConnection *connection; GError *error = NULL; connection = nm_client_add_connection2_finish(NM_CLIENT(client), result, NULL, &error); if (error) { g_string_printf(nmc->return_text, _("Error: Failed to add '%s' connection: %s"), info->new_id, error->message); g_error_free(error); nmc->return_value = NMC_RESULT_ERROR_CON_ACTIVATION; } else { connection_warnings(nmc, NM_CONNECTION(connection)); /* We print here human readable text, but as scripts might parse this output * (with LANG=C), this is important to not change in the future. At least * not unless called with a new command line flag, that requests a different output. * * That means, be very careful if you change this message, it might break * scripts!! * * This is true for many messages that the user might parse. But this one * seems in particular interesting for a user to parse. */ g_print(_("Connection '%s' (%s) successfully added.\n"), nm_connection_get_id(NM_CONNECTION(connection)), nm_connection_get_uuid(NM_CONNECTION(connection))); g_object_unref(connection); } quit(); } static void add_connection(NMClient *client, NMConnection *connection, gboolean temporary, GAsyncReadyCallback callback, gpointer user_data) { nm_client_add_connection2(client, nm_connection_to_dbus(connection, NM_CONNECTION_SERIALIZE_ALL), temporary ? NM_SETTINGS_ADD_CONNECTION2_FLAG_IN_MEMORY : NM_SETTINGS_ADD_CONNECTION2_FLAG_TO_DISK, NULL, TRUE, NULL, callback, user_data); } static gboolean is_single_word(const char *line) { size_t n1, n2, n3; n1 = strspn(line, " \t"); n2 = strcspn(line + n1, " \t\0") + n1; n3 = strspn(line + n2, " \t"); if (n3 == 0) return TRUE; else return FALSE; } static char ** nmcli_con_add_tab_completion(const char *text, int start, int end) { NMMetaSettingType s; char **match_array = NULL; rl_compentry_func_t *generator_func = NULL; gs_free char *no = g_strdup_printf("[%s]: ", _("no")); gs_free char *yes = g_strdup_printf("[%s]: ", _("yes")); const NMMetaAbstractInfo *info; /* Disable readline's default filename completion */ rl_attempted_completion_over = 1; /* Restore standard append character to space */ rl_completion_append_character = '\x00'; if (!is_single_word(rl_line_buffer)) return NULL; for (s = 0; s < _NM_META_SETTING_TYPE_NUM; s++) { const NMMetaPropertyInfo *const *property_infos; guint p; property_infos = nm_meta_setting_infos_editor[s].properties; if (!property_infos) continue; for (p = 0; property_infos[p]; p++) { const NMMetaPropertyInfo *property_info = property_infos[p]; if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; if (bi->base.prompt && g_str_has_prefix(rl_prompt, bi->base.prompt)) { goto next; } } } else { if (property_info->prompt && g_str_has_prefix(rl_prompt, property_info->prompt)) { info = (const NMMetaAbstractInfo *) property_info; nmc_tab_completion.words = _meta_abstract_complete(info, text); if (nmc_tab_completion.words) { match_array = rl_completion_matches(text, _meta_abstract_generator); nm_clear_pointer(&nmc_tab_completion.words, g_strfreev); } return match_array; } } } } next: if (g_str_has_prefix(rl_prompt, NM_META_TEXT_PROMPT_BT_TYPE)) generator_func = gen_func_bt_type; else if (g_str_has_prefix(rl_prompt, NM_META_TEXT_PROMPT_BOND_MODE)) generator_func = gen_func_bond_mode; else if (g_str_has_prefix(rl_prompt, NM_META_TEXT_PROMPT_BOND_MON_MODE)) generator_func = gen_func_bond_mon_mode; else if (g_str_has_suffix(rl_prompt, yes) || g_str_has_suffix(rl_prompt, no)) generator_func = gen_func_bool_values_l10n; if (generator_func) match_array = rl_completion_matches(text, generator_func); return match_array; } static void ask_option(NmCli *nmc, NMConnection *connection, const NMMetaAbstractInfo *abstract_info) { char *value; GError *error = NULL; gs_free char *prompt = NULL; gboolean multi; const char *setting_name, *property_name; const char *opt_prompt, *opt_def_hint; gs_free char *def_hint = NULL; gs_free char *property_val = NULL; NMMetaPropertyInfFlags inf_flags; NMSetting *setting; _meta_abstract_get(abstract_info, NULL, &setting_name, &property_name, NULL, &inf_flags, &opt_prompt, &opt_def_hint); if (!opt_def_hint) { setting = nm_connection_get_setting_by_name(connection, setting_name); if (setting) property_val = nmc_setting_get_property_parsable(setting, property_name, NULL); if (property_val) opt_def_hint = def_hint = g_strdup_printf("[%s]", property_val); } prompt = g_strjoin("", gettext(opt_prompt), opt_def_hint ? " " : "", opt_def_hint ?: "", ": ", NULL); multi = NM_FLAGS_HAS(inf_flags, NM_META_PROPERTY_INF_FLAG_MULTI); if (multi) g_print(_("You can specify this option more than once. Press when you're done.\n")); again: value = nmc_readline(&nmc->nmc_config, "%s", prompt); if (!set_option(nmc, connection, abstract_info, value, FALSE, &error)) { g_printerr("%s\n", error->message); g_clear_error(&error); goto again; } if (multi && value) goto again; } static NMMetaSettingType connection_get_base_meta_setting_type(NMConnection *connection) { const char *connection_type; NMSetting *base_setting; const NMMetaSettingInfoEditor *editor; connection_type = nm_connection_get_connection_type(connection); if (!connection_type) return NM_META_SETTING_TYPE_UNKNOWN; base_setting = nm_connection_get_setting_by_name(connection, connection_type); nm_assert(base_setting); editor = nm_meta_setting_info_editor_find_by_setting(base_setting); nm_assert(editor); return editor - nm_meta_setting_infos_editor; } static void questionnaire_mandatory_ask_setting(NmCli *nmc, NMConnection *connection, NMMetaSettingType type) { const NMMetaSettingInfoEditor *editor; const NMMetaPropertyInfo *property_info; guint p; editor = &nm_meta_setting_infos_editor[type]; if (!editor->properties) return; for (p = 0; editor->properties[p]; p++) { property_info = editor->properties[p]; if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; if (!option_relevant(connection, (const NMMetaAbstractInfo *) bi)) continue; if ((bi->base.inf_flags & NM_META_PROPERTY_INF_FLAG_REQD) || (_dynamic_options_get((const NMMetaAbstractInfo *) bi) & PROPERTY_INF_FLAG_ENABLED)) ask_option(nmc, connection, (const NMMetaAbstractInfo *) bi); } } else { if (!property_info->is_cli_option) continue; if (!option_relevant(connection, (const NMMetaAbstractInfo *) property_info)) continue; if ((property_info->inf_flags & NM_META_PROPERTY_INF_FLAG_REQD) || (_dynamic_options_get((const NMMetaAbstractInfo *) property_info) & PROPERTY_INF_FLAG_ENABLED)) ask_option(nmc, connection, (const NMMetaAbstractInfo *) property_info); } } } static void questionnaire_mandatory(NmCli *nmc, NMConnection *connection) { NMMetaSettingType s, base; /* First ask connection properties */ while (1) { base = connection_get_base_meta_setting_type(connection); if (base != NM_META_SETTING_TYPE_UNKNOWN) break; enable_options(NM_SETTING_CONNECTION_SETTING_NAME, NM_SETTING_CONNECTION_TYPE, NULL); questionnaire_mandatory_ask_setting(nmc, connection, NM_META_SETTING_TYPE_CONNECTION); } /* Ask properties of the base setting */ questionnaire_mandatory_ask_setting(nmc, connection, base); /* Remaining settings */ for (s = 0; s < _NM_META_SETTING_TYPE_NUM; s++) { if (!NM_IN_SET(s, NM_META_SETTING_TYPE_CONNECTION, base)) questionnaire_mandatory_ask_setting(nmc, connection, s); } } static gboolean want_provide_opt_args(const NmcConfig *nmc_config, const char *type, guint num) { gs_free char *answer = NULL; /* Don't ask to ask. */ if (num == 1) return TRUE; /* Ask for optional arguments. */ g_print(_("There are %d optional settings for %s.\n"), (int) num, type); answer = nmc_readline(nmc_config, _("Do you want to provide them? %s"), prompt_yes_no(TRUE, NULL)); nm_strstrip(answer); return !answer || matches(answer, WORD_YES); } static gboolean questionnaire_one_optional(NmCli *nmc, NMConnection *connection) { NMMetaSettingType base; gs_unref_ptrarray GPtrArray *infos = NULL; guint i, j; gboolean already_confirmed = FALSE; NMMetaSettingType s_asking = NM_META_SETTING_TYPE_UNKNOWN; NMMetaSettingType settings[_NM_META_SETTING_TYPE_NUM]; base = connection_get_base_meta_setting_type(connection); i = 0; settings[i++] = NM_META_SETTING_TYPE_CONNECTION; settings[i++] = base; for (j = 0; j < _NM_META_SETTING_TYPE_NUM; j++) { if (!NM_IN_SET(j, NM_META_SETTING_TYPE_CONNECTION, base)) settings[i++] = j; } infos = g_ptr_array_new(); /* Find first setting with relevant options and count them. */ again: for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) { const NMMetaPropertyInfo *const *property_infos; guint p; if (s_asking != NM_META_SETTING_TYPE_UNKNOWN && settings[i] != s_asking) continue; property_infos = nm_meta_setting_infos_editor[settings[i]].properties; if (!property_infos) continue; for (p = 0; property_infos[p]; p++) { const NMMetaPropertyInfo *property_info = property_infos[p]; if (_meta_property_needs_bond_hack(property_info)) { for (j = 0; j < nm_meta_property_typ_data_bond.nested_len; j++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[j]; if (!option_relevant(connection, (const NMMetaAbstractInfo *) bi)) continue; g_ptr_array_add(infos, (gpointer) bi); } } else { if (!property_info->is_cli_option) continue; if (!option_relevant(connection, (const NMMetaAbstractInfo *) property_info)) continue; g_ptr_array_add(infos, (gpointer) property_info); } } if (infos->len) { s_asking = settings[i]; break; } } if (infos->len) { const NMMetaSettingInfoEditor *setting_info = NULL; _meta_abstract_get(infos->pdata[0], &setting_info, NULL, NULL, NULL, NULL, NULL, NULL); /* Now ask for the settings. */ if (already_confirmed || want_provide_opt_args(&nmc->nmc_config, _(setting_info->pretty_name), infos->len)) { ask_option(nmc, connection, infos->pdata[0]); already_confirmed = TRUE; /* asking for an option may enable other options. Create the list again. */ g_ptr_array_set_size(infos, 0); goto again; } } if (s_asking == NM_META_SETTING_TYPE_UNKNOWN) return FALSE; /* Make sure we won't ask again. */ disable_options(nm_meta_setting_infos[s_asking].setting_name, NULL); return TRUE; } static void nmc_add_connection(NmCli *nmc, NMConnection *connection, gboolean temporary) { if (nmc->offline) { nmc_print_connection_and_quit(nmc, connection); } else { add_connection(nmc->client, connection, temporary, add_connection_cb, _add_connection_info_new(nmc, NULL, connection)); } } static void do_connection_add(const NMCCommand *cmd, NmCli *nmc, int argc, const char *const *argv) { gs_unref_object NMConnection *connection = NULL; NMSettingConnection *s_con; gs_free_error GError *error = NULL; gboolean save_bool = TRUE; gboolean seen_dash_dash = FALSE; NMMetaSettingType s; next_arg(nmc, &argc, &argv, NULL); rl_attempted_completion_function = nmcli_con_add_tab_completion; nmc->return_value = NMC_RESULT_SUCCESS; connection = nm_simple_connection_new(); s_con = (NMSettingConnection *) nm_setting_connection_new(); nm_connection_add_setting(connection, NM_SETTING(s_con)); read_properties: g_clear_error(&error); /* Get the arguments from the command line if any */ if (argc && !nmc_process_connection_properties(nmc, connection, &argc, &argv, FALSE, &error)) { if (nm_streq0(*argv, "--") && !seen_dash_dash) { /* This is for compatibility with older nmcli that required * options and properties to be separated with "--" */ seen_dash_dash = TRUE; next_arg(nmc, &argc, &argv, NULL); goto read_properties; } else if (nm_streq0(*argv, "save")) { /* It would be better if "save" was a separate argument and not * mixed with properties, but there's not much we can do about it now. */ argc--; argv++; if (!argc) { g_string_printf(nmc->return_text, _("Error: value for '%s' argument is required."), "save"); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; goto finish; } g_clear_error(&error); if (!nmc_string_to_bool(*argv, &save_bool, &error)) { g_string_printf(nmc->return_text, _("Error: 'save': %s."), error->message); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; goto finish; } next_arg(nmc, &argc, &argv, NULL); goto read_properties; } g_string_assign(nmc->return_text, error->message); nmc->return_value = error->code; goto finish; } if (nmc->complete) goto finish; if (!enable_type_settings_and_options(nmc, connection, &error)) { g_string_assign(nmc->return_text, error->message); nmc->return_value = error->code; goto finish; } /* Now ask user for the rest of the mandatory options. */ if (nmc->ask) questionnaire_mandatory(nmc, connection); /* Traditionally, we didn't ask for these options for ethernet slaves. They don't * make much sense, since these are likely to be set by the master anyway. */ if (nm_setting_connection_get_slave_type(s_con)) { disable_options(NM_SETTING_WIRED_SETTING_NAME, NM_SETTING_WIRED_MTU); disable_options(NM_SETTING_WIRED_SETTING_NAME, NM_SETTING_WIRED_MAC_ADDRESS); disable_options(NM_SETTING_WIRED_SETTING_NAME, NM_SETTING_WIRED_CLONED_MAC_ADDRESS); } /* Connection id is special in that it's required but we don't insist * on getting it from the user -- we just make up something sensible. */ if (!nm_setting_connection_get_id(s_con)) { const char *ifname = nm_setting_connection_get_interface_name(s_con); const char *type = nm_setting_connection_get_connection_type(s_con); const char *slave_type = nm_setting_connection_get_slave_type(s_con); /* If only bother when there's a type, which is not guaranteed at this point. * Otherwise, the validation will fail anyway. */ if (type) { gs_free char *try_name = NULL; gs_free char *default_name = NULL; const GPtrArray *connections; connections = nmc_get_connections(nmc); try_name = ifname ? g_strdup_printf("%s-%s", get_name_alias_toplevel(type, slave_type), ifname) : g_strdup(get_name_alias_toplevel(type, slave_type)); default_name = nmc_unique_connection_name(connections, try_name); g_object_set(s_con, NM_SETTING_CONNECTION_ID, default_name, NULL); } } /* Now see if there's something optional that needs to be asked for. * Keep asking until there's no more things to ask for. */ do { /* This ensures all settings that make sense are present. */ nm_connection_normalize(connection, NULL, NULL, NULL); } while (nmc->ask && questionnaire_one_optional(nmc, connection)); /* Mandatory settings. No good reason to check this other than guarding the user * from doing something that's not likely to make sense (such as missing ifname * on a bond/bridge/team, etc.). Added just to preserve traditional behavior, it * perhaps is a good idea to just remove this. */ for (s = 0; s < _NM_META_SETTING_TYPE_NUM; s++) { const NMMetaPropertyInfo *const *property_infos; guint p; property_infos = nm_meta_setting_infos_editor[s].properties; if (!property_infos) continue; for (p = 0; property_infos[p]; p++) { const NMMetaPropertyInfo *property_info = property_infos[p]; if (_meta_property_needs_bond_hack(property_info)) { guint i; for (i = 0; i < nm_meta_property_typ_data_bond.nested_len; i++) { const NMMetaNestedPropertyInfo *bi = &nm_meta_property_typ_data_bond.nested[i]; if (!option_relevant(connection, (const NMMetaAbstractInfo *) bi)) continue; if (bi->base.inf_flags & NM_META_PROPERTY_INF_FLAG_REQD) { g_string_printf(nmc->return_text, _("Error: '%s' argument is required."), bi->base.property_alias); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; goto finish; } } } else { if (!property_info->is_cli_option) continue; if (!option_relevant(connection, (const NMMetaAbstractInfo *) property_info)) continue; if (property_info->inf_flags & NM_META_PROPERTY_INF_FLAG_REQD) { g_string_printf(nmc->return_text, _("Error: '%s' argument is required."), property_info->property_alias); nmc->return_value = NMC_RESULT_ERROR_USER_INPUT; goto finish; } } } } nmc_add_connection(nmc, connection, !save_bool); nmc->should_wait++; finish: reset_options(); } /*****************************************************************************/ /* Functions for readline TAB completion in editor */ #if HAVE_EDITLINE_READLINE #define uuid_display_hook ((void (*)(void)) NULL) #else static void uuid_display_hook(char **array, int len, int max_len) { const GPtrArray *connections; NMConnection *con; int i, max = 0; char *tmp; const char *id; for (i = 1; i <= len; i++) { connections = nmc_get_connections(nmc_tab_completion.nmc); con = nmc_find_connection(connections, "uuid", array[i], NULL, FALSE); id = con ? nm_connection_get_id(con) : NULL; if (id) { tmp = g_strdup_printf("%s (%s)", array[i], id); g_free(array[i]); array[i] = tmp; if (max < strlen(id)) max = strlen(id); } } rl_display_match_list(array, len, max_len + max + 3); rl_forced_update_display(); } #endif static char * gen_nmcli_cmds_menu(const char *text, int state) { const char *words[] = {"goto", "set", "remove", "describe", "print", "verify", "save", "activate", "back", "help", "quit", "nmcli", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_nmcli_cmds_submenu(const char *text, int state) { const char *words[] = {"set", "add", "change", "remove", "describe", "print", "back", "help", "quit", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_cmd_nmcli(const char *text, int state) { const char *words[] = {"status-line", "save-confirmation", "show-secrets", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_func_bool_values(const char *text, int state) { const char *words[] = {"yes", "no", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_cmd_verify0(const char *text, int state) { const char *words[] = {"all", "fix", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_cmd_print0(const char *text, int state) { static char **words = NULL; char *ret = NULL; if (!state) { GVariant *settings; GVariantIter iter; const char *setting_name; int i = 0; settings = nm_connection_to_dbus(nmc_tab_completion.connection, NM_CONNECTION_SERIALIZE_WITH_NON_SECRET); words = g_new(char *, g_variant_n_children(settings) + 2); g_variant_iter_init(&iter, settings); while (g_variant_iter_next(&iter, "{&s@a{sv}}", &setting_name, NULL)) words[i++] = g_strdup(setting_name); words[i++] = g_strdup("all"); words[i] = NULL; g_variant_unref(settings); } if (words) { ret = nmc_rl_gen_func_basic(text, state, (const char **) words); if (ret == NULL) { g_strfreev(words); words = NULL; } } return ret; } static char * gen_cmd_print2(const char *text, int state) { const char *words[] = {"setting", "connection", "all", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static char * gen_cmd_save(const char *text, int state) { const char *words[] = {"persistent", "temporary", NULL}; return nmc_rl_gen_func_basic(text, state, words); } static rl_compentry_func_t * gen_connection_types(const char *text) { gs_free char **values = NULL; const NMMetaSettingInfoEditor *editor; GPtrArray *array; int i; array = g_ptr_array_new(); for (i = 0; i < _NM_META_SETTING_TYPE_NUM; i++) { editor = &nm_meta_setting_infos_editor[i]; if (!editor->valid_parts) continue; g_ptr_array_add(array, (gpointer) nm_meta_setting_infos[i].setting_name); if (editor->alias) g_ptr_array_add(array, (gpointer) editor->alias); } g_ptr_array_add(array, "bond-slave"); g_ptr_array_add(array, "bridge-slave"); g_ptr_array_add(array, "team-slave"); g_ptr_array_add(array, NULL); values = (char **) g_ptr_array_free(array, FALSE); return nmc_rl_compentry_func_wrap((const char *const *) values); } static char * gen_setting_names(const char *text, int state) { static int list_idx, len, is_slv; const char *s_name, *a_name; const NMMetaSettingValidPartItem *const *valid_settings_arr; NMSettingConnection *s_con; const char *s_type = NULL; if (!state) { list_idx = 0; len = strlen(text); is_slv = 0; } if (!is_slv) { valid_settings_arr = get_valid_settings_array(nmc_tab_completion.con_type); if (list_idx >= NM_PTRARRAY_LEN(valid_settings_arr)) return NULL; for (; valid_settings_arr[list_idx];) { const NMMetaSettingInfoEditor *setting_info = valid_settings_arr[list_idx]->setting_info; a_name = setting_info->alias; s_name = setting_info->general->setting_name; list_idx++; if (len == 0 && a_name) return g_strdup_printf("%s (%s)", s_name, a_name); if (a_name && !strncmp(text, a_name, len)) return g_strdup(a_name); if (s_name && !strncmp(text, s_name, len)) return g_strdup(s_name); } /* Let's give a try to parameters related to slave type */ list_idx = 0; is_slv = 1; } /* is_slv */ s_con = nm_connection_get_setting_connection(nmc_tab_completion.connection); if (s_con) s_type = nm_setting_connection_get_slave_type(s_con); valid_settings_arr = nm_meta_setting_info_valid_parts_for_slave_type(s_type, NULL); if (list_idx < NM_PTRARRAY_LEN(valid_settings_arr)) { while (valid_settings_arr[list_idx]) { const NMMetaSettingInfoEditor *setting_info = valid_settings_arr[list_idx]->setting_info; a_name = setting_info->alias; s_name = setting_info->general->setting_name; list_idx++; if (len == 0 && a_name) return g_strdup_printf("%s (%s)", s_name, a_name); if (a_name && !strncmp(text, a_name, len)) return g_strdup(a_name); if (s_name && !strncmp(text, s_name, len)) return g_strdup(s_name); } } return NULL; } static char * gen_property_names(const char *text, int state) { NMSetting *setting = NULL; char **valid_props = NULL; char *ret = NULL; const char *line = rl_line_buffer; const char *setting_name; char **strv = NULL; const NMMetaSettingValidPartItem *const *valid_settings_main; const NMMetaSettingValidPartItem *const *valid_settings_slave; const char *p1; const char *slv_type; /* Try to get the setting from 'line' - setting_name.property */ p1 = strchr(line, '.'); if (p1) { while (p1 > line && !g_ascii_isspace(*p1)) p1--; strv = g_strsplit(p1 + 1, ".", 2); valid_settings_main = get_valid_settings_array(nmc_tab_completion.con_type); /* Support autocompletion of slave-connection parameters * guessing the slave type from the setting name already * typed (or autocompleted) */ if (nm_streq0(strv[0], NM_SETTING_TEAM_PORT_SETTING_NAME)) slv_type = NM_SETTING_TEAM_SETTING_NAME; else if (nm_streq0(strv[0], NM_SETTING_BRIDGE_PORT_SETTING_NAME)) slv_type = NM_SETTING_BRIDGE_SETTING_NAME; else if (nm_streq0(strv[0], NM_SETTING_BOND_PORT_SETTING_NAME)) slv_type = NM_SETTING_BOND_SETTING_NAME; else slv_type = NULL; valid_settings_slave = nm_meta_setting_info_valid_parts_for_slave_type(slv_type, NULL); setting_name = check_valid_name(strv[0], valid_settings_main, valid_settings_slave, NULL); if (setting_name) { setting = nm_meta_setting_info_editor_new_setting( nm_meta_setting_info_editor_find_by_name(setting_name, FALSE), NM_META_ACCESSOR_SETTING_INIT_TYPE_DEFAULT); } } if (!setting) { /* Else take the current setting, if any */ setting = nmc_tab_completion.setting ? g_object_ref(nmc_tab_completion.setting) : NULL; } if (setting) { valid_props = nmc_setting_get_valid_properties(setting); ret = nmc_rl_gen_func_basic(text, state, (const char **) valid_props); } g_strfreev(strv); g_strfreev(valid_props); if (setting) g_object_unref(setting); return ret; } static char * gen_compat_devices(const char *text, int state) { guint i, j = 0; const GPtrArray *devices; const char **compatible_devices; char *ret; devices = nm_client_get_devices(nmc_tab_completion.nmc->client); if (devices->len == 0) return NULL; compatible_devices = g_new(const char *, devices->len + 1); for (i = 0; i < devices->len; i++) { NMDevice *dev = g_ptr_array_index(devices, i); const char *ifname = nm_device_get_iface(dev); NMDevice *device = NULL; const char *spec_object = NULL; if (find_device_for_connection(nmc_tab_completion.nmc, nmc_tab_completion.connection, ifname, NULL, NULL, &device, &spec_object, NULL)) { compatible_devices[j++] = ifname; } } compatible_devices[j] = NULL; ret = nmc_rl_gen_func_basic(text, state, compatible_devices); g_free(compatible_devices); return ret; } static const char ** _create_vpn_array(const GPtrArray *connections, gboolean uuid) { int c, idx = 0; const char **array; if (connections->len < 1) return NULL; array = g_new(const char *, connections->len + 1); for (c = 0; c < connections->len; c++) { NMConnection *connection = NM_CONNECTION(connections->pdata[c]); const char *type = nm_connection_get_connection_type(connection); if (nm_streq0(type, NM_SETTING_VPN_SETTING_NAME)) array[idx++] = uuid ? nm_connection_get_uuid(connection) : nm_connection_get_id(connection); } array[idx] = NULL; return array; } static char * gen_vpn_uuids(const char *text, int state) { const GPtrArray *connections; const char **uuids; char *ret; connections = nmc_get_connections(nm_cli_global_readline); if (connections->len < 1) return NULL; uuids = _create_vpn_array(connections, TRUE); ret = nmc_rl_gen_func_basic(text, state, uuids); g_free(uuids); return ret; } static char * gen_vpn_ids(const char *text, int state) { const GPtrArray *connections; const char **ids; char *ret; connections = nmc_get_connections(nm_cli_global_readline); if (connections->len < 1) return NULL; ids = _create_vpn_array(connections, FALSE); ret = nmc_rl_gen_func_basic(text, state, ids); g_free(ids); return ret; } static rl_compentry_func_t * get_gen_func_cmd_nmcli(const char *str) { if (!str) return NULL; if (matches(str, "status-line")) return gen_func_bool_values; if (matches(str, "save-confirmation")) return gen_func_bool_values; if (matches(str, "show-secrets")) return gen_func_bool_values; return NULL; } /* * Helper function parsing line for completion. * IN: * line : the whole line to be parsed * end : the position of cursor in the line * cmd : command to match * OUT: * cw_num : is set to the word number being completed (1, 2, 3, 4). * prev_word : returns the previous word (so that we have some context). * * Returns TRUE when the first word of the 'line' matches 'cmd'. * * Examples: * line="rem" cmd="remove" -> TRUE cw_num=1 * line="set con" cmd="set" -> TRUE cw_num=2 * line="go ipv4.method" cmd="goto" -> TRUE cw_num=2 * line=" des eth.mtu " cmd="describe" -> TRUE cw_num=3 * line=" bla ipv4.method" cmd="goto" -> FALSE */ static gboolean should_complete_cmd(const char *line, int end, const char *cmd, int *cw_num, char **prev_word) { char *tmp; const char *word1, *word2, *word3; size_t n1, n2, n3, n4, n5, n6; gboolean word1_done, word2_done, word3_done; gboolean ret = FALSE; if (!line) return FALSE; tmp = g_strdup(line); n1 = strspn(tmp, " \t"); n2 = strcspn(tmp + n1, " \t\0") + n1; n3 = strspn(tmp + n2, " \t") + n2; n4 = strcspn(tmp + n3, " \t\0") + n3; n5 = strspn(tmp + n4, " \t") + n4; n6 = strcspn(tmp + n5, " \t\0") + n5; word1_done = end > n2; word2_done = end > n4; word3_done = end > n6; tmp[n2] = tmp[n4] = tmp[n6] = '\0'; word1 = tmp[n1] ? tmp + n1 : NULL; word2 = tmp[n3] ? tmp + n3 : NULL; word3 = tmp[n5] ? tmp + n5 : NULL; if (!word1_done) { if (cw_num) *cw_num = 1; if (prev_word) *prev_word = NULL; } else if (!word2_done) { if (cw_num) *cw_num = 2; if (prev_word) *prev_word = g_strdup(word1); } else if (!word3_done) { if (cw_num) *cw_num = 3; if (prev_word) *prev_word = g_strdup(word2); } else { if (cw_num) *cw_num = 4; if (prev_word) *prev_word = g_strdup(word3); } if (word1 && matches(word1, cmd)) ret = TRUE; g_free(tmp); return ret; } /* * extract_setting_and_property: * prompt: (in) (allow-none): prompt string, or NULL * line: (in) (allow-none): line, or NULL * setting: (out) (transfer full) (array zero-terminated=1): * return location for setting name * property: (out) (transfer full) (array zero-terminated=1): * return location for property name * * Extract setting and property names from prompt and/or line. */ static void extract_setting_and_property(const char *prompt, const char *line, char **setting, char **property) { char *prop = NULL; char *sett = NULL; if (prompt) { /* prompt looks like this: * "nmcli 802-1x>" or "nmcli 802-1x.pac-file>" */ const char *p1, *p2, *dot; size_t num1, num2; p1 = strchr(prompt, ' '); if (p1) { dot = strchr(++p1, '.'); if (dot) { p2 = dot + 1; num1 = strcspn(p1, "."); num2 = strcspn(p2, ">"); sett = num1 > 0 ? g_strndup(p1, num1) : NULL; prop = num2 > 0 ? g_strndup(p2, num2) : NULL; } else { num1 = strcspn(p1, ">"); sett = num1 > 0 ? g_strndup(p1, num1) : NULL; } } } if (line) { /* line looks like this: * " set 802-1x.pac-file ..." or " set pac-file ..." */ const char *p1, *p2, *dot; size_t n1, n2, n3, n4; size_t num1, num2, len; n1 = strspn(line, " \t"); /* white-space */ n2 = strcspn(line + n1, " \t\0") + n1; /* command */ n3 = strspn(line + n2, " \t") + n2; /* white-space */ n4 = strcspn(line + n3, " \t\0") + n3; /* setting/property */ p1 = line + n3; len = n4 - n3; dot = strchr(p1, '.'); if (dot && dot < p1 + len) { p2 = dot + 1; num1 = strcspn(p1, "."); num2 = len > num1 + 1 ? len - num1 - 1 : 0; sett = num1 > 0 ? g_strndup(p1, num1) : sett; prop = num2 > 0 ? g_strndup(p2, num2) : prop; } else { if (!prop) prop = len > 0 ? g_strndup(p1, len) : NULL; } } if (setting) *setting = sett; else g_free(sett); if (property) *property = prop; else g_free(prop); } static void get_setting_and_property(const char *prompt, const char *line, NMSetting **setting_out, char **property_out) { const NMMetaSettingValidPartItem *const *valid_settings_main; const NMMetaSettingValidPartItem *const *valid_settings_slave; gs_unref_object NMSetting *setting = NULL; gs_free char *property = NULL; NMSettingConnection *s_con; gs_free char *sett = NULL; gs_free char *prop = NULL; const char *s_type = NULL; const char *setting_name; extract_setting_and_property(prompt, line, &sett, &prop); if (sett) { /* Is this too much (and useless?) effort for an unlikely case? */ s_con = nm_connection_get_setting_connection(nmc_tab_completion.connection); if (s_con) s_type = nm_setting_connection_get_slave_type(s_con); valid_settings_main = get_valid_settings_array(nmc_tab_completion.con_type); valid_settings_slave = nm_meta_setting_info_valid_parts_for_slave_type(s_type, NULL); setting_name = check_valid_name(sett, valid_settings_main, valid_settings_slave, NULL); setting = nm_meta_setting_info_editor_new_setting( nm_meta_setting_info_editor_find_by_name(setting_name, FALSE), NM_META_ACCESSOR_SETTING_INIT_TYPE_DEFAULT); } else setting = nm_g_object_ref(nmc_tab_completion.setting); if (setting && prop) property = is_property_valid(setting, prop, NULL); else property = g_strdup(nmc_tab_completion.property); *setting_out = g_steal_pointer(&setting); *property_out = g_steal_pointer(&property); } static gboolean _get_and_check_property(const char *prompt, const char *line, const char **array, const char **array_multi, gboolean *multi) { gs_free char *prop = NULL; gboolean found = FALSE; extract_setting_and_property(prompt, line, NULL, &prop); if (prop) { if (array) found = !!nmc_string_is_valid(prop, array, NULL); if (array_multi && multi) *multi = !!nmc_string_is_valid(prop, array_multi, NULL); } return found; } static gboolean should_complete_files(const char *prompt, const char *line) { const char *file_properties[] = {/* '802-1x' properties */ "ca-cert", "ca-path", "client-cert", "pac-file", "phase2-ca-cert", "phase2-ca-path", "phase2-client-cert", "private-key", "phase2-private-key", /* 'team' and 'team-port' properties */ "config", /* 'proxy' properties */ "pac-script", NULL}; return _get_and_check_property(prompt, line, file_properties, NULL, NULL); } static gboolean should_complete_vpn_uuids(const char *prompt, const char *line) { const char *uuid_properties[] = {/* 'connection' properties */ "secondaries", NULL}; return _get_and_check_property(prompt, line, uuid_properties, NULL, NULL); } static const char *const * get_allowed_property_values(char ***out_to_free) { gs_unref_object NMSetting *setting = NULL; gs_free char *property = NULL; const char *const *avals = NULL; get_setting_and_property(rl_prompt, rl_line_buffer, &setting, &property); if (setting && property) avals = nmc_setting_get_property_allowed_values(setting, property, out_to_free); return avals; } static gboolean should_complete_property_values(const char *prompt, const char *line, gboolean *multi) { gs_strfreev char **to_free = NULL; /* properties allowing multiple values */ const char *multi_props[] = {/* '802-1x' properties */ NM_SETTING_802_1X_EAP, /* '802-11-wireless-security' properties */ NM_SETTING_WIRELESS_SECURITY_PROTO, NM_SETTING_WIRELESS_SECURITY_PAIRWISE, NM_SETTING_WIRELESS_SECURITY_GROUP, /* 'bond' properties */ NM_SETTING_BOND_OPTIONS, /* 'ethernet' properties */ NM_SETTING_WIRED_S390_OPTIONS, NULL}; _get_and_check_property(prompt, line, NULL, multi_props, multi); return !!get_allowed_property_values(&to_free); } static gboolean _setting_property_is_boolean(NMSetting *setting, const char *property_name) { const GParamSpec *pspec; nm_assert(NM_IS_SETTING(setting)); nm_assert(property_name); pspec = g_object_class_find_property(G_OBJECT_GET_CLASS(setting), property_name); return pspec && pspec->value_type == G_TYPE_BOOLEAN; } static gboolean should_complete_boolean(const char *prompt, const char *line) { gs_unref_object NMSetting *setting = NULL; gs_free char *property = NULL; get_setting_and_property(prompt, line, &setting, &property); return setting && property && _setting_property_is_boolean(setting, property); } static char * gen_property_values(const char *text, int state) { gs_strfreev char **to_free = NULL; const char *const *avals; avals = get_allowed_property_values(&to_free); if (!avals) return NULL; return nmc_rl_gen_func_basic(text, state, avals); } #if !HAVE_EDITLINE_READLINE /* from readline */ extern int rl_complete_with_tilde_expansion; #endif /* * Attempt to complete on the contents of TEXT. START and END show the * region of TEXT that contains the word to complete. We can use the * entire line in case we want to do some simple parsing. Return the * array of matches, or NULL if there aren't any. */ static char ** nmcli_editor_tab_completion(const char *text, int start, int end) { rl_compentry_func_t *generator_func = NULL; const char *line = rl_line_buffer; gs_free char *prompt_tmp = NULL; gs_free char *word = NULL; char **match_array = NULL; size_t n1; int num; /* Restore standard append character to space */ rl_completion_append_character = ' '; /* Restore standard function for displaying matches */ rl_completion_display_matches_hook = NULL; /* Disable default filename completion */ rl_attempted_completion_over = 1; #if !HAVE_EDITLINE_READLINE /* Enable tilde expansion when filenames are completed */ rl_complete_with_tilde_expansion = 1; #endif /* Filter out possible ANSI color escape sequences */ prompt_tmp = nmc_filter_out_colors((const char *) rl_prompt); /* Find the first non-space character */ n1 = strspn(line, " \t"); /* Choose the right generator function */ if (nm_streq(prompt_tmp, EDITOR_PROMPT_CON_TYPE)) generator_func = gen_connection_types(text); else if (nm_streq(prompt_tmp, EDITOR_PROMPT_SETTING)) generator_func = gen_setting_names; else if (nm_streq(prompt_tmp, EDITOR_PROMPT_PROPERTY)) generator_func = gen_property_names; else if (g_str_has_suffix(rl_prompt, prompt_yes_no(TRUE, NULL)) || g_str_has_suffix(rl_prompt, prompt_yes_no(FALSE, NULL))) generator_func = gen_func_bool_values_l10n; else if (g_str_has_prefix(prompt_tmp, "nmcli")) { if (!strchr(prompt_tmp, '.')) { int level = g_str_has_prefix(prompt_tmp, "nmcli>") ? 0 : 1; const char *dot = strchr(line, '.'); gboolean multi; /* Main menu - level 0,1 */ if (start == n1) generator_func = gen_nmcli_cmds_menu; else { if (should_complete_cmd(line, end, "goto", &num, NULL) && num <= 2) { if (level == 0 && (!dot || dot >= line + end)) generator_func = gen_setting_names; else generator_func = gen_property_names; } else if (should_complete_cmd(line, end, "set", &num, NULL)) { if (num < 3) { if (level == 0 && (!dot || dot >= line + end)) { generator_func = gen_setting_names; rl_completion_append_character = '.'; } else generator_func = gen_property_names; } else { if (num == 3 && should_complete_files(NULL, line)) rl_attempted_completion_over = 0; else if (should_complete_vpn_uuids(NULL, line)) { rl_completion_display_matches_hook = uuid_display_hook; generator_func = gen_vpn_uuids; } else if (should_complete_property_values(NULL, line, &multi) && (num == 3 || multi)) { generator_func = gen_property_values; } else if (should_complete_boolean(NULL, line) && num == 3) generator_func = gen_func_bool_values; } } else if ((should_complete_cmd(line, end, "remove", &num, NULL) || should_complete_cmd(line, end, "describe", &num, NULL)) && num <= 2) { if (level == 0 && (!dot || dot >= line + end)) { generator_func = gen_setting_names; rl_completion_append_character = '.'; } else generator_func = gen_property_names; } else if (should_complete_cmd(line, end, "nmcli", &num, &word)) { if (num < 3) generator_func = gen_cmd_nmcli; else if (num == 3) generator_func = get_gen_func_cmd_nmcli(word); } else if (should_complete_cmd(line, end, "print", &num, NULL) && num <= 2) { if (level == 0 && (!dot || dot >= line + end)) generator_func = gen_cmd_print0; else generator_func = gen_property_names; } else if (should_complete_cmd(line, end, "verify", &num, NULL) && num <= 2) { generator_func = gen_cmd_verify0; } else if (should_complete_cmd(line, end, "activate", &num, NULL) && num <= 2) { generator_func = gen_compat_devices; } else if (should_complete_cmd(line, end, "save", &num, NULL) && num <= 2) { generator_func = gen_cmd_save; } else if (should_complete_cmd(line, end, "help", &num, NULL) && num <= 2) generator_func = gen_nmcli_cmds_menu; } } else { /* Submenu - level 2 */ if (start == n1) generator_func = gen_nmcli_cmds_submenu; else { gboolean multi; if (should_complete_cmd(line, end, "add", &num, NULL) || should_complete_cmd(line, end, "set", &num, NULL)) { if (num <= 2 && should_complete_files(prompt_tmp, line)) rl_attempted_completion_over = 0; else if (should_complete_vpn_uuids(prompt_tmp, line)) { rl_completion_display_matches_hook = uuid_display_hook; generator_func = gen_vpn_uuids; } else if (should_complete_property_values(prompt_tmp, NULL, &multi) && (num <= 2 || multi)) { generator_func = gen_property_values; } else if (should_complete_boolean(prompt_tmp, NULL) && num <= 2) generator_func = gen_func_bool_values; } if (should_complete_cmd(line, end, "print", &num, NULL) && num <= 2) generator_func = gen_cmd_print2; else if (should_complete_cmd(line, end, "help", &num, NULL) && num <= 2) generator_func = gen_nmcli_cmds_submenu; } } } if (generator_func) match_array = rl_completion_matches(text, generator_func); return match_array; } #define NMCLI_EDITOR_HISTORY ".nmcli-history" static void load_history_cmds(const char *uuid) { GKeyFile *kf; char *filename; char **keys; char *line; size_t i; GError *err = NULL; filename = g_build_filename(g_get_home_dir(), NMCLI_EDITOR_HISTORY, NULL); kf = g_key_file_new(); if (!g_key_file_load_from_file(kf, filename, G_KEY_FILE_KEEP_COMMENTS, &err)) { if (g_error_matches(err, G_KEY_FILE_ERROR, G_KEY_FILE_ERROR_PARSE)) g_print("Warning: %s parse error: %s\n", filename, err->message); g_key_file_free(kf); g_free(filename); return; } keys = g_key_file_get_keys(kf, uuid, NULL, NULL); for (i = 0; keys && keys[i]; i++) { line = g_key_file_get_string(kf, uuid, keys[i], NULL); if (line && *line) add_history(line); g_free(line); } g_strfreev(keys); g_key_file_free(kf); g_free(filename); } static void save_history_cmds(const char *uuid) { nm_auto_unref_keyfile GKeyFile *kf = NULL; gs_free_error GError *error = NULL; gs_free char *filename = NULL; gs_free char *data = NULL; HIST_ENTRY **hist; gsize len; gsize i; hist = history_list(); if (!hist) return; filename = g_build_filename(g_get_home_dir(), NMCLI_EDITOR_HISTORY, NULL); kf = g_key_file_new(); if (!g_key_file_load_from_file(kf, filename, G_KEY_FILE_KEEP_COMMENTS, &error)) { if (!g_error_matches(error, G_FILE_ERROR, G_FILE_ERROR_NOENT) && !g_error_matches(error, G_KEY_FILE_ERROR, G_KEY_FILE_ERROR_NOT_FOUND)) { g_print("Warning: %s parse error: %s\n", filename, error->message); return; } g_clear_error(&error); } /* Remove previous history group and save new history entries */ g_key_file_remove_group(kf, uuid, NULL); for (i = 0; hist[i]; i++) { char key[100]; nm_sprintf_buf(key, "%zd", i); g_key_file_set_string(kf, uuid, key, hist[i]->line); } /* Write history to file */ data = g_key_file_to_data(kf, &len, NULL); if (data) g_file_set_contents(filename, data, len, NULL); } /*****************************************************************************/ static void editor_show_connection(NMConnection *connection, NmCli *nmc) { nmc->nmc_config_mutable.print_output = NMC_PRINT_PRETTY; nmc->nmc_config_mutable.multiline_output = TRUE; nmc->nmc_config_mutable.escape_values = 0; nmc_connection_profile_details(connection, nmc); } static void editor_show_setting(NMSetting *setting, NmCli *nmc) { g_print(_("['%s' setting values]\n"), nm_setting_get_name(setting)); nmc->nmc_config_mutable.print_output = NMC_PRINT_NORMAL; nmc->nmc_config_mutable.multiline_output = TRUE; nmc->nmc_config_mutable.escape_values = 0; setting_details(&nmc->nmc_config, setting, NULL); } typedef enum { NMC_EDITOR_MAIN_CMD_UNKNOWN = 0, NMC_EDITOR_MAIN_CMD_GOTO, NMC_EDITOR_MAIN_CMD_REMOVE, NMC_EDITOR_MAIN_CMD_SET, NMC_EDITOR_MAIN_CMD_DESCRIBE, NMC_EDITOR_MAIN_CMD_PRINT, NMC_EDITOR_MAIN_CMD_VERIFY, NMC_EDITOR_MAIN_CMD_SAVE, NMC_EDITOR_MAIN_CMD_ACTIVATE, NMC_EDITOR_MAIN_CMD_BACK, NMC_EDITOR_MAIN_CMD_HELP, NMC_EDITOR_MAIN_CMD_NMCLI, NMC_EDITOR_MAIN_CMD_QUIT, NMC_EDITOR_MAIN_CMD_ADD, } NmcEditorMainCmd; static void _split_cmd(const char *cmd, char **out_arg0, const char **out_argr) { gs_free char *arg0 = NULL; const char *argr = NULL; gsize l; NM_SET_OUT(out_arg0, NULL); NM_SET_OUT(out_argr, NULL); if (!cmd) return; while (nm_utils_is_separator(cmd[0])) cmd++; if (!cmd[0]) return; l = strcspn(cmd, " \t"); arg0 = g_strndup(cmd, l); cmd += l; if (cmd[0]) { while (nm_utils_is_separator(cmd[0])) cmd++; if (cmd[0]) argr = cmd; } NM_SET_OUT(out_arg0, g_steal_pointer(&arg0)); NM_SET_OUT(out_argr, argr); } static NmcEditorMainCmd parse_editor_main_cmd(const char *cmd, char **cmd_arg) { NmcEditorMainCmd editor_cmd = NMC_EDITOR_MAIN_CMD_UNKNOWN; gs_free char *cmd_arg0 = NULL; const char *cmd_argr; _split_cmd(cmd, &cmd_arg0, &cmd_argr); if (!cmd_arg0) goto fail; if (matches(cmd_arg0, "goto")) editor_cmd = NMC_EDITOR_MAIN_CMD_GOTO; else if (matches(cmd_arg0, "remove")) editor_cmd = NMC_EDITOR_MAIN_CMD_REMOVE; else if (matches(cmd_arg0, "set")) editor_cmd = NMC_EDITOR_MAIN_CMD_SET; else if (matches(cmd_arg0, "add")) editor_cmd = NMC_EDITOR_MAIN_CMD_ADD; else if (matches(cmd_arg0, "describe")) editor_cmd = NMC_EDITOR_MAIN_CMD_DESCRIBE; else if (matches(cmd_arg0, "print")) editor_cmd = NMC_EDITOR_MAIN_CMD_PRINT; else if (matches(cmd_arg0, "verify")) editor_cmd = NMC_EDITOR_MAIN_CMD_VERIFY; else if (matches(cmd_arg0, "save")) editor_cmd = NMC_EDITOR_MAIN_CMD_SAVE; else if (matches(cmd_arg0, "activate")) editor_cmd = NMC_EDITOR_MAIN_CMD_ACTIVATE; else if (matches(cmd_arg0, "back")) editor_cmd = NMC_EDITOR_MAIN_CMD_BACK; else if (matches(cmd_arg0, "help") || nm_streq(cmd_arg0, "?")) editor_cmd = NMC_EDITOR_MAIN_CMD_HELP; else if (matches(cmd_arg0, "quit")) editor_cmd = NMC_EDITOR_MAIN_CMD_QUIT; else if (matches(cmd_arg0, "nmcli")) editor_cmd = NMC_EDITOR_MAIN_CMD_NMCLI; else goto fail; NM_SET_OUT(cmd_arg, g_strdup(cmd_argr)); return editor_cmd; fail: NM_SET_OUT(cmd_arg, NULL); return NMC_EDITOR_MAIN_CMD_UNKNOWN; } static void editor_main_usage(void) { g_print("------------------------------------------------------------------------------\n"); /* TRANSLATORS: do not translate command names and keywords before :: * However, you should translate terms enclosed in <>. */ g_print(_("---[ Main menu ]---\n" "goto [ | ] :: go to a setting or property\n" "remove [.] | :: remove setting or reset property value\n" "set [. ] :: set property value\n" "describe [.] :: describe property\n" "print [all | [.]] :: print the connection\n" "verify [all | fix] :: verify the connection\n" "save [persistent|temporary] :: save the connection\n" "activate [] [/|] :: activate the connection\n" "back :: go one level up (back)\n" "help/? [] :: print this help\n" "nmcli :: nmcli configuration\n" "quit :: exit nmcli\n")); g_print("------------------------------------------------------------------------------\n"); } static void editor_main_help(const char *command) { if (!command) editor_main_usage(); else { /* detailed command descriptions */ NmcEditorMainCmd cmd = parse_editor_main_cmd(command, NULL); switch (cmd) { case NMC_EDITOR_MAIN_CMD_GOTO: g_print(_("goto [.] | :: enter setting/property for editing\n\n" "This command enters into a setting or property for editing it.\n\n" "Examples: nmcli> goto connection\n" " nmcli connection> goto secondaries\n" " nmcli> goto ipv4.addresses\n")); break; case NMC_EDITOR_MAIN_CMD_REMOVE: g_print( _("remove [.] :: remove setting or reset property value\n\n" "This command removes an entire setting from the connection, or if a property\n" "is given, resets that property to the default value.\n\n" "Examples: nmcli> remove wifi-sec\n" " nmcli> remove eth.mtu\n")); break; case NMC_EDITOR_MAIN_CMD_SET: g_print(_("set [. ] :: set property value\n\n" "This command sets property value.\n\n" "Example: nmcli> set con.id My connection\n")); break; case NMC_EDITOR_MAIN_CMD_ADD: g_print(_("add [. ] :: add property value\n\n" "This command appends property value.\n\n" "Example: nmcli> add ipv4.addresses 192.168.1.1/24\n")); break; case NMC_EDITOR_MAIN_CMD_DESCRIBE: g_print(_("describe [.] :: describe property\n\n" "Shows property description. You can consult nm-settings(5) " "manual page to see all NM settings and properties.\n")); break; case NMC_EDITOR_MAIN_CMD_PRINT: g_print(_("print [all] :: print setting or connection values\n\n" "Shows current property or the whole connection.\n\n" "Example: nmcli ipv4> print all\n")); break; case NMC_EDITOR_MAIN_CMD_VERIFY: g_print( _("verify [all | fix] :: verify setting or connection validity\n\n" "Verifies whether the setting or connection is valid and can be saved later.\n" "It indicates invalid values on error. Some errors may be fixed automatically\n" "by 'fix' option.\n\n" "Examples: nmcli> verify\n" " nmcli> verify fix\n" " nmcli bond> verify\n")); break; case NMC_EDITOR_MAIN_CMD_SAVE: g_print( _("save [persistent|temporary] :: save the connection\n\n" "Sends the connection profile to NetworkManager that either will save it\n" "persistently, or will only keep it in memory. 'save' without an argument\n" "means 'save persistent'.\n" "Note that once you save the profile persistently those settings are saved\n" "across reboot or restart. Subsequent changes can also be temporary or\n" "persistent, but any temporary changes will not persist across reboot or\n" "restart. If you want to fully remove the persistent connection, the connection\n" "profile must be deleted.\n")); break; case NMC_EDITOR_MAIN_CMD_ACTIVATE: g_print(_("activate [] [/|] :: activate the connection\n\n" "Activates the connection.\n\n" "Available options:\n" " - device the connection will be activated on\n" "/| - AP (Wi-Fi) or NSP (WiMAX) (prepend with / when is " "not specified)\n")); break; case NMC_EDITOR_MAIN_CMD_BACK: g_print(_("back :: go to upper menu level\n\n")); break; case NMC_EDITOR_MAIN_CMD_HELP: g_print(_("help/? [] :: help for the nmcli commands\n\n")); break; case NMC_EDITOR_MAIN_CMD_NMCLI: g_print(_("nmcli [ ] :: nmcli configuration\n\n" "Configures nmcli. The following options are available:\n" "status-line yes | no [default: no]\n" "save-confirmation yes | no [default: yes]\n" "show-secrets yes | no [default: no]\n" "prompt-color | <0-8> [default: 0]\n" "%s" /* color table description */ "\n" "Examples: nmcli> nmcli status-line yes\n" " nmcli> nmcli save-confirmation no\n" " nmcli> nmcli prompt-color 3\n"), " 0 = normal\n" " 1 = \33[30mblack\33[0m\n" " 2 = \33[31mred\33[0m\n" " 3 = \33[32mgreen\33[0m\n" " 4 = \33[33myellow\33[0m\n" " 5 = \33[34mblue\33[0m\n" " 6 = \33[35mmagenta\33[0m\n" " 7 = \33[36mcyan\33[0m\n" " 8 = \33[37mwhite\33[0m\n"); break; case NMC_EDITOR_MAIN_CMD_QUIT: g_print(_("quit :: exit nmcli\n\n" "This command exits nmcli. When the connection being edited " "is not saved, the user is asked to confirm the action.\n")); break; default: g_print(_("Unknown command: '%s'\n"), command); break; } } } typedef enum { NMC_EDITOR_SUB_CMD_UNKNOWN = 0, NMC_EDITOR_SUB_CMD_SET, NMC_EDITOR_SUB_CMD_ADD, NMC_EDITOR_SUB_CMD_CHANGE, NMC_EDITOR_SUB_CMD_REMOVE, NMC_EDITOR_SUB_CMD_DESCRIBE, NMC_EDITOR_SUB_CMD_PRINT, NMC_EDITOR_SUB_CMD_BACK, NMC_EDITOR_SUB_CMD_HELP, NMC_EDITOR_SUB_CMD_QUIT } NmcEditorSubCmd; static NmcEditorSubCmd parse_editor_sub_cmd(const char *cmd, char **cmd_arg) { NmcEditorSubCmd editor_cmd = NMC_EDITOR_SUB_CMD_UNKNOWN; gs_free char *cmd_arg0 = NULL; const char *cmd_argr; _split_cmd(cmd, &cmd_arg0, &cmd_argr); if (!cmd_arg0) goto fail; if (matches(cmd_arg0, "set")) editor_cmd = NMC_EDITOR_SUB_CMD_SET; else if (matches(cmd_arg0, "add")) editor_cmd = NMC_EDITOR_SUB_CMD_ADD; else if (matches(cmd_arg0, "change")) editor_cmd = NMC_EDITOR_SUB_CMD_CHANGE; else if (matches(cmd_arg0, "remove")) editor_cmd = NMC_EDITOR_SUB_CMD_REMOVE; else if (matches(cmd_arg0, "describe")) editor_cmd = NMC_EDITOR_SUB_CMD_DESCRIBE; else if (matches(cmd_arg0, "print")) editor_cmd = NMC_EDITOR_SUB_CMD_PRINT; else if (matches(cmd_arg0, "back")) editor_cmd = NMC_EDITOR_SUB_CMD_BACK; else if (matches(cmd_arg0, "help") || nm_streq(cmd_arg0, "?")) editor_cmd = NMC_EDITOR_SUB_CMD_HELP; else if (matches(cmd_arg0, "quit")) editor_cmd = NMC_EDITOR_SUB_CMD_QUIT; else goto fail; NM_SET_OUT(cmd_arg, g_strdup(cmd_argr)); return editor_cmd; fail: NM_SET_OUT(cmd_arg, NULL); return NMC_EDITOR_SUB_CMD_UNKNOWN; } static void editor_sub_help(void) { g_print("------------------------------------------------------------------------------\n"); /* TRANSLATORS: do not translate command names and keywords before :: * However, you should translate terms enclosed in <>. */ g_print(_("---[ Property menu ]---\n" "set [] :: set new value\n" "add [] :: add new option to the property\n" "change :: change current value\n" "remove [ |