---
name: "ocf_heartbeat_iface-bridge"
section: "7"
platform: "linux"
package: "resource-agents"
version: "1:4.16.0-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocf_heartbeat_iface-bridge"
---

# ocf\_heartbeat\_iface-bridge(7)

Manages Bridge network interfaces.

## NAME

ocf\_heartbeat\_iface-bridge - Manages Bridge network interfaces.

## SYNOPSIS

**iface-bridge** \[start \| stop \| status \| monitor \| meta-data \| validate-all\]

## DESCRIPTION

This resource manages Bridge network interfaces. It can add, remove, configure bridges and spanning-tree.

## SUPPORTED PARAMETERS

**bridge\_name**

Define the name of the bridge (max 15 charaters).

(unique, required, string, no default)

**bridge\_slaves**

Define the list of interfaces, space separated, to add to the bridge. The list can be empty.

(unique, optional, string, no default)

**bridge\_ageing**

Set the ethernet (MAC) address ageing time in seconds.

(optional, integer, no default)

**port\_hairpin**

Set hairpin forwarding mode. A list of ports that should have hairpin enabled can be specified using the following Example: eth0 eth1

(optional, string, no default)

**stp**

Enable or disable Spanning Tree Protocol on the bridge.

(optional, boolean, default false)

**stp\_bridgeprio**

Set the bridge's priority to defined value. The priority value is a number between 0 and 65535), and has no dimension. Lower priority values are preferred. The bridge with the lowest priority will be elected as root bridge.

(optional, integer, no default)

**stp\_fd**

Set the bridge forward delay (in seconds).

(optional, integer, default 0)

**stp\_maxage**

Set the bridge maximum message age (in seconds).

(optional, integer, no default)

**stp\_hello**

Set the bridge hello time (in seconds).

(optional, integer, no default)

**stp\_pathcost**

Set the port cost. This is a dimensionless metric. A list of port/cost can be specified using the following format: unpromoted cost unpromoted cost. Example: eth0 100 eth1 1000

(optional, string, no default)

**stp\_portprio**

Set the port priority. This is a number between 0 and 63. brctl man page reports a value between 0 and 255, but tests show a limit of 63 on a live system. This metric is used in the designated port and root port selection algorithms. A list of port/priority can be specified using the following format: unpromoted cost unpromoted cost. Example: eth0 10 eth1 60

(optional, string, no default)

**multicast\_router**

Enable or disable multicast routing on the bridge.

(optional, boolean, default 1)

**multicast\_snooping**

Enable or disable multicast snooping on the bridge.

(optional, boolean, default 1)

**multicast\_port\_router**

Enable or disable a port from the multicast router. Kernel enables all port by default. A list of port can be specified using the following format: unpromoted 0\|1 unpromoted 0\|1. Example: eth0 1 eth1 0

(optional, string, no default)

## SUPPORTED ACTIONS

This resource agent supports the following actions (operations):

**start**

Starts the resource. Suggested minimum timeout: 30s.

**stop**

Stops the resource. Suggested minimum timeout: 20s.

**status**

Performs a status check. Suggested minimum timeout: 20s. Suggested interval: 10s.

**monitor**

Performs a detailed status check. Suggested minimum timeout: 20s. Suggested interval: 10s.

**meta-data**

Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

**validate-all**

Performs a validation of the resource configuration. Suggested minimum timeout: 20s.

## EXAMPLE CRM SHELL

The following is an example configuration for a iface-bridge resource using the [**crm**(8)](/crm/8.md) shell:

```
primitive p_iface-bridge ocf:heartbeat:iface-bridge \
  params \
    bridge_name=string \
  op monitor timeout="20s" depth="0" interval="10s"
```

## EXAMPLE PCS

The following is an example configuration for a iface-bridge resource using [**pcs**(8)](/pcs/8.md)

```
pcs resource create p_iface-bridge ocf:heartbeat:iface-bridge \
  bridge_name=string \
  op monitor timeout="20s" OCF_CHECK_LEVEL="0" interval="10s"
```

## SEE ALSO

**http://clusterlabs.org/**

## AUTHOR

**ClusterLabs contributors (see the resource agent source for information about individual authors)**