Top | ![]() |
![]() |
![]() |
![]() |
NMSetting * | nm_setting_bond_new () |
guint32 | nm_setting_bond_get_num_options () |
gboolean | nm_setting_bond_get_option () |
const char * | nm_setting_bond_get_option_by_name () |
gboolean | nm_setting_bond_add_option () |
gboolean | nm_setting_bond_remove_option () |
gboolean | nm_setting_bond_validate_option () |
const char ** | nm_setting_bond_get_valid_options () |
const char * | nm_setting_bond_get_option_default () |
The NMSettingBond object is a NMSetting subclass that describes properties necessary for bond connections.
NMSetting *
nm_setting_bond_new (void
);
Creates a new NMSettingBond object with default values.
guint32
nm_setting_bond_get_num_options (NMSettingBond *setting
);
Returns the number of options that should be set for this bond when it
is activated. This can be used to retrieve each option individually
using nm_setting_bond_get_option()
.
gboolean nm_setting_bond_get_option (NMSettingBond *setting
,guint32 idx
,const char **out_name
,const char **out_value
);
Given an index, return the value of the bonding option at that index. Indexes
are *not* guaranteed to be static across modifications to options done by
nm_setting_bond_add_option()
and nm_setting_bond_remove_option()
,
and should not be used to refer to options except for short periods of time
such as during option iteration.
setting |
the NMSettingBond |
|
idx |
index of the desired option, from 0 to
|
|
out_name |
on return, the name of the bonding option; this value is owned by the setting and should not be modified. |
[out][transfer none] |
out_value |
on return, the value of the name of the bonding option; this value is owned by the setting and should not be modified. |
[out][transfer none] |
const char * nm_setting_bond_get_option_by_name (NMSettingBond *setting
,const char *name
);
Returns the value associated with the bonding option specified by
name
, if it exists.
the value, or NULL
if the key/value pair was never added to the
setting; the value is owned by the setting and must not be modified
gboolean nm_setting_bond_add_option (NMSettingBond *setting
,const char *name
,const char *value
);
Add an option to the table. The option is compared to an internal list of allowed options. Option names may contain only alphanumeric characters (ie [a-zA-Z0-9]). Adding a new name replaces any existing name/value pair that may already exist.
The order of how to set several options is relevant because there are options that conflict with each other.
gboolean nm_setting_bond_remove_option (NMSettingBond *setting
,const char *name
);
Remove the bonding option referenced by name
from the internal option
list.
gboolean nm_setting_bond_validate_option (const char *name
,const char *value
);
Checks whether name
is a valid bond option and value
is a valid value for
the name
. If value
is NULL
, the function only validates the option name.
const char **
nm_setting_bond_get_valid_options (NMSettingBond *setting
);
Returns a list of valid bond options.
The setting
argument is unused and may be passed as NULL
.
const char * nm_setting_bond_get_option_default (NMSettingBond *setting
,const char *name
);
#define NM_SETTING_BOND_OPTION_PRIMARY_RESELECT "primary_reselect"
#define NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY "xmit_hash_policy"
#define NM_SETTING_BOND_OPTION_AD_ACTOR_SYS_PRIO "ad_actor_sys_prio"
#define NM_SETTING_BOND_OPTION_AD_ACTOR_SYSTEM "ad_actor_system"
#define NM_SETTING_BOND_OPTION_AD_USER_PORT_KEY "ad_user_port_key"
#define NM_SETTING_BOND_OPTION_ALL_SLAVES_ACTIVE "all_slaves_active"
#define NM_SETTING_BOND_OPTION_ARP_ALL_TARGETS "arp_all_targets"
#define NM_SETTING_BOND_OPTION_PACKETS_PER_SLAVE "packets_per_slave"
#define NM_SETTING_BOND_OPTION_TLB_DYNAMIC_LB "tlb_dynamic_lb"