// SPDX-License-Identifier: LGPL-2.1+ /* * Copyright 2015 Red Hat, Inc. */ #include "nm-default.h" #include "nm-setting-tun.h" #include #include "nm-utils.h" #include "nm-setting-connection.h" #include "nm-setting-private.h" #include "nm-connection-private.h" /** * SECTION:nm-setting-tun * @short_description: Describes connection properties for TUN/TAP interfaces * * The #NMSettingTun object is a #NMSetting subclass that describes properties * necessary for connection to TUN/TAP interfaces. **/ /*****************************************************************************/ NM_GOBJECT_PROPERTIES_DEFINE_BASE ( PROP_MODE, PROP_OWNER, PROP_GROUP, PROP_PI, PROP_VNET_HDR, PROP_MULTI_QUEUE, ); typedef struct { NMSettingTunMode mode; char *owner; char *group; gboolean pi; gboolean vnet_hdr; gboolean multi_queue; } NMSettingTunPrivate; G_DEFINE_TYPE (NMSettingTun, nm_setting_tun, NM_TYPE_SETTING) #define NM_SETTING_TUN_GET_PRIVATE(o) (G_TYPE_INSTANCE_GET_PRIVATE ((o), NM_TYPE_SETTING_TUN, NMSettingTunPrivate)) /*****************************************************************************/ /** * nm_setting_tun_get_mode: * @setting: the #NMSettingTun * * Returns: the #NMSettingTun:mode property of the setting * * Since: 1.2 **/ NMSettingTunMode nm_setting_tun_get_mode (NMSettingTun *setting) { g_return_val_if_fail (NM_IS_SETTING_TUN (setting), NM_SETTING_TUN_MODE_TUN); return NM_SETTING_TUN_GET_PRIVATE (setting)->mode; } /** * nm_setting_tun_get_owner: * @setting: the #NMSettingTun * * Returns: the #NMSettingTun:owner property of the setting * * Since: 1.2 **/ const char * nm_setting_tun_get_owner (NMSettingTun *setting) { g_return_val_if_fail (NM_IS_SETTING_TUN (setting), NULL); return NM_SETTING_TUN_GET_PRIVATE (setting)->owner; } /** * nm_setting_tun_get_group: * @setting: the #NMSettingTun * * Returns: the #NMSettingTun:group property of the setting * * Since: 1.2 **/ const char * nm_setting_tun_get_group (NMSettingTun *setting) { g_return_val_if_fail (NM_IS_SETTING_TUN (setting), NULL); return NM_SETTING_TUN_GET_PRIVATE (setting)->group; } /** * nm_setting_tun_get_pi: * @setting: the #NMSettingTun * * Returns: the #NMSettingTun:pi property of the setting * * Since: 1.2 **/ gboolean nm_setting_tun_get_pi (NMSettingTun *setting) { g_return_val_if_fail (NM_IS_SETTING_TUN (setting), FALSE); return NM_SETTING_TUN_GET_PRIVATE (setting)->pi; } /** * nm_setting_tun_get_vnet_hdr: * @setting: the #NMSettingTun * * Returns: the #NMSettingTun:vnet_hdr property of the setting * * Since: 1.2 **/ gboolean nm_setting_tun_get_vnet_hdr (NMSettingTun *setting) { g_return_val_if_fail (NM_IS_SETTING_TUN (setting), FALSE); return NM_SETTING_TUN_GET_PRIVATE (setting)->vnet_hdr; } /** * nm_setting_tun_get_multi_queue: * @setting: the #NMSettingTun * * Returns: the #NMSettingTun:multi-queue property of the setting * * Since: 1.2 **/ gboolean nm_setting_tun_get_multi_queue (NMSettingTun *setting) { g_return_val_if_fail (NM_IS_SETTING_TUN (setting), FALSE); return NM_SETTING_TUN_GET_PRIVATE (setting)->multi_queue; } static gboolean verify (NMSetting *setting, NMConnection *connection, GError **error) { NMSettingTunPrivate *priv = NM_SETTING_TUN_GET_PRIVATE (setting); if (!NM_IN_SET (priv->mode, NM_SETTING_TUN_MODE_TUN, NM_SETTING_TUN_MODE_TAP)) { g_set_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY, _("'%u': invalid mode"), (unsigned) priv->mode); g_prefix_error (error, "%s.%s: ", NM_SETTING_TUN_SETTING_NAME, NM_SETTING_TUN_MODE); return FALSE; } if (priv->owner) { if (_nm_utils_ascii_str_to_int64 (priv->owner, 10, 0, G_MAXINT32, -1) == -1) { g_set_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY, _("'%s': invalid user ID"), priv->owner); g_prefix_error (error, "%s.%s: ", NM_SETTING_TUN_SETTING_NAME, NM_SETTING_TUN_OWNER); return FALSE; } } if (priv->group) { if (_nm_utils_ascii_str_to_int64 (priv->group, 10, 0, G_MAXINT32, -1) == -1) { g_set_error (error, NM_CONNECTION_ERROR, NM_CONNECTION_ERROR_INVALID_PROPERTY, _("'%s': invalid group ID"), priv->group); g_prefix_error (error, "%s.%s: ", NM_SETTING_TUN_SETTING_NAME, NM_SETTING_TUN_GROUP); return FALSE; } } return TRUE; } /*****************************************************************************/ static void get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { NMSettingTun *setting = NM_SETTING_TUN (object); NMSettingTunPrivate *priv = NM_SETTING_TUN_GET_PRIVATE (setting); switch (prop_id) { case PROP_MODE: g_value_set_uint (value, priv->mode); break; case PROP_OWNER: g_value_set_string (value, priv->owner); break; case PROP_GROUP: g_value_set_string (value, priv->group); break; case PROP_PI: g_value_set_boolean (value, priv->pi); break; case PROP_VNET_HDR: g_value_set_boolean (value, priv->vnet_hdr); break; case PROP_MULTI_QUEUE: g_value_set_boolean (value, priv->multi_queue); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { NMSettingTun *setting = NM_SETTING_TUN (object); NMSettingTunPrivate *priv = NM_SETTING_TUN_GET_PRIVATE (setting); switch (prop_id) { case PROP_MODE: priv->mode = g_value_get_uint (value); break; case PROP_OWNER: g_free (priv->owner); priv->owner = g_value_dup_string (value); break; case PROP_GROUP: g_free (priv->group); priv->group = g_value_dup_string (value); break; case PROP_PI: priv->pi = g_value_get_boolean (value); break; case PROP_VNET_HDR: priv->vnet_hdr = g_value_get_boolean (value); break; case PROP_MULTI_QUEUE: priv->multi_queue = g_value_get_boolean (value); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } /*****************************************************************************/ static void nm_setting_tun_init (NMSettingTun *setting) { } /** * nm_setting_tun_new: * * Creates a new #NMSettingTun object with default values. * * Returns: (transfer full): the new empty #NMSettingTun object * * Since: 1.2 **/ NMSetting * nm_setting_tun_new (void) { return (NMSetting *) g_object_new (NM_TYPE_SETTING_TUN, NULL); } static void finalize (GObject *object) { NMSettingTun *setting = NM_SETTING_TUN (object); NMSettingTunPrivate *priv = NM_SETTING_TUN_GET_PRIVATE (setting); g_free (priv->owner); g_free (priv->group); G_OBJECT_CLASS (nm_setting_tun_parent_class)->finalize (object); } static void nm_setting_tun_class_init (NMSettingTunClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); NMSettingClass *setting_class = NM_SETTING_CLASS (klass); g_type_class_add_private (klass, sizeof (NMSettingTunPrivate)); object_class->get_property = get_property; object_class->set_property = set_property; object_class->finalize = finalize; setting_class->verify = verify; /** * NMSettingTun:mode: * * The operating mode of the virtual device. Allowed values are * %NM_SETTING_TUN_MODE_TUN to create a layer 3 device and * %NM_SETTING_TUN_MODE_TAP to create an Ethernet-like layer 2 * one. * * Since: 1.2 */ obj_properties[PROP_MODE] = g_param_spec_uint (NM_SETTING_TUN_MODE, "", "", 0, G_MAXUINT, NM_SETTING_TUN_MODE_TUN, G_PARAM_READWRITE | G_PARAM_CONSTRUCT | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); /** * NMSettingTun:owner: * * The user ID which will own the device. If set to %NULL everyone * will be able to use the device. * * Since: 1.2 */ obj_properties[PROP_OWNER] = g_param_spec_string (NM_SETTING_TUN_OWNER, "", "", NULL, G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); /** * NMSettingTun:group: * * The group ID which will own the device. If set to %NULL everyone * will be able to use the device. * * Since: 1.2 */ obj_properties[PROP_GROUP] = g_param_spec_string (NM_SETTING_TUN_GROUP, "", "", NULL, G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); /** * NMSettingTun:pi: * * If %TRUE the interface will prepend a 4 byte header describing the * physical interface to the packets. * * Since: 1.2 */ obj_properties[PROP_PI] = g_param_spec_boolean (NM_SETTING_TUN_PI, "", "", FALSE, G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); /** * NMSettingTun:vnet-hdr: * * If %TRUE the IFF_VNET_HDR the tunnel packets will include a virtio * network header. * * Since: 1.2 */ obj_properties[PROP_VNET_HDR] = g_param_spec_boolean (NM_SETTING_TUN_VNET_HDR, "", "", FALSE, G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); /** * NMSettingTun:multi-queue: * * If the property is set to %TRUE, the interface will support * multiple file descriptors (queues) to parallelize packet * sending or receiving. Otherwise, the interface will only * support a single queue. * * Since: 1.2 */ obj_properties[PROP_MULTI_QUEUE] = g_param_spec_boolean (NM_SETTING_TUN_MULTI_QUEUE, "", "", FALSE, G_PARAM_READWRITE | NM_SETTING_PARAM_INFERRABLE | G_PARAM_STATIC_STRINGS); g_object_class_install_properties (object_class, _PROPERTY_ENUMS_LAST, obj_properties); _nm_setting_class_commit (setting_class, NM_META_SETTING_TYPE_TUN); }