OCF_PACEMAKER_IFSPEE(7)

🌸 NAME 🌸

okay so bestie, welcome to OCF_PACEMAKER_IFSPEE(7) — that's the pacemaker config corner of the manual, and today's main character is:

ocf_pacemaker_ifspeed — a Network interface speed monitor 💅 like, it literally watches how fast your NIC is going and reports it. iconic behaviour tbh.

---

✨ SYNOPSIS ✨

here's the vibe check on how you actually call it:

[OCF_RESKEY_name=string] [OCF_RESKEY_iface=string]
[OCF_RESKEY_ip=string] [OCF_RESKEY_bridge_ports=string]
[OCF_RESKEY_weight_base=integer] [OCF_RESKEY_dampen=integer]
[OCF_RESKEY_debug=string]

ifspeed [start | stop | monitor | meta-data | validate-all |
reload-agent]

that's it, that's the whole mood 🫶

---

💖 DESCRIPTION 💖

so. the agent's monitor action records the speed of a specified network interface as a node attribute. and then — plot twist — that attribute can be used in rules to prefer nodes based on network speeds ✨. literally routing with taste.

she can monitor physical interfaces, bonded interfaces, bridges, VLANs, or any combination thereof. versatility queen 👑. for example:

• *) Bridge on top of one 10Gbps interface (eth2) and 802.3ad bonding (bond0) built on two 1Gbps interfaces (eth0 and eth1).
• *) Active-backup bonding built on top of one physical interface and one VLAN on another interface.

for STP-enabled bridges, this agent tries to determine the network topology, and by default looks only on ports which are connected to an upstream switch. ngl that's kinda smart. this can be overridden by the 'bridge_ports' parameter, iykyk. active interfaces in this case are those in "forwarding" state 💫.

for balancing bonded interfaces, this agent uses 80% of the sum of the speeds of underlying "up" ports 🔥. and for non-balancing bonded interfaces ("active-backup" and probably "broadcast"), only the speed of the currently active port is considered. no cap, that's the whole rule 😌.

---

🎀 SUPPORTED PARAMETERS 🎀

OCF_RESKEY_name = string [ifspeed]

Attribute name — the name of the node attribute to set 🏷️.

OCF_RESKEY_iface = string []

Network interface — if this is set, monitor this network interface, bestie. one of iface or ip must be set ⚠️ (not optional, fr fr).

OCF_RESKEY_ip = string []

IPv4 or IPv6 address — if this is set instead of iface, monitor the interface that holds this IP address. the address may be specified in dotted-quad notation for IPv4 (for example, 192.168.1.1) or hexadecimal notation for IPv6 (for example, 2001:db8:DC28:0:0:FC57:D4C8:1FFF). and again: one of iface or ip must be set 🙈.

OCF_RESKEY_bridge_ports = string [detect]

Bridge ports — if set and iface is a bridge, consider these bridge ports (by default, all ports which have designated_bridge=root_id) 🌉.

OCF_RESKEY_weight_base = integer [1000]

Weight of 1Gbps — relative weight of 1Gbps in interface speed. can be used to tune how big attribute value will be 📏. dial that number till it feels right, babe.

OCF_RESKEY_dampen = integer [5]

Dampening interval — the time to wait (dampening) for further changes to occur ⏳. it's giving "chill, let it settle".

OCF_RESKEY_debug = string [false]

Verbose logging — log more verbosely. that's it. that's the whole description 🫶 (default is false, so she's quiet unless you ask).

---

👑 AUTHOR 👑

Andrew Beekhof <andrew@beekhof.net> — Author. shoutout to the legend, absolute icon 🌟.

---

reminder bestie: start, stop, monitor, meta-data, validate-all and reload-agent are the actions in the synopsis — don't be out here inventing new ones 💀

---

and that's the page! 🌈 written for the Pacemaker Configuration manual, dated 09/17/2026 — go forth and monitor those interfaces, you gorgeous genius 🦋💜🎀