fdo-mirrors/NetworkManager
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/NetworkManager/NetworkManager.git synced 2025-12-30 13:10:11 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
NetworkManager/src/libnm-core-impl/nm-setting-dcb.c
Thomas Haller bd8d49495b
libnm: embed private structure in NMSetting and avoid g_type_class_add_private() 
Historically, the NMSetting types were in public headers. Theoretically,
that allowed users to subtype our classes. However in practice that was
impossible because they lacked required access to internal functions to
fully create an NMSetting class outside of libnm. And it also was not
useful, because you simply cannot extend libnm by subtyping a libnm
class. And supporting such a use case would be hard and limit what we can
do in libnm.

Having GObject structs in public headers also require that we don't
change it's layout. The ABI of those structs must not change, if anybody
out there was actually subclassing our GObjects.

In libnm 1.34 (commit e46d484fae ('libnm: hide NMSetting types from
public headers')) we moved the structs from headers to internal.
This would have caused a compiler error if anybody was using those
struct definitions. However, we still didn't change the ABI/layout so
that we didn't break users who relied on it (for whatever reason).

It doesn't seem there were any affected user. We waited long enough.
Change internal ABI.

No longer use g_type_class_add_private(). Instead, embed the private
structs directly (_NM_GET_PRIVATE()) or indirectly
(_NM_GET_PRIVATE_PTR()) in the object.

The main benefit is for debugging in the debugger, where we can now
easily find the private data. Previously that was so cumbersome to be
effectively impossible.

It's also the fastest possible way, since NM_SETTING_*_GET_PRIVATE()
literally resolves to "&self->_priv" (plus static asserts and
nm_assert() for type checking).

_NM_GET_PRIVATE() also propagates constness and requires that the
argument is a compatible pointer type (at compile time).

Note that g_type_class_add_private() is also deprecated in glib 2.58 and
replaced by G_ADD_PRIVATE(). For one, we still don't rely on 2.58. Also,
G_ADD_PRIVATE() is a worse solution as it supports a usecase that we
don't care for (public structs in headers). _NM_GET_PRIVATE() is still
faster, works with older glib and most importantly: is better for
debugging as you can find the private data from an object pointer.

For NMSettingIPConfig this is rather awkward, because all direct
properties require a common "klass->private_offset". This was however
the case before this change. Nothing new here. And if you ever touch
this and do something wrong, many unit tests will fail. It's almost
impossible to get wrong, albeit it can be confusing to understand.

https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/merge_requests/1773
2023-10-31 11:29:37 +01:00

1229 lines
44 KiB
C
Raw Blame History

/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
* Copyright (C) 2013 Red Hat, Inc.
*/
#include "libnm-core-impl/nm-default-libnm-core.h"
#include "nm-setting-dcb.h"
#include "nm-utils.h"
#include "nm-utils-private.h"
#include "nm-setting-private.h"
#include "nm-core-enum-types.h"
/**
* SECTION:nm-setting-dcb
* @short_description: Connection properties for Data Center Bridging
*
* The #NMSettingDcb object is a #NMSetting subclass that describes properties
* for enabling and using Data Center Bridging (DCB) on Ethernet networks.
* DCB is a set of protocols (including 802.1Qbb, 802.1Qaz, 802.1Qau, and
* 802.1AB) to eliminate packet loss in Ethernet networks and support the use
* of storage technologies like Fibre Channel over Ethernet (FCoE) and iSCSI.
**/
/*****************************************************************************/
NM_GOBJECT_PROPERTIES_DEFINE(NMSettingDcb,
PROP_APP_FCOE_FLAGS,
PROP_APP_FCOE_PRIORITY,
PROP_APP_FCOE_MODE,
PROP_APP_ISCSI_FLAGS,
PROP_APP_ISCSI_PRIORITY,
PROP_APP_FIP_FLAGS,
PROP_APP_FIP_PRIORITY,
PROP_PFC_FLAGS,
PROP_PRIORITY_FLOW_CONTROL,
PROP_PRIORITY_GROUP_FLAGS,
PROP_PRIORITY_GROUP_ID,
PROP_PRIORITY_GROUP_BANDWIDTH,
PROP_PRIORITY_BANDWIDTH,
PROP_PRIORITY_STRICT_BANDWIDTH,
PROP_PRIORITY_TRAFFIC_CLASS, );
typedef struct {
char *app_fcoe_mode;
guint pfc[8];
guint priority_group_id[8];
guint priority_group_bandwidth[8];
guint priority_bandwidth[8];
guint priority_strict[8];
guint priority_traffic_class[8];
guint app_fcoe_flags;
guint app_iscsi_flags;
guint app_fip_flags;
guint pfc_flags;
guint priority_group_flags;
gint32 app_fcoe_priority;
gint32 app_iscsi_priority;
gint32 app_fip_priority;
} NMSettingDcbPrivate;
/**
* NMSettingDcb:
*
* Data Center Bridging Settings
*/
struct _NMSettingDcb {
NMSetting parent;
NMSettingDcbPrivate _priv;
};
struct _NMSettingDcbClass {
NMSettingClass parent;
};
G_DEFINE_TYPE(NMSettingDcb, nm_setting_dcb, NM_TYPE_SETTING)
#define NM_SETTING_DCB_GET_PRIVATE(o) _NM_GET_PRIVATE(o, NMSettingDcb, NM_IS_SETTING_DCB, NMSetting)
/*****************************************************************************/
/**
* nm_setting_dcb_get_app_fcoe_flags:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:app-fcoe-flags property of the setting
**/
NMSettingDcbFlags
nm_setting_dcb_get_app_fcoe_flags(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->app_fcoe_flags;
}
/**
* nm_setting_dcb_get_app_fcoe_priority:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:app-fcoe-priority property of the setting
**/
int
nm_setting_dcb_get_app_fcoe_priority(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->app_fcoe_priority;
}
/**
* nm_setting_dcb_get_app_fcoe_mode:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:app-fcoe-mode property of the setting
**/
const char *
nm_setting_dcb_get_app_fcoe_mode(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), NULL);
return NM_SETTING_DCB_GET_PRIVATE(setting)->app_fcoe_mode;
}
/**
* nm_setting_dcb_get_app_iscsi_flags:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:app-iscsi-flags property of the setting
**/
NMSettingDcbFlags
nm_setting_dcb_get_app_iscsi_flags(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->app_iscsi_flags;
}
/**
* nm_setting_dcb_get_app_iscsi_priority:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:app-iscsi-priority property of the setting
**/
int
nm_setting_dcb_get_app_iscsi_priority(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->app_iscsi_priority;
}
/**
* nm_setting_dcb_get_app_fip_flags:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:app-fip-flags property of the setting
**/
NMSettingDcbFlags
nm_setting_dcb_get_app_fip_flags(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->app_fip_flags;
}
/**
* nm_setting_dcb_get_app_fip_priority:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:app-fip-priority property of the setting
**/
int
nm_setting_dcb_get_app_fip_priority(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->app_fip_priority;
}
/**
* nm_setting_dcb_get_priority_flow_control_flags:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:priority-flow-control-flags property of the setting
**/
NMSettingDcbFlags
nm_setting_dcb_get_priority_flow_control_flags(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->pfc_flags;
}
/**
* nm_setting_dcb_get_priority_flow_control:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to retrieve flow control for
*
* Returns: %TRUE if flow control is enabled for the given @user_priority,
* %FALSE if not enabled
**/
gboolean
nm_setting_dcb_get_priority_flow_control(NMSettingDcb *setting, guint user_priority)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), FALSE);
g_return_val_if_fail(user_priority <= 7, FALSE);
return !!NM_SETTING_DCB_GET_PRIVATE(setting)->pfc[user_priority];
}
/**
* nm_setting_dcb_set_priority_flow_control:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to set flow control for
* @enabled: %TRUE to enable flow control for this priority, %FALSE to disable it
*
* These values are only valid when #NMSettingDcb:priority-flow-control includes
* the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
void
nm_setting_dcb_set_priority_flow_control(NMSettingDcb *setting,
guint user_priority,
gboolean enabled)
{
NMSettingDcbPrivate *priv;
guint uint_enabled = enabled ? 1 : 0;
g_return_if_fail(NM_IS_SETTING_DCB(setting));
g_return_if_fail(user_priority <= 7);
priv = NM_SETTING_DCB_GET_PRIVATE(setting);
if (priv->pfc[user_priority] != uint_enabled) {
priv->pfc[user_priority] = uint_enabled;
_notify(setting, PROP_PRIORITY_FLOW_CONTROL);
}
}
/**
* nm_setting_dcb_get_priority_group_flags:
* @setting: the #NMSettingDcb
*
* Returns: the #NMSettingDcb:priority-group-flags property of the setting
**/
NMSettingDcbFlags
nm_setting_dcb_get_priority_group_flags(NMSettingDcb *setting)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->priority_group_flags;
}
/**
* nm_setting_dcb_get_priority_group_id:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to retrieve the group ID for
*
* Returns: the group number @user_priority is assigned to. These values are
* only valid when #NMSettingDcb:priority-group-flags includes the
* %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
guint
nm_setting_dcb_get_priority_group_id(NMSettingDcb *setting, guint user_priority)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
g_return_val_if_fail(user_priority <= 7, 0);
return NM_SETTING_DCB_GET_PRIVATE(setting)->priority_group_id[user_priority];
}
/**
* nm_setting_dcb_set_priority_group_id:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to set flow control for
* @group_id: the group (0 - 7) to assign @user_priority to, or 15 for the
* unrestricted group.
*
* These values are only valid when #NMSettingDcb:priority-group-flags includes
* the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
void
nm_setting_dcb_set_priority_group_id(NMSettingDcb *setting, guint user_priority, guint group_id)
{
NMSettingDcbPrivate *priv;
g_return_if_fail(NM_IS_SETTING_DCB(setting));
g_return_if_fail(user_priority <= 7);
g_return_if_fail(group_id <= 7 || group_id == 15);
priv = NM_SETTING_DCB_GET_PRIVATE(setting);
if (priv->priority_group_id[user_priority] != group_id) {
priv->priority_group_id[user_priority] = group_id;
_notify(setting, PROP_PRIORITY_GROUP_ID);
}
}
/**
* nm_setting_dcb_get_priority_group_bandwidth:
* @setting: the #NMSettingDcb
* @group_id: the priority group (0 - 7) to retrieve the bandwidth percentage for
*
* Returns: the bandwidth percentage assigned to @group_id. These values are
* only valid when #NMSettingDcb:priority-group-flags includes the
* %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
guint
nm_setting_dcb_get_priority_group_bandwidth(NMSettingDcb *setting, guint group_id)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
g_return_val_if_fail(group_id <= 7, FALSE);
return NM_SETTING_DCB_GET_PRIVATE(setting)->priority_group_bandwidth[group_id];
}
/**
* nm_setting_dcb_set_priority_group_bandwidth:
* @setting: the #NMSettingDcb
* @group_id: the priority group (0 - 7) to set the bandwidth percentage for
* @bandwidth_percent: the bandwidth percentage (0 - 100) to assign to @group_id to
*
* These values are only valid when #NMSettingDcb:priority-group-flags includes
* the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
void
nm_setting_dcb_set_priority_group_bandwidth(NMSettingDcb *setting,
guint group_id,
guint bandwidth_percent)
{
NMSettingDcbPrivate *priv;
g_return_if_fail(NM_IS_SETTING_DCB(setting));
g_return_if_fail(group_id <= 7);
g_return_if_fail(bandwidth_percent <= 100);
priv = NM_SETTING_DCB_GET_PRIVATE(setting);
if (priv->priority_group_bandwidth[group_id] != bandwidth_percent) {
priv->priority_group_bandwidth[group_id] = bandwidth_percent;
_notify(setting, PROP_PRIORITY_GROUP_BANDWIDTH);
}
}
/**
* nm_setting_dcb_get_priority_bandwidth:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to retrieve the group bandwidth percentage for
*
* Returns: the allowed bandwidth percentage of @user_priority in its priority group.
* These values are only valid when #NMSettingDcb:priority-group-flags includes the
* %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
guint
nm_setting_dcb_get_priority_bandwidth(NMSettingDcb *setting, guint user_priority)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
g_return_val_if_fail(user_priority <= 7, FALSE);
return NM_SETTING_DCB_GET_PRIVATE(setting)->priority_bandwidth[user_priority];
}
/**
* nm_setting_dcb_set_priority_bandwidth:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to set the bandwidth percentage for
* @bandwidth_percent: the bandwidth percentage (0 - 100) that @user_priority is
* allowed to use within its priority group
*
* These values are only valid when #NMSettingDcb:priority-group-flags includes
* the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
void
nm_setting_dcb_set_priority_bandwidth(NMSettingDcb *setting,
guint user_priority,
guint bandwidth_percent)
{
NMSettingDcbPrivate *priv;
g_return_if_fail(NM_IS_SETTING_DCB(setting));
g_return_if_fail(user_priority <= 7);
g_return_if_fail(bandwidth_percent <= 100);
priv = NM_SETTING_DCB_GET_PRIVATE(setting);
if (priv->priority_bandwidth[user_priority] != bandwidth_percent) {
priv->priority_bandwidth[user_priority] = bandwidth_percent;
_notify(setting, PROP_PRIORITY_BANDWIDTH);
}
}
/**
* nm_setting_dcb_get_priority_strict_bandwidth:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to retrieve strict bandwidth for
*
* Returns: %TRUE if @user_priority may use all of the bandwidth allocated to its
* assigned group, or %FALSE if not. These values are only valid when
* #NMSettingDcb:priority-group-flags includes the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
gboolean
nm_setting_dcb_get_priority_strict_bandwidth(NMSettingDcb *setting, guint user_priority)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
g_return_val_if_fail(user_priority <= 7, FALSE);
return !!NM_SETTING_DCB_GET_PRIVATE(setting)->priority_strict[user_priority];
}
/**
* nm_setting_dcb_set_priority_strict_bandwidth:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to set strict bandwidth for
* @strict: %TRUE to allow @user_priority to use all the bandwidth allocated to
* its priority group, or %FALSE if not
*
* These values are only valid when #NMSettingDcb:priority-group-flags includes
* the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
void
nm_setting_dcb_set_priority_strict_bandwidth(NMSettingDcb *setting,
guint user_priority,
gboolean strict)
{
NMSettingDcbPrivate *priv;
guint uint_strict = strict ? 1 : 0;
g_return_if_fail(NM_IS_SETTING_DCB(setting));
g_return_if_fail(user_priority <= 7);
priv = NM_SETTING_DCB_GET_PRIVATE(setting);
if (priv->priority_strict[user_priority] != uint_strict) {
priv->priority_strict[user_priority] = uint_strict;
_notify(setting, PROP_PRIORITY_STRICT_BANDWIDTH);
}
}
/**
* nm_setting_dcb_get_priority_traffic_class:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to retrieve the traffic class for
*
* Returns: the traffic class assigned to @user_priority. These values are only
* valid when #NMSettingDcb:priority-group-flags includes the
* %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
guint
nm_setting_dcb_get_priority_traffic_class(NMSettingDcb *setting, guint user_priority)
{
g_return_val_if_fail(NM_IS_SETTING_DCB(setting), 0);
g_return_val_if_fail(user_priority <= 7, FALSE);
return NM_SETTING_DCB_GET_PRIVATE(setting)->priority_traffic_class[user_priority];
}
/**
* nm_setting_dcb_set_priority_traffic_clas:
* @setting: the #NMSettingDcb
* @user_priority: the User Priority (0 - 7) to set the bandwidth percentage for
* @traffic_class: the traffic_class (0 - 7) that @user_priority should map to
*
* These values are only valid when #NMSettingDcb:priority-group-flags includes
* the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
void
nm_setting_dcb_set_priority_traffic_class(NMSettingDcb *setting,
guint user_priority,
guint traffic_class)
{
NMSettingDcbPrivate *priv;
g_return_if_fail(NM_IS_SETTING_DCB(setting));
g_return_if_fail(user_priority <= 7);
g_return_if_fail(traffic_class <= 7);
priv = NM_SETTING_DCB_GET_PRIVATE(setting);
if (priv->priority_traffic_class[user_priority] != traffic_class) {
priv->priority_traffic_class[user_priority] = traffic_class;
_notify(setting, PROP_PRIORITY_TRAFFIC_CLASS);
}
}
/*****************************************************************************/
#define DCB_FLAGS_ALL \
(NM_SETTING_DCB_FLAG_ENABLE | NM_SETTING_DCB_FLAG_ADVERTISE | NM_SETTING_DCB_FLAG_WILLING)
static gboolean
check_dcb_flags(NMSettingDcbFlags flags, const char *prop_name, GError **error)
{
if (flags & ~DCB_FLAGS_ALL) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("flags invalid"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, prop_name);
return FALSE;
}
if (!(flags & NM_SETTING_DCB_FLAG_ENABLE) && (flags & ~NM_SETTING_DCB_FLAG_ENABLE)) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("flags invalid - disabled"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, prop_name);
return FALSE;
}
return TRUE;
}
static gboolean
check_uint_array(const guint *array,
guint len,
NMSettingDcbFlags flags,
guint max,
guint extra,
gboolean sum_pct,
const char *prop_name,
GError **error)
{
guint i, sum = 0;
/* Ensure each element is <= to max or equals extra */
for (i = 0; i < len; i++) {
if (!(flags & NM_SETTING_DCB_FLAG_ENABLE) && array[i]) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("property invalid (not enabled)"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, prop_name);
return FALSE;
}
if ((array[i] > max) && (array[i] != extra)) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("element invalid"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, prop_name);
return FALSE;
}
sum += array[i];
}
/* Verify sum of percentages */
if (sum_pct) {
if (flags & NM_SETTING_DCB_FLAG_ENABLE) {
/* If the feature is enabled, sum must equal 100% */
if (sum != 100) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("sum not 100%"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, prop_name);
return FALSE;
}
} else {
/* If the feature is disabled, sum must equal 0%, which was checked
* by the for() loop above.
*/
g_assert_cmpint(sum, ==, 0);
}
}
return TRUE;
}
static gboolean
check_priority(int val, NMSettingDcbFlags flags, const char *prop_name, GError **error)
{
if (!(flags & NM_SETTING_DCB_FLAG_ENABLE) && (val >= 0)) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("property invalid (not enabled)"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, prop_name);
return FALSE;
}
if (val < -1 || val > 7) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("property invalid"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, prop_name);
return FALSE;
}
return TRUE;
}
static gboolean
verify(NMSetting *setting, NMConnection *connection, GError **error)
{
NMSettingDcbPrivate *priv = NM_SETTING_DCB_GET_PRIVATE(setting);
if (!check_dcb_flags(priv->app_fcoe_flags, NM_SETTING_DCB_APP_FCOE_FLAGS, error))
return FALSE;
if (!check_priority(priv->app_fcoe_priority,
priv->app_fcoe_flags,
NM_SETTING_DCB_APP_FCOE_PRIORITY,
error))
return FALSE;
if (!NM_IN_STRSET(priv->app_fcoe_mode,
NULL,
NM_SETTING_DCB_FCOE_MODE_FABRIC,
NM_SETTING_DCB_FCOE_MODE_VN2VN)) {
g_set_error_literal(error,
NM_CONNECTION_ERROR,
NM_CONNECTION_ERROR_INVALID_PROPERTY,
_("property invalid"));
g_prefix_error(error, "%s.%s: ", NM_SETTING_DCB_SETTING_NAME, NM_SETTING_DCB_APP_FCOE_MODE);
return FALSE;
}
if (!check_dcb_flags(priv->app_iscsi_flags, NM_SETTING_DCB_APP_ISCSI_FLAGS, error))
return FALSE;
if (!check_priority(priv->app_iscsi_priority,
priv->app_iscsi_flags,
NM_SETTING_DCB_APP_ISCSI_PRIORITY,
error))
return FALSE;
if (!check_dcb_flags(priv->app_fip_flags, NM_SETTING_DCB_APP_FIP_FLAGS, error))
return FALSE;
if (!check_priority(priv->app_fip_priority,
priv->app_fip_flags,
NM_SETTING_DCB_APP_FIP_PRIORITY,
error))
return FALSE;
if (!check_dcb_flags(priv->pfc_flags, NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS, error))
return FALSE;
if (!check_uint_array(priv->pfc,
G_N_ELEMENTS(priv->pfc),
priv->pfc_flags,
1,
0,
FALSE,
NM_SETTING_DCB_PRIORITY_FLOW_CONTROL,
error))
return FALSE;
if (!check_dcb_flags(priv->priority_group_flags, NM_SETTING_DCB_PRIORITY_GROUP_FLAGS, error))
return FALSE;
if (!check_uint_array(priv->priority_group_id,
G_N_ELEMENTS(priv->priority_group_id),
priv->priority_group_flags,
7,
15,
FALSE,
NM_SETTING_DCB_PRIORITY_GROUP_ID,
error))
return FALSE;
if (!check_uint_array(priv->priority_group_bandwidth,
G_N_ELEMENTS(priv->priority_group_bandwidth),
priv->priority_group_flags,
100,
0,
TRUE,
NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH,
error))
return FALSE;
/* FIXME: sum bandwidths in each group */
if (!check_uint_array(priv->priority_bandwidth,
G_N_ELEMENTS(priv->priority_bandwidth),
priv->priority_group_flags,
100,
0,
FALSE,
NM_SETTING_DCB_PRIORITY_BANDWIDTH,
error))
return FALSE;
if (!check_uint_array(priv->priority_strict,
G_N_ELEMENTS(priv->priority_strict),
priv->priority_group_flags,
1,
0,
FALSE,
NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH,
error))
return FALSE;
if (!check_uint_array(priv->priority_traffic_class,
G_N_ELEMENTS(priv->priority_traffic_class),
priv->priority_group_flags,
7,
0,
FALSE,
NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS,
error))
return FALSE;
return TRUE;
}
/*****************************************************************************/
G_STATIC_ASSERT(sizeof(guint) == sizeof(gboolean));
static void
set_array_from_gvalue(const GValue *v, uint *a, size_t len)
{
GArray *src = g_value_get_boxed(v);
const guint total_len = len * sizeof(a[0]);
memset(a, 0, total_len);
if (src) {
g_return_if_fail(g_array_get_element_size(src) == sizeof(a[0]));
g_return_if_fail(src->len == len);
memcpy(a, src->data, total_len);
}
}
#define SET_ARRAY_FROM_GVALUE(v, a) set_array_from_gvalue(v, a, G_N_ELEMENTS(a))
static void
set_gvalue_from_array(GValue *v, uint *a, size_t len)
{
GArray *src = g_array_sized_new(FALSE, TRUE, sizeof(guint), len);
g_array_append_vals(src, a, len);
g_value_take_boxed(v, src);
}
#define SET_GVALUE_FROM_ARRAY(v, a) set_gvalue_from_array(v, a, G_N_ELEMENTS(a))
static void
_nm_setting_dcb_uint_array_from_dbus(_NM_SETT_INFO_PROP_FROM_DBUS_GPROP_FCN_ARGS _nm_nil)
{
gconstpointer array;
gsize length;
array = g_variant_get_fixed_array(from, &length, sizeof(guint32));
set_gvalue_from_array(to, (guint *) array, length);
}
static const NMSettInfoPropertType nm_sett_info_propert_type_dcb_au =
NM_SETT_INFO_PROPERT_TYPE_GPROP_INIT(
NM_G_VARIANT_TYPE("au"),
.typdata_to_dbus.gprop_type = NM_SETTING_PROPERTY_TO_DBUS_FCN_GPROP_TYPE_GARRAY_UINT,
.typdata_from_dbus.gprop_fcn = _nm_setting_dcb_uint_array_from_dbus,
.compare_fcn = _nm_setting_property_compare_fcn_default,
.from_dbus_fcn = _nm_setting_property_from_dbus_fcn_gprop,
.from_dbus_is_full = TRUE);
/*****************************************************************************/
static void
get_property(GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
{
NMSettingDcb *setting = NM_SETTING_DCB(object);
NMSettingDcbPrivate *priv = NM_SETTING_DCB_GET_PRIVATE(setting);
switch (prop_id) {
case PROP_PRIORITY_FLOW_CONTROL:
SET_GVALUE_FROM_ARRAY(value, priv->pfc);
break;
case PROP_PRIORITY_GROUP_ID:
SET_GVALUE_FROM_ARRAY(value, priv->priority_group_id);
break;
case PROP_PRIORITY_GROUP_BANDWIDTH:
SET_GVALUE_FROM_ARRAY(value, priv->priority_group_bandwidth);
break;
case PROP_PRIORITY_BANDWIDTH:
SET_GVALUE_FROM_ARRAY(value, priv->priority_bandwidth);
break;
case PROP_PRIORITY_STRICT_BANDWIDTH:
SET_GVALUE_FROM_ARRAY(value, priv->priority_strict);
break;
case PROP_PRIORITY_TRAFFIC_CLASS:
SET_GVALUE_FROM_ARRAY(value, priv->priority_traffic_class);
break;
default:
_nm_setting_property_get_property_direct(object, prop_id, value, pspec);
break;
}
}
static void
set_property(GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
{
NMSettingDcbPrivate *priv = NM_SETTING_DCB_GET_PRIVATE(object);
switch (prop_id) {
case PROP_PRIORITY_FLOW_CONTROL:
SET_ARRAY_FROM_GVALUE(value, priv->pfc);
break;
case PROP_PRIORITY_GROUP_ID:
SET_ARRAY_FROM_GVALUE(value, priv->priority_group_id);
break;
case PROP_PRIORITY_GROUP_BANDWIDTH:
SET_ARRAY_FROM_GVALUE(value, priv->priority_group_bandwidth);
break;
case PROP_PRIORITY_BANDWIDTH:
SET_ARRAY_FROM_GVALUE(value, priv->priority_bandwidth);
break;
case PROP_PRIORITY_STRICT_BANDWIDTH:
SET_ARRAY_FROM_GVALUE(value, priv->priority_strict);
break;
case PROP_PRIORITY_TRAFFIC_CLASS:
SET_ARRAY_FROM_GVALUE(value, priv->priority_traffic_class);
break;
default:
_nm_setting_property_set_property_direct(object, prop_id, value, pspec);
break;
}
}
/*****************************************************************************/
static void
nm_setting_dcb_init(NMSettingDcb *self)
{}
/**
* nm_setting_dcb_new:
*
* Creates a new #NMSettingDcb object with default values.
*
* Returns: (transfer full): the new empty #NMSettingDcb object
**/
NMSetting *
nm_setting_dcb_new(void)
{
return g_object_new(NM_TYPE_SETTING_DCB, NULL);
}
static void
nm_setting_dcb_class_init(NMSettingDcbClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS(klass);
NMSettingClass *setting_class = NM_SETTING_CLASS(klass);
GArray *properties_override = _nm_sett_info_property_override_create_array();
object_class->get_property = get_property;
object_class->set_property = set_property;
setting_class->verify = verify;
/**
* NMSettingDcb:app-fcoe-flags:
*
* Specifies the #NMSettingDcbFlags for the DCB FCoE application. Flags may
* be any combination of %NM_SETTING_DCB_FLAG_ENABLE,
* %NM_SETTING_DCB_FLAG_ADVERTISE, and %NM_SETTING_DCB_FLAG_WILLING.
**/
/* ---ifcfg-rh---
* property: app-fcoe-flags
* variable: DCB_APP_FCOE_ENABLE, DCB_APP_FCOE_ADVERTISE, DCB_APP_FCOE_WILLING
* description: FCOE flags.
* default: no
* example: DCB_APP_FCOE_ENABLE=yes DCB_APP_FCOE_ADVERTISE=yes
* ---end---
*/
_nm_setting_property_define_direct_flags(properties_override,
obj_properties,
NM_SETTING_DCB_APP_FCOE_FLAGS,
PROP_APP_FCOE_FLAGS,
NM_TYPE_SETTING_DCB_FLAGS,
NM_SETTING_DCB_FLAG_NONE,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
app_fcoe_flags);
/**
* NMSettingDcb:app-fcoe-priority:
*
* The highest User Priority (0 - 7) which FCoE frames should use, or -1 for
* default priority. Only used when the #NMSettingDcb:app-fcoe-flags
* property includes the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
/* ---ifcfg-rh---
* property: app-fcoe-priority
* variable: DCB_APP_FCOE_PRIORITY
* values: 0 - 7
* description: Priority of FCoE frames.
* ---end---
*/
_nm_setting_property_define_direct_int32(properties_override,
obj_properties,
NM_SETTING_DCB_APP_FCOE_PRIORITY,
PROP_APP_FCOE_PRIORITY,
-1,
7,
-1,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
app_fcoe_priority);
/**
* NMSettingDcb:app-fcoe-mode:
*
* The FCoE controller mode; either %NM_SETTING_DCB_FCOE_MODE_FABRIC
* or %NM_SETTING_DCB_FCOE_MODE_VN2VN.
*
* Since 1.34, %NULL is the default and means %NM_SETTING_DCB_FCOE_MODE_FABRIC.
* Before 1.34, %NULL was rejected as invalid and the default was %NM_SETTING_DCB_FCOE_MODE_FABRIC.
**/
/* ---ifcfg-rh---
* property: app-fcoe-mode
* variable: DCB_APP_FCOE_MODE
* values: fabric, vn2vn
* default: fabric
* description: FCoE controller mode.
* ---end---
*/
_nm_setting_property_define_direct_string(properties_override,
obj_properties,
NM_SETTING_DCB_APP_FCOE_MODE,
PROP_APP_FCOE_MODE,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
app_fcoe_mode);
/**
* NMSettingDcb:app-iscsi-flags:
*
* Specifies the #NMSettingDcbFlags for the DCB iSCSI application. Flags
* may be any combination of %NM_SETTING_DCB_FLAG_ENABLE,
* %NM_SETTING_DCB_FLAG_ADVERTISE, and %NM_SETTING_DCB_FLAG_WILLING.
**/
/* ---ifcfg-rh---
* property: app-iscsi-flags
* variable: DCB_APP_ISCSI_ENABLE, DCB_APP_ISCSI_ADVERTISE, DCB_APP_ISCSI_WILLING
* default: no
* description: iSCSI flags.
* ---end---
*/
_nm_setting_property_define_direct_flags(properties_override,
obj_properties,
NM_SETTING_DCB_APP_ISCSI_FLAGS,
PROP_APP_ISCSI_FLAGS,
NM_TYPE_SETTING_DCB_FLAGS,
NM_SETTING_DCB_FLAG_NONE,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
app_iscsi_flags);
/**
* NMSettingDcb:app-iscsi-priority:
*
* The highest User Priority (0 - 7) which iSCSI frames should use, or -1
* for default priority. Only used when the #NMSettingDcb:app-iscsi-flags
* property includes the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
/* ---ifcfg-rh---
* property: app-iscsi-priority
* variable: DCB_APP_ISCSI_PRIORITY
* values: 0 - 7
* description: Priority of iSCSI frames.
* ---end---
*/
_nm_setting_property_define_direct_int32(properties_override,
obj_properties,
NM_SETTING_DCB_APP_ISCSI_PRIORITY,
PROP_APP_ISCSI_PRIORITY,
-1,
7,
-1,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
app_iscsi_priority);
/**
* NMSettingDcb:app-fip-flags:
*
* Specifies the #NMSettingDcbFlags for the DCB FIP application. Flags may
* be any combination of %NM_SETTING_DCB_FLAG_ENABLE,
* %NM_SETTING_DCB_FLAG_ADVERTISE, and %NM_SETTING_DCB_FLAG_WILLING.
**/
/* ---ifcfg-rh---
* property: app-fip-flags
* variable: DCB_APP_FIP_ENABLE, DCB_APP_FIP_ADVERTISE, DCB_APP_FIP_WILLING
* default: no
* description: FIP flags.
* ---end---
*/
_nm_setting_property_define_direct_flags(properties_override,
obj_properties,
NM_SETTING_DCB_APP_FIP_FLAGS,
PROP_APP_FIP_FLAGS,
NM_TYPE_SETTING_DCB_FLAGS,
NM_SETTING_DCB_FLAG_NONE,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
app_fip_flags);
/**
* NMSettingDcb:app-fip-priority:
*
* The highest User Priority (0 - 7) which FIP frames should use, or -1 for
* default priority. Only used when the #NMSettingDcb:app-fip-flags
* property includes the %NM_SETTING_DCB_FLAG_ENABLE flag.
**/
/* ---ifcfg-rh---
* property: app-fip-priority
* variable: DCB_APP_FIP_PRIORITY
* values: 0 - 7
* description: Priority of FIP frames.
* ---end---
*/
_nm_setting_property_define_direct_int32(properties_override,
obj_properties,
NM_SETTING_DCB_APP_FIP_PRIORITY,
PROP_APP_FIP_PRIORITY,
-1,
7,
-1,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
app_fip_priority);
/**
* NMSettingDcb:priority-flow-control-flags:
*
* Specifies the #NMSettingDcbFlags for DCB Priority Flow Control (PFC).
* Flags may be any combination of %NM_SETTING_DCB_FLAG_ENABLE,
* %NM_SETTING_DCB_FLAG_ADVERTISE, and %NM_SETTING_DCB_FLAG_WILLING.
**/
/* ---ifcfg-rh---
* property: priority-flow-control-flags
* variable: DCB_PFC_ENABLE, DCB_PFC_ADVERTISE, DCB_PFC_WILLING
* default: no
* description: Priority flow control flags.
* ---end---
*/
_nm_setting_property_define_direct_flags(properties_override,
obj_properties,
NM_SETTING_DCB_PRIORITY_FLOW_CONTROL_FLAGS,
PROP_PFC_FLAGS,
NM_TYPE_SETTING_DCB_FLAGS,
NM_SETTING_DCB_FLAG_NONE,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
pfc_flags);
/**
* NMSettingDcb:priority-flow-control: (type GArray(gboolean))
*
* An array of 8 boolean values, where the array index corresponds to the User
* Priority (0 - 7) and the value indicates whether or not the corresponding
* priority should transmit priority pause.
**/
/* ---ifcfg-rh---
* property: priority-flow-control
* variable: DCB_PFC_UP
* description: Priority flow control values. String of 8 "0" and "1", where "0".
* means "do not transmit priority pause", "1" means "transmit pause".
* example: DCB_PFC_UP=01101110
* ---end---
*/
obj_properties[PROP_PRIORITY_FLOW_CONTROL] =
g_param_spec_boxed(NM_SETTING_DCB_PRIORITY_FLOW_CONTROL,
"",
"",
G_TYPE_ARRAY,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
_nm_properties_override_gobj(properties_override,
obj_properties[PROP_PRIORITY_FLOW_CONTROL],
&nm_sett_info_propert_type_dcb_au);
/**
* NMSettingDcb:priority-group-flags:
*
* Specifies the #NMSettingDcbFlags for DCB Priority Groups. Flags may be
* any combination of %NM_SETTING_DCB_FLAG_ENABLE,
* %NM_SETTING_DCB_FLAG_ADVERTISE, and %NM_SETTING_DCB_FLAG_WILLING.
**/
/* ---ifcfg-rh---
* property: priority-group-flags
* variable: DCB_PG_ENABLE, DCB_PG_ADVERTISE, DCB_PG_WILLING
* default: no
* description: Priority groups flags.
* ---end---
*/
_nm_setting_property_define_direct_flags(properties_override,
obj_properties,
NM_SETTING_DCB_PRIORITY_GROUP_FLAGS,
PROP_PRIORITY_GROUP_FLAGS,
NM_TYPE_SETTING_DCB_FLAGS,
NM_SETTING_DCB_FLAG_NONE,
NM_SETTING_PARAM_NONE,
NMSettingDcbPrivate,
priority_group_flags);
/**
* NMSettingDcb:priority-group-id: (type GArray(guint))
*
* An array of 8 uint values, where the array index corresponds to the User
* Priority (0 - 7) and the value indicates the Priority Group ID. Allowed
* Priority Group ID values are 0 - 7 or 15 for the unrestricted group.
**/
/* ---ifcfg-rh---
* property: priority-group-id
* variable: DCB_PG_ID
* description: Priority groups values. String of eight priorities (0 - 7) or "f"
* (unrestricted).
* example: DCB_PG_ID=1205f173
* ---end---
*/
obj_properties[PROP_PRIORITY_GROUP_ID] =
g_param_spec_boxed(NM_SETTING_DCB_PRIORITY_GROUP_ID,
"",
"",
G_TYPE_ARRAY,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
_nm_properties_override_gobj(properties_override,
obj_properties[PROP_PRIORITY_GROUP_ID],
&nm_sett_info_propert_type_dcb_au);
/**
* NMSettingDcb:priority-group-bandwidth: (type GArray(guint))
*
* An array of 8 uint values, where the array index corresponds to the
* Priority Group ID (0 - 7) and the value indicates the percentage of link
* bandwidth allocated to that group. Allowed values are 0 - 100, and the
* sum of all values must total 100 percents.
**/
/* ---ifcfg-rh---
* property: priority-group-bandwidth
* variable: DCB_PG_PCT
* description: Priority groups values. Eight bandwidths (in percent), separated with commas.
* example: DCB_PG_PCT=10,5,10,15,10,10,10,30
* ---end---
*/
obj_properties[PROP_PRIORITY_GROUP_BANDWIDTH] =
g_param_spec_boxed(NM_SETTING_DCB_PRIORITY_GROUP_BANDWIDTH,
"",
"",
G_TYPE_ARRAY,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
_nm_properties_override_gobj(properties_override,
obj_properties[PROP_PRIORITY_GROUP_BANDWIDTH],
&nm_sett_info_propert_type_dcb_au);
/**
* NMSettingDcb:priority-bandwidth: (type GArray(guint))
*
* An array of 8 uint values, where the array index corresponds to the User
* Priority (0 - 7) and the value indicates the percentage of bandwidth of
* the priority's assigned group that the priority may use. The sum of all
* percentages for priorities which belong to the same group must total 100
* percents.
**/
/* ---ifcfg-rh---
* property: priority-bandwidth
* variable: DCB_PG_UPPCT
* description: Priority values. Eight bandwidths (in percent), separated with commas.
* The sum of the numbers must be 100.
* example: DCB_PG_UPPCT=7,13,10,10,15,15,10,20
* ---end---
*/
obj_properties[PROP_PRIORITY_BANDWIDTH] =
g_param_spec_boxed(NM_SETTING_DCB_PRIORITY_BANDWIDTH,
"",
"",
G_TYPE_ARRAY,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
_nm_properties_override_gobj(properties_override,
obj_properties[PROP_PRIORITY_BANDWIDTH],
&nm_sett_info_propert_type_dcb_au);
/**
* NMSettingDcb:priority-strict-bandwidth: (type GArray(gboolean))
*
* An array of 8 boolean values, where the array index corresponds to the User
* Priority (0 - 7) and the value indicates whether or not the priority may
* use all of the bandwidth allocated to its assigned group.
**/
/* ---ifcfg-rh---
* property: priority-strict-bandwidth
* variable: DCB_PG_STRICT
* description: Priority values. String of eight "0" or "1", where "0" means
* "may not utilize all bandwidth", "1" means "may utilize all bandwidth".
* example: DCB_PG_STRICT=01101110
* ---end---
*/
obj_properties[PROP_PRIORITY_STRICT_BANDWIDTH] =
g_param_spec_boxed(NM_SETTING_DCB_PRIORITY_STRICT_BANDWIDTH,
"",
"",
G_TYPE_ARRAY,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
_nm_properties_override_gobj(properties_override,
obj_properties[PROP_PRIORITY_STRICT_BANDWIDTH],
&nm_sett_info_propert_type_dcb_au);
/**
* NMSettingDcb:priority-traffic-class: (type GArray(guint))
*
* An array of 8 uint values, where the array index corresponds to the User
* Priority (0 - 7) and the value indicates the traffic class (0 - 7) to
* which the priority is mapped.
**/
/* ---ifcfg-rh---
* property: priority-traffic-class
* variable: DCB_PG_UP2TC
* description: Priority values. String of eight traffic class values (0 - 7).
* example: DCB_PG_UP2TC=01623701
* ---end---
*/
obj_properties[PROP_PRIORITY_TRAFFIC_CLASS] =
g_param_spec_boxed(NM_SETTING_DCB_PRIORITY_TRAFFIC_CLASS,
"",
"",
G_TYPE_ARRAY,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS);
_nm_properties_override_gobj(properties_override,
obj_properties[PROP_PRIORITY_TRAFFIC_CLASS],
&nm_sett_info_propert_type_dcb_au);
g_object_class_install_properties(object_class, _PROPERTY_ENUMS_LAST, obj_properties);
_nm_setting_class_commit(setting_class,
NM_META_SETTING_TYPE_DCB,
NULL,
properties_override,
G_STRUCT_OFFSET(NMSettingDcb, _priv));
}
Reference in a new issue View git blame Copy permalink