NMSettingBond: libnm Reference Manual

## NMSettingBond NMSettingBond — Describes connection properties for bonds |

## Functions

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 ()
const char * | nm_setting_bond_get_option_normalized ()

## Properties

GHashTable * | options | Read / Write

## Types and Values

#define | NM_SETTING_BOND_SETTING_NAME
#define | NM_SETTING_BOND_OPTIONS
#define | NM_SETTING_BOND_OPTION_MODE
#define | NM_SETTING_BOND_OPTION_MIIMON
#define | NM_SETTING_BOND_OPTION_DOWNDELAY
#define | NM_SETTING_BOND_OPTION_UPDELAY
#define | NM_SETTING_BOND_OPTION_ARP_INTERVAL
#define | NM_SETTING_BOND_OPTION_ARP_IP_TARGET
#define | NM_SETTING_BOND_OPTION_ARP_VALIDATE
#define | NM_SETTING_BOND_OPTION_PRIMARY
#define | NM_SETTING_BOND_OPTION_PRIMARY_RESELECT
#define | NM_SETTING_BOND_OPTION_FAIL_OVER_MAC
#define | NM_SETTING_BOND_OPTION_USE_CARRIER
#define | NM_SETTING_BOND_OPTION_AD_SELECT
#define | NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY
#define | NM_SETTING_BOND_OPTION_RESEND_IGMP
#define | NM_SETTING_BOND_OPTION_LACP_RATE
#define | NM_SETTING_BOND_OPTION_ACTIVE_SLAVE
#define | NM_SETTING_BOND_OPTION_AD_ACTOR_SYS_PRIO
#define | NM_SETTING_BOND_OPTION_AD_ACTOR_SYSTEM
#define | NM_SETTING_BOND_OPTION_AD_USER_PORT_KEY
#define | NM_SETTING_BOND_OPTION_ALL_SLAVES_ACTIVE
#define | NM_SETTING_BOND_OPTION_ARP_ALL_TARGETS
#define | NM_SETTING_BOND_OPTION_MIN_LINKS
#define | NM_SETTING_BOND_OPTION_NUM_GRAT_ARP
#define | NM_SETTING_BOND_OPTION_NUM_UNSOL_NA
#define | NM_SETTING_BOND_OPTION_PACKETS_PER_SLAVE
#define | NM_SETTING_BOND_OPTION_TLB_DYNAMIC_LB
#define | NM_SETTING_BOND_OPTION_LP_INTERVAL
#define | NM_SETTING_BOND_OPTION_PEER_NOTIF_DELAY
| NMSettingBond

## Object Hierarchy

        GObject
        ╰── NMSetting
            ╰── NMSettingBond

## Description

The NMSettingBond object is a NMSetting subclass that describes properties necessary for bond connections.

## Functions

### nm_setting_bond_new ()

    NMSetting *
    nm_setting_bond_new (void);

Creates a new NMSettingBond object with default values.

#### Returns

the new empty NMSettingBond object.

[transfer full]

### nm_setting_bond_get_num_options ()

    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()`.

#### Parameters

setting | the NMSettingBond |

#### Returns

the number of bonding options

### 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.

#### Parameters

setting | the NMSettingBond |
idx | index of the desired option, from 0 to `nm_setting_bond_get_num_options()` - 1 |
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]

#### Returns

`TRUE` on success if the index was valid and an option was found, `FALSE` if the index was invalid (ie, greater than the number of options currently held by the setting)

### nm_setting_bond_get_option_by_name ()

    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.

#### Parameters

setting | the NMSettingBond |
name | the option name for which to retrieve the value |

#### Returns

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

### nm_setting_bond_add_option ()

    gboolean
    nm_setting_bond_add_option (NMSettingBond *setting,
                                const char *name,
                                const char *value);

Add an option to the table. Adding a new name replaces any existing name/value pair that may already exist.

#### Parameters

setting | the NMSettingBond |
name | name for the option |
value | value for the option |

#### Returns

returns `FALSE` if either `name` or `value` is `NULL`, in that case the option is not set. Otherwise, the function does not fail and does not validate the arguments. All validation happens via `nm_connection_verify()` or do basic validation yourself with `nm_setting_bond_validate_option()`.

Note: Before 1.30, libnm would perform basic validation of the name and the value via `nm_setting_bond_validate_option()` and reject the request by returning FALSE. Since 1.30, libnm no longer rejects any values as the setter is not supposed to perform validation.

### nm_setting_bond_remove_option ()

    gboolean
    nm_setting_bond_remove_option (NMSettingBond *setting,
                                   const char *name);

Remove the bonding option referenced by `name` from the internal option list.

#### Parameters

setting | the NMSettingBond |
name | name of the option to remove |

#### Returns

`TRUE` if the option was found and removed from the internal option list, `FALSE` if it was not.

### nm_setting_bond_validate_option ()

    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.

#### Parameters

name | the name of the option to validate |
value (allow-none) | the value of the option to validate. |

#### Returns

`TRUE`, if the `value` is valid for the given name. If the `name` is not a valid option, `FALSE` will be returned.

### nm_setting_bond_get_valid_options ()

    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`.

#### Parameters

setting | the NMSettingBond. | [allow-none]

#### Returns

a `NULL`-terminated array of strings of valid bond options.

[transfer none]

### nm_setting_bond_get_option_default ()

    const char *
    nm_setting_bond_get_option_default (NMSettingBond *setting,
                                        const char *name);

#### Parameters

setting | the NMSettingBond |
name | the name of the option |

#### Returns

the value of the bond option if not overridden by an entry in the “options” property.

### nm_setting_bond_get_option_normalized ()

    const char *
    nm_setting_bond_get_option_normalized (NMSettingBond *setting,
                                           const char *name);

#### Parameters

setting | the NMSettingBond |
name | the name of the option |

#### Returns

the value of the bond option after normalization, which is what NetworkManager will actually apply when activating the connection. `NULL` if the option won't be applied to the connection.

Since: 1.24

## Types and Values

### NM_SETTING_BOND_SETTING_NAME

    #define NM_SETTING_BOND_SETTING_NAME "bond"

### NM_SETTING_BOND_OPTIONS

    #define NM_SETTING_BOND_OPTIONS "options"

### NM_SETTING_BOND_OPTION_MODE

    #define NM_SETTING_BOND_OPTION_MODE              "mode"

### NM_SETTING_BOND_OPTION_MIIMON

    #define NM_SETTING_BOND_OPTION_MIIMON            "miimon"

### NM_SETTING_BOND_OPTION_DOWNDELAY

    #define NM_SETTING_BOND_OPTION_DOWNDELAY         "downdelay"

### NM_SETTING_BOND_OPTION_UPDELAY

    #define NM_SETTING_BOND_OPTION_UPDELAY           "updelay"

### NM_SETTING_BOND_OPTION_ARP_INTERVAL

    #define NM_SETTING_BOND_OPTION_ARP_INTERVAL      "arp_interval"

### NM_SETTING_BOND_OPTION_ARP_IP_TARGET

    #define NM_SETTING_BOND_OPTION_ARP_IP_TARGET     "arp_ip_target"

### NM_SETTING_BOND_OPTION_ARP_VALIDATE

    #define NM_SETTING_BOND_OPTION_ARP_VALIDATE      "arp_validate"

### NM_SETTING_BOND_OPTION_PRIMARY

    #define NM_SETTING_BOND_OPTION_PRIMARY           "primary"

### NM_SETTING_BOND_OPTION_PRIMARY_RESELECT

    #define NM_SETTING_BOND_OPTION_PRIMARY_RESELECT  "primary_reselect"

### NM_SETTING_BOND_OPTION_FAIL_OVER_MAC

    #define NM_SETTING_BOND_OPTION_FAIL_OVER_MAC     "fail_over_mac"

### NM_SETTING_BOND_OPTION_USE_CARRIER

    #define NM_SETTING_BOND_OPTION_USE_CARRIER       "use_carrier"

### NM_SETTING_BOND_OPTION_AD_SELECT

    #define NM_SETTING_BOND_OPTION_AD_SELECT         "ad_select"

### NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY

    #define NM_SETTING_BOND_OPTION_XMIT_HASH_POLICY  "xmit_hash_policy"

### NM_SETTING_BOND_OPTION_RESEND_IGMP

    #define NM_SETTING_BOND_OPTION_RESEND_IGMP       "resend_igmp"

### NM_SETTING_BOND_OPTION_LACP_RATE

    #define NM_SETTING_BOND_OPTION_LACP_RATE         "lacp_rate"

### NM_SETTING_BOND_OPTION_ACTIVE_SLAVE

    #define NM_SETTING_BOND_OPTION_ACTIVE_SLAVE      "active_slave"

### NM_SETTING_BOND_OPTION_AD_ACTOR_SYS_PRIO

    #define NM_SETTING_BOND_OPTION_AD_ACTOR_SYS_PRIO "ad_actor_sys_prio"

### NM_SETTING_BOND_OPTION_AD_ACTOR_SYSTEM

    #define NM_SETTING_BOND_OPTION_AD_ACTOR_SYSTEM   "ad_actor_system"

### NM_SETTING_BOND_OPTION_AD_USER_PORT_KEY

    #define NM_SETTING_BOND_OPTION_AD_USER_PORT_KEY  "ad_user_port_key"

### NM_SETTING_BOND_OPTION_ALL_SLAVES_ACTIVE

    #define NM_SETTING_BOND_OPTION_ALL_SLAVES_ACTIVE "all_slaves_active"

### NM_SETTING_BOND_OPTION_ARP_ALL_TARGETS

    #define NM_SETTING_BOND_OPTION_ARP_ALL_TARGETS   "arp_all_targets"

### NM_SETTING_BOND_OPTION_MIN_LINKS

    #define NM_SETTING_BOND_OPTION_MIN_LINKS         "min_links"

### NM_SETTING_BOND_OPTION_NUM_GRAT_ARP

    #define NM_SETTING_BOND_OPTION_NUM_GRAT_ARP      "num_grat_arp"

### NM_SETTING_BOND_OPTION_NUM_UNSOL_NA

    #define NM_SETTING_BOND_OPTION_NUM_UNSOL_NA      "num_unsol_na"

### NM_SETTING_BOND_OPTION_PACKETS_PER_SLAVE

    #define NM_SETTING_BOND_OPTION_PACKETS_PER_SLAVE "packets_per_slave"

### NM_SETTING_BOND_OPTION_TLB_DYNAMIC_LB

    #define NM_SETTING_BOND_OPTION_TLB_DYNAMIC_LB    "tlb_dynamic_lb"

### NM_SETTING_BOND_OPTION_LP_INTERVAL

    #define NM_SETTING_BOND_OPTION_LP_INTERVAL       "lp_interval"

### NM_SETTING_BOND_OPTION_PEER_NOTIF_DELAY

    #define NM_SETTING_BOND_OPTION_PEER_NOTIF_DELAY  "peer_notif_delay"

### NMSettingBond

    typedef struct _NMSettingBond NMSettingBond;

Bonding Settings

## Property Details

### The `“options”` property

      “options”                  GHashTable *

Owner: NMSettingBond

Flags: Read / Write