MC-WAIT-FOR-NAME(1)

💖 mc-wait-for-name — the manual page, but make it cute 💖

okay bestie, sit down, grab a strawberry 🍓, because this one is short and iconic. it's mc-wait-for-name, from the Utilities corner of the manual, and honestly? it does exactly one thing and it does it flawlessly. main character energy, no notes. 👑

---

✨ NAME ✨

mc-wait-for-name — literally just sit there and vibe until a D-Bus name shows up on the session bus. that's it. that's the whole job. 💅

---

🌸 SYNOPSIS 🌸

mc-wait-for-name WELL-KNOWN-NAME

and here's the lil glow-up version, the way you'd actually see it written out in a [D-Bus Service] file 🦋:

[D-Bus Service]
Name=org.freedesktop.Telepathy.Client.Something
Exec=/usr/bin/mc-wait-for-name org.freedesktop.Telepathy.Client.Something

like, that's the whole vibe. one argument, one job, one slay. ✨

---

🎀 DESCRIPTION 🎀

so here's the tea: mc-wait-for-name runs until a bus name appears, and then it exits successfully. periodt. 🫶

why would you even want that? because it's a service-activation helper 💖. some bus names can't be activated directly, no cap — but the desktop session will hand them over automatically after a while. so instead of standing there refreshing like an iphone on 2% battery, you let mc-wait-for-name hold your spot in the group chat until the name finally pulls up. then it dips, successfully. iconic behaviour. 🌈

---

💀 EXIT STATUS 💀

okay this part actually matters, so lock in 🔥:

• 0 — the bus name eventually appeared. yay!! we ate!! 🎉
• 64 (EX_USAGE) — invocation error. that means too many or too few arguments, or the bus name you gave wasn't a syntactically valid well-known bus name. bestie. the name has to be well-formed. 🙈
• 69 (EX_UNAVAILABLE) — mc-wait-for-name couldn't connect to the session bus at all. it's not you, it's the bus. 😭
• 75 (EX_TEMPFAIL) — the name didn't show up within a reasonable time. it ghosted. 💀

ngl, if you're scripting this, 75 is your "try again later" signal — it's a tempfail, not a forever-fail. 🫶

---

💅 OPTIONS 💅

literally none. there are no additional command-line options. zero. zilch. the options section is giving minimalism and honestly? obsessed. ✨

---

🐛 BUGS 🐛

the "reasonable time" to wait is currently hard-coded. so there's no dial to turn, no flag to pass, no settings page. the patience level is baked in, like a cake you cannot un-bake. 🎂🚫

---

Telepathy · July 2009 — yeah bestie, this lil page has been serving since 2009 and it's still cute. 💖 thanks for reading, now go wait for your name to appear. 🦋💅🌸