OCF_HEARTBEAT_IFACE-BRIDGE(7)

🌉 ocf_heartbeat_iface-bridge(7) — iface-bridge

Manual name folded in near the top: OCF_HEARTBEAT_IFACE() 💖 (that’s the header family name, bestie, not a copy-pasted line).

💖 NAME

ocf_heartbeat_iface-bridge — manages Bridge network interfaces. That’s the whole assignment: bridge interfaces, handled.

✨ 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. Lowkey a whole little bridge-maintenance era 💅

---

🎛️ SUPPORTED PARAMETERS

These are the knobs, bestie. Names, types, defaults, and “required/unique” business are exactly as written:

• bridge_name — defines the name of the bridge, with a max of 15 characters. It’s (unique, required, string, no default).
• bridge_slaves — defines the list of interfaces to add to the bridge, space-separated. The list can be empty. It’s (unique, optional, string, no default).
• bridge_ageing — sets the ethernet (MAC) address ageing time in seconds. It’s (optional, integer, no default).
• port_hairpin — sets hairpin forwarding mode. You can specify a list of ports that should have hairpin enabled, like this example: eth0 eth1. It’s (optional, string, no default).
• stp — enable or disable Spanning Tree Protocol on the bridge. It’s (optional, boolean, default false).
• stp_bridgeprio — sets the bridge’s priority to the defined value. The priority value is a number between 0 and 65535, and it has no dimension. Lower priority values are preferred. The bridge with the lowest priority will be elected as root bridge. It’s (optional, integer, no default).
• stp_fd — sets the bridge forward delay, in seconds. It’s (optional, integer, default 0).
• stp_maxage — sets the bridge maximum message age, in seconds. It’s (optional, integer, no default).
• stp_hello — sets the bridge hello time, in seconds. It’s (optional, integer, no default).
• stp_pathcost — sets the port cost. This is a dimensionless metric. You can specify a list of port/cost using this format: unpromoted cost unpromoted cost. Example: eth0 100 eth1 1000. It’s (optional, string, no default).
• stp_portprio — sets the port priority. This is a number between 0 and 63. The 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. You can specify a list of port/priority using this format: unpromoted cost unpromoted cost. Example: eth0 10 eth1 60. It’s (optional, string, no default).
• multicast_router — enable or disable multicast routing on the bridge. It’s (optional, boolean, default 1).
• multicast_snooping — enable or disable multicast snooping on the bridge. It’s (optional, boolean, default 1).
• multicast_port_router — enable or disable a port from the multicast router. Kernel enables all port by default. You can specify a list of port using this format: unpromoted 0|1 unpromoted 0|1. Example: eth0 1 eth1 0. It’s (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

Here’s the example config for an iface-bridge resource using the crm(8) shell:

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

🌸 EXAMPLE PCS

And here’s the example config for an iface-bridge resource using pcs(8):

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/ — the SEE ALSO link, literally right there.

👑 AUTHOR

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

---

okay bestie, that’s the whole page 💜 Source/version is the footer tag OCF_HEARTBEAT_IFACE(); date: this page doesn’t show one, so I’m not inventing one. xoxo, your bridge-managing bestie 🫶✨