PACEMAKER(8)

PACEMAKER(8) — System Administration Utilities 💅

okay so bestie, you opened section 8 of the manual and the page is literally called PACEMAKER. it's part of the Pacemaker cluster resource manager, and even though the synopsis below is doing its attrd_updater thing, the NAME is the NAME. we don't question it, we just vibe check it. ✨

---

🌸 NAME 🌸

Pacemaker — part of the Pacemaker cluster resource manager 💖

---

🎀 SYNOPSIS 🎀

attrd_updater {-n <attribute> | -P <pattern>} <command> [options]

no cap, that's the whole shape of it. pick your attribute, pick your command, sprinkle options on top like glitter. 🦋

---

✨ DESCRIPTION ✨

query and update Pacemaker node attributes.

that's it. that's the whole description. short, iconic, ate. 👑

---

💜 OPTIONS 💜

🫶 Help Options

• -h, --help — show help options. the classic "pls explain" button.
• --help-all — show all help options. the completist edit.
• --help-output — show output help. for the output girlies.
• --help-required — show required arguments. so you know what you can't skip.
• --help-command — show command options (mutually exclusive). yes, mutually exclusive — you pick one, bestie, they do not share.
• --help-additional — show additional options. the bonus tracks.

---

🍓 Output Options

• --output-as=*FORMAT — specify output format as one of: text (default), xml. no other choices, don't try it.
• --output-to=*DEST — specify file name for output (or - for stdout). yes, the little dash means "just print it here, thanks".

---

🧚 Required Arguments

• -n, --name=*NAME — the attribute's name. literally. that's the name of the name option. she's self-describing, we stan.
• -P, --pattern=*PATTERN — operate on all attributes matching this pattern (with -B, -D, -U, or -Y). one pattern, many attributes, main character energy.

---

🔥 Command

• -U, --update=*VALUE — update the attribute's value. Required: -n/--name or -P/--pattern. Optional: -d/--delay (if specified, the delay will be used if the attribute needs to be created, but ignored if the attribute already exists), -s/--set, -p/--private, -W/--wait, -z/--utilization. okay so read that delay parenthetical twice, it's giving "conditional behaviour" and it matters.
• -B, --update-both=*VALUE — update the attribute's value and time to wait (dampening) in the attribute manager. if this changes the value or dampening, the attribute will also be written to the cluster configuration, so be aware that repeatedly changing the dampening reduces its effectiveness. Requires -d/--delay.

⚠️ not me warning you: repeatedly changing the dampening reduces its effectiveness. that's straight from the source, bestie, don't spam it.

• -Y, --update-delay — update the attribute's dampening in the attribute manager. if this changes the dampening, the attribute will also be written to the cluster configuration, so be aware that repeatedly changing the dampening reduces its effectiveness. Requires -d/--delay.

same warning, same energy: hammering the dampening makes it less effective. periodt.

• -Q, --query — query the attribute's value from the attribute manager. by default this will query the value of the attribute on the local node. use -N/--node for the value on a given node, or -A/--all for the value on all nodes. the "just checking 👀" command.
• -D, --delete — unset the attribute from the attribute manager. at the moment, there is no way to remove an attribute. this option will instead set its value to the empty string.

big caveat incoming: it doesn't actually delete. it sets the value to the empty string. that's the whole trick. 🙈

• -R, --refresh — (Advanced) force the attribute manager to resend all current values to the CIB. advanced girlies only. 🔥

---

🌈 Additional Options

• -d, --delay=*SECONDS — the time to wait (dampening) in seconds for further changes before sending to the CIB.
• -s, --set=*SET — (Advanced) the attribute set in which to place the value.
• -N, --node=*NODE — use the named node for setting and querying the attribute (instead of the local one). long-distance relationship with your node.
• -A, --all — show values of the attribute for all nodes (query only). query only, so don't try to be cute with it.
• -l, --lifetime=*SECTION — (Not yet implemented) lifetime of the node attribute (silently ignored by the cluster). it does nothing and it says so out loud. iconic honesty.
• -p, --private — if this creates a new attribute, never write the attribute to the CIB. keeping it on the low, lowkey.
• -W, --wait=*UNTIL — wait for some event to occur before returning. values are 'no' (wait only for the attribute daemon to acknowledge the request), 'local' (wait until the change has propagated to where a local query will return the request value, or the value set by a later request), or 'cluster' (wait until the change has propagated to where a query anywhere on the cluster will return the requested value, or the value set by a later request). default is 'no'.

three values. 'no', 'local', 'cluster'. default 'no'. write it down. 💅

• -z, --utilization — when creating a new attribute, create it as a node utilization attribute instead of an instance attribute. if the attribute already exists, its existing type (utilization vs. instance) will be used regardless. (with -B, -U, -Y).

---

⭐ Application Options

• -$, --version — display software version and exit. yes that's a dollar sign as a short option. she's quirky like that. 💀
• -V, --verbose — increase debug output (may be specified multiple times). stack it. stack it again. go off.

---

👑 AUTHOR 👑

written by Andrew Beekhof and the Pacemaker project contributors. absolute legends, fr fr.

---

🦋 REPORTING BUGS 🦋

report bugs to https://bugs.clusterlabs.org/enter_bug.cgi?product=Pacemaker — tell them everything, they want to know. 🫶

---

k bye bestie, go update some attributes responsibly 🌸

that was the PACEMAKER(8) page from the Pacemaker 3.0.3+20260728.7052... era, dated September 2026 — catch you in the next man page, mwah 💖🎀