mc-peermap(1)

💅 mc-peermap(1) — the mc-peermap page, bestie edition 🎀

okay so welcome to the mc-peermap manual, aka the glow-up guide for MCollective's STOMP connector helpers. she's an old one (2011, we stan a vintage queen) but she still serves.

✨ NAME ✨

mc-peermap — helpers and utilities for the MCollective STOMP connector. literally what it says on the tin, no cap. 🫶

🌸 SYNOPSIS 🌸

mc-peermap [options]

that's it. that's the whole vibe. options only, no positional args, she's low maintenance. 💅

🦋 DESCRIPTION 🦋

mc-peermap = helpers and utilities for the MCollective STOMP connector. say it with me one more time for the people in the back.

Usage, fr fr:

mc-peermap [options]

• --np, --no-progress — bestie the progress bar is cancelled. not showing it. 🙈
• -1, --one — send the request to literally only one of the discovered nodes. just the one. the chosen one. main character energy. 👑
• --limit-nodes, --ln [COUNT] — send the request to only a subset of nodes instead of all of them. and get this — COUNT can be a percentage. slay. 🔥

💖 Common Options 💖

the universal fits, the ones that go with everything:

• -T, --target COLLECTIVE — target your messages at a specific sub collective. like @-ing a specific group chat instead of the whole server. 📨
• -c, --config FILE — load config from a file instead of the default one. (the original text spells this "configuratuion" and honestly? iconic typo, we're keeping the energy.) 🎀
• --dt, --discovery-timeout SECONDS — the timeout for doing discovery. how long she waits before she's like "okay moving on". ⏳
• -t, --timeout SECONDS — the timeout for calling remote agents. same energy, different errand. 🕰️
• -q, --quiet — do not be verbose. shhh. 🤫
• -v, --verbose — be verbose. tell me EVERYTHING bestie, I want the whole lore. 🗣️
• -h, --help — display this screen. hi, hello, here's the menu. ✨

🌈 Host Filters 🌈

for when you need to be picky about which hosts get the message. vibe check for servers:

• -W, --with FILTER — a combined classes and facts filter. two for one, bundle deal. 🛍️
• -F, --wf, --with-fact fact=val — match hosts that have a certain fact. got the fact? you're in. 💅
• -C, --wc, --with-class CLASS — match hosts with a certain config management class. 💜
• -A, --wa, --with-agent AGENT — match hosts that have a certain agent. 🤖
• -I, --wi, --with-identity IDENT — match hosts with a certain configured identity. know who you are, periodt. 🪪

📜 AUTHOR 📜

this manpage was written by Juan L. Negron <juan@ubuntu.com> for Ubuntu systems (but may be used by others). permission is granted to copy, distribute and/or modify this document and the utility under the terms of the GNU General Public License, Version 3 published by the Free Software Foundation. giving credit where credit is due, as she deserves. 👑

the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL on Debian/Ubuntu systems, or in /usr/share/doc/fedora-release-*/GPL on Fedora systems, or on the web at http://www.gnu.org/licenses/gpl.txt. go read it, it's giving ✨ legal literacy ✨.

ok that's the whole page bestie, go forth and peer-map responsibly 🧚💖

and that's a wrap on the mc-peermap page from the mc-peermap manual, dated 21 June 2011 — old enough to be iconic, still hitting different. bye pookie 🎀💅🌟