man(8)

💖 wait-for-it — the man page but make it slay 💖

okay bestie, so this is man(8) — section 8 of the manual, the "system administration / daemons and stuff" section, iykyk. It's the page for wait-for-it, and honestly? She's iconic. Let's get into it. 🎀

✨ NAME ✨

wait-for-it — a script that tests and waits on the availability of a TCP host and port 🦋

✨ SYNOPSIS ✨

wait-for-it host:port [-s] [-t timeout] [-- command args]

that's it. that's the whole vibe. 💅

✨ DESCRIPTION ✨

wait-for-it is a pure bash script that will wait on the availability of a host and TCP port. 🌸

The way this is SO useful: it's for synchronizing the spin-up of interdependent services — like, think linked docker containers, where one thing literally cannot start until its bestie is up and listening. 🫶

And because she's a pure bash script, she has no external dependencies at all. No extra packages, no drama, no "oops you need to install this first." Just bash. Periodt. 💀✨

✨ OPTIONS ✨

• -h HOST, --host=HOST — the host or IP you're putting under test 👑
• -p PORT, --port=PORT — the TCP port under test 🔌
• -s, --strict — only execute the subcommand if the test actually succeeds. no success, no run. strict queen behavior 😤
• -q, --quiet — don't output any status messages. silent. mysterious. lowkey 🤫
• -t TIMEOUT, --timeout=TIMEOUT — timeout in seconds, and zero means no timeout (as in, she will wait forever, bestie, she is patient) ⏳
• -- COMMAND ARGS — execute the command with its args after the test finishes 🏃♀️💨

✨ AUTHOR ✨

Giles Hall 🌈

and that's the whole page, no cap. This one's rocking version 1.0, dated 29 April 2016 — an absolute vintage icon, she was slaying before most of us even had a terminal open 💅✨ mwah, go wait on that port bestie 💖🦋