## NMSettingBridge NMSettingBridge — Describes connection properties for bridges |

## Synopsis

    #define             NM_SETTING_BRIDGE_SETTING_NAME
    #define             NM_SETTING_BRIDGE_MAC_ADDRESS
    #define             NM_SETTING_BRIDGE_STP
    #define             NM_SETTING_BRIDGE_PRIORITY
    #define             NM_SETTING_BRIDGE_FORWARD_DELAY
    #define             NM_SETTING_BRIDGE_HELLO_TIME
    #define             NM_SETTING_BRIDGE_MAX_AGE
    #define             NM_SETTING_BRIDGE_AGEING_TIME
    struct              NMSettingBridge;
                        NMSettingBridgeClass;
    NMSetting *         nm_setting_bridge_new               (void);
    const char *        nm_setting_bridge_get_mac_address   (NMSettingBridge *setting);
    gboolean            nm_setting_bridge_get_stp           (NMSettingBridge *setting);
    guint16             nm_setting_bridge_get_priority      (NMSettingBridge *setting);
    guint16             nm_setting_bridge_get_forward_delay (NMSettingBridge *setting);
    guint16             nm_setting_bridge_get_hello_time    (NMSettingBridge *setting);
    guint16             nm_setting_bridge_get_max_age       (NMSettingBridge *setting);
    guint32             nm_setting_bridge_get_ageing_time   (NMSettingBridge *setting);

## Object Hierarchy

      GObject
       +----NMSetting
             +----NMSettingBridge

## Properties

      "ageing-time"              guint                 : Read / Write / Construct
      "forward-delay"            guint                 : Read / Write / Construct
      "hello-time"               guint                 : Read / Write / Construct
      "mac-address"              gchar*                : Read / Write
      "max-age"                  guint                 : Read / Write / Construct
      "priority"                 guint                 : Read / Write / Construct
      "stp"                      gboolean              : Read / Write / Construct

## Description

The NMSettingBridge object is a NMSetting subclass that describes properties necessary for bridging connections.

## Details

### NM_SETTING_BRIDGE_SETTING_NAME

    #define NM_SETTING_BRIDGE_SETTING_NAME "bridge"

### NM_SETTING_BRIDGE_MAC_ADDRESS

    #define NM_SETTING_BRIDGE_MAC_ADDRESS    "mac-address"

### NM_SETTING_BRIDGE_STP

    #define NM_SETTING_BRIDGE_STP            "stp"

### NM_SETTING_BRIDGE_PRIORITY

    #define NM_SETTING_BRIDGE_PRIORITY       "priority"

### NM_SETTING_BRIDGE_FORWARD_DELAY

    #define NM_SETTING_BRIDGE_FORWARD_DELAY  "forward-delay"

### NM_SETTING_BRIDGE_HELLO_TIME

    #define NM_SETTING_BRIDGE_HELLO_TIME     "hello-time"

### NM_SETTING_BRIDGE_MAX_AGE

    #define NM_SETTING_BRIDGE_MAX_AGE        "max-age"

### NM_SETTING_BRIDGE_AGEING_TIME

    #define NM_SETTING_BRIDGE_AGEING_TIME    "ageing-time"

### struct NMSettingBridge

    struct NMSettingBridge;

### NMSettingBridgeClass

    typedef struct {
    	NMSettingClass parent;
    } NMSettingBridgeClass;

### nm_setting_bridge_new ()

    NMSetting *         nm_setting_bridge_new               (void);

Creates a new NMSettingBridge object with default values.

Returns : | the new empty NMSettingBridge object. [transfer full]

### nm_setting_bridge_get_mac_address ()

    const char *        nm_setting_bridge_get_mac_address   (NMSettingBridge *setting);

`setting` : | the NMSettingBridge
Returns : | the "mac-address" property of the setting

### nm_setting_bridge_get_stp ()

    gboolean            nm_setting_bridge_get_stp           (NMSettingBridge *setting);

`setting` : | the NMSettingBridge
Returns : | the "stp" property of the setting

### nm_setting_bridge_get_priority ()

    guint16             nm_setting_bridge_get_priority      (NMSettingBridge *setting);

`setting` : | the NMSettingBridge
Returns : | the "priority" property of the setting

### nm_setting_bridge_get_forward_delay ()

    guint16             nm_setting_bridge_get_forward_delay (NMSettingBridge *setting);

`setting` : | the NMSettingBridge
Returns : | the "forward-delay" property of the setting

### nm_setting_bridge_get_hello_time ()

    guint16             nm_setting_bridge_get_hello_time    (NMSettingBridge *setting);

`setting` : | the NMSettingBridge
Returns : | the "hello-time" property of the setting

### nm_setting_bridge_get_max_age ()

    guint16             nm_setting_bridge_get_max_age       (NMSettingBridge *setting);

`setting` : | the NMSettingBridge
Returns : | the "max-age" property of the setting

### nm_setting_bridge_get_ageing_time ()

    guint32             nm_setting_bridge_get_ageing_time   (NMSettingBridge *setting);

`setting` : | the NMSettingBridge
Returns : | the "ageing-time" property of the setting

## Property Details

### The `"ageing-time"` property

      "ageing-time"              guint                 : Read / Write / Construct

The Ethernet MAC address aging time, in seconds.

Allowed values: <= 1000000

Default value: 300

### The `"forward-delay"` property

      "forward-delay"            guint                 : Read / Write / Construct

The Spanning Tree Protocol (STP) forwarding delay, in seconds.

Allowed values: <= 30

Default value: 15

### The `"hello-time"` property

      "hello-time"               guint                 : Read / Write / Construct

The Spanning Tree Protocol (STP) hello time, in seconds.

Allowed values: <= 10

Default value: 2

### The `"mac-address"` property

      "mac-address"              gchar*                : Read / Write

If specified, the MAC address of bridge. When creating a new bridge, this MAC address will be set. When matching an existing (outside NetworkManager created) bridge, this MAC address must match.

Default value: NULL

### The `"max-age"` property

      "max-age"                  guint                 : Read / Write / Construct

The Spanning Tree Protocol (STP) maximum message age, in seconds.

Allowed values: <= 40

Default value: 20

### The `"priority"` property

      "priority"                 guint                 : Read / Write / Construct

Sets the Spanning Tree Protocol (STP) priority for this bridge. Lower values are "better"; the lowest priority bridge will be elected the root bridge.

Allowed values: <= 65535

Default value: 32768

### The `"stp"` property

      "stp"                      gboolean              : Read / Write / Construct

Controls whether Spanning Tree Protocol (STP) is enabled for this bridge.

Default value: TRUE