COROSYNC-CMAP(8)

✨ NAME ✨

corosync-cmapctl β€” a tool for accessing the object database. πŸ’– lowkey iconic, fr.


πŸ¦‹ DESCRIPTION πŸ¦‹

okay bestie, here's the whole vibe. the usage goes a lil something like this:

usage: corosync-cmapctl [-b] [-DdghsTt] [-m map] [-p filename] [params...]

and here are the flags that get their own lil moment:

  • -b β€” show binary values 🫢
  • -m β€” pick which map you wanna use πŸ—ΊοΈ
    • the default map is 'icmap', and it's holding the configuration info plus some runtime variables that corosync uses. very main character.
    • there's also a 'stats' map, which shows off network statistics β€” and it gets so detailed when knet is the transport. πŸ’…
    • tracking individual keys (but not prefixes, bestie, pay attention) works on the stats map, but notifications are sent on a timer, and not every time a value changes. so like, don't come for me if it's a lil delayed. ⏰

✨ Set key ✨

corosync-cmapctl -s key_name type value

where type is one of ([i|u][8|16|32|64] | flt | dbl | str | bin) 🧚

for bin, value is a file name (or - for stdin). yes literally a whole file, not just some text. πŸ“


🌸 Load settings from a file 🌸

corosync-cmapctl -p filename

the format of the file is: [^[^]]<key_name>[ <type> <value>]

  • keys prefixed with a single caret ('^') are deleted (see -d). πŸ’€
  • keys (actually prefixes, don't be fooled) prefixed with a double caret ('^^') are deleted by prefix (see -D).
  • <type> and <value> are optional (not checked) in the above cases.
  • other keys are set (see -s) so both <type> and <value> are required. no skipping, periodt. πŸ‘‘

πŸŽ€ Delete key πŸŽ€

corosync-cmapctl -d key_name...

πŸ’œ Delete multiple keys with prefix πŸ’œ

corosync-cmapctl -D key_prefix...

⭐ Get key ⭐

corosync-cmapctl [-b] -g key_name...

🀫 Quiet output 🀫

corosync-cmapctl [-b] -q -g key_name...

🌈 Display all keys 🌈

corosync-cmapctl [-b]

πŸ¦‹ Display keys with prefix key_name πŸ¦‹

corosync-cmapctl [-b] key_name...

πŸ‘€ Track changes on keys with key_name πŸ‘€

corosync-cmapctl [-b] -t key_name

πŸ”₯ Track changes on keys with key prefix πŸ”₯

corosync-cmapctl [-b] -T key_prefix

🧹 Clear statistics 🧹

(-mstats is implied, bestie, you don't gotta say it)

corosync-cmapctl -C [ipc|totem|knet|all]

πŸ’– SEE ALSO πŸ’–

cmap_overview(3), cmap_keys(7)


okay that's the whole page, we ate and left no crumbs πŸ“βœ¨ this one's from the System Manager's Manual (that's the manual name, cute right?), stamped 2012-01-23 and signed COROSYNC-CMAP(8) at the bottom. mwah, go forth and manage your objects. πŸ’…πŸ‘‘