OCF_HEARTBEAT_IPSRCA(7)

💅 ocf_heartbeat_IPsrcaddr — the girlies' guide to preferred source addresses ✨

Okay bestie, buckle up, because this one's from the OCF resource agents manual, section 7 — it's ocf_heartbeat_IPsrcaddr, and it's lowkey iconic for what it does. 🎀

---

🌸 NAME 🌸

ocf_heartbeat_IPsrcaddr — literally manages the preferred source address for outgoing IP packets. That's the whole vibe. 👑

---

✨ SYNOPSIS ✨

IPsrcaddr [start | stop | monitor | meta-data | validate-all]

That's it, that's the whole thing. One resource, five lil actions. Slay. 💅

---

🦋 DESCRIPTION 🦋

So this is the resource script for IPsrcaddr, and what it does is manage the modification of your preferred source address. Main character energy for your packets fr fr. ⭐

Note, and this one matters: DHCP should not be enabled for the interface serving the preferred source address. Enabling DHCP may result in unexpected behavior, such as the automatic addition of duplicate or conflicting routes. That may cause the IPsrcaddr resource to fail, or it may produce undesired behavior while the resource continues to run. Not me warning you twice 😭 — please, no DHCP on that interface. 🙈

---

💖 SUPPORTED PARAMETERS 💖

• ipaddress — The IP address. That's literally it. (required, string, no default) 👑
• cidr_netmask — The netmask for the interface, in CIDR format (ie, 24), or in dotted quad notation 255.255.255.0. (optional, string, no default) 🎀
• destination — The destination IP/subnet for the route. (optional, string, default "0.0.0.0/0") 🦋
• proto — Proto to match when finding network. E.g. "kernel". (optional, string, no default) 🌸
• metric — Metric. Only needed if incorrect metric value is used. (optional, string, no default) 💅
• pref — IPv6 route preference (low, medium or high). Only needed if incorrect pref value is used. (optional, string, no default) 🌈
• table — Table to modify and use for interface lookup. E.g. "local". The table has to have a route matching the destination parameter. This can be used for policy based routing. See man ip-rule(8). (optional, string, no default) 🧚

---

🔥 SUPPORTED ACTIONS 🔥

This resource agent supports the following actions (operations), and yes, every single one got its own suggested minimum timeout because the agent is thorough like that 💜

• start — Starts the resource. Suggested minimum timeout: 20s. ⭐
• stop — Stops the resource. Suggested minimum timeout: 20s. ⭐
• monitor — Performs a detailed status check. Suggested minimum timeout: 20s. Suggested interval: 10s. 👑
• validate-all — Performs a validation of the resource configuration. Suggested minimum timeout: 5s. 🎀
• meta-data — Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s. 🫶

---

🍓 EXAMPLE CRM SHELL 🍓

The following is an example configuration for a IPsrcaddr resource using the crm(8) shell:

primitive p_IPsrcaddr ocf:heartbeat:IPsrcaddr \
  params \
    ipaddress=string \
  op monitor depth="0" timeout="20s" interval="10s"

Copy it, paste it, live your truth. 💖

---

🌈 EXAMPLE PCS 🌈

The following is an example configuration for a IPsrcaddr resource using pcs(8):

pcs resource create p_IPsrcaddr ocf:heartbeat:IPsrcaddr \
  ipaddress=string \
  op monitor OCF_CHECK_LEVEL="0" timeout="20s" interval="10s"

Same energy, different CLI. Both ate, ngl. 💅

---

🫶 SEE ALSO 🫶

• http://clusterlabs.org/ — go say hi to the clusterlabs girlies ✨

---

💜 AUTHOR 💜

ClusterLabs contributors — see the resource agent source for information about individual authors. Shoutout to every one of them, they're the real MVPs 🥹💖

---

Sign-off time, bestie: this page is from resource-agents, version UNKNOWN, dated 10/01/2026, and the manual page itself is OCF_HEARTBEAT_IPSRCA(7). Now go forth and route responsibly ✨🧚💜