LAMHALT(1)

💖 LAMHALT(1) — the LAM TOOLS girlies 💖

okay so bestie, welcome to lamhalt from the LAM TOOLS lineup 💅 this is the manual page, section 1, and she's here to tell you how to Shutdown the LAM/MPI run-time environment. yes that's the whole name. slay. ✨

🎀 SYNOPSIS 🎀

lamhalt [-dhHv]

that's it. that's the whole summoning ritual. no cap. 🫶

✨ OPTIONS ✨

• -d — turn on debugging mode. and heads up bestie, this one implies -v, so you get the verbosity whether you asked for it or not 😌 it's giving package deal.
• -h — print the command help menu. your little emergency "what do I even do" button 🥺
• -i — return immediately, like, even before the LAM universe is fully halted. it's deprecated btw 💀 she's old, she's tired, but she's still in the manual.
• -H — suppress printing the header message. for the girlies who want zero small talk, just results 🙈
• -v — be verbose. she will tell you things. narration mode activated 🗣️✨

🌸 DESCRIPTION 🌸

so what does she actually do? lamhalt terminates the LAM software on every single node that was initially booted with lamboot and/or lamgrow. you don't need to pass any extra command line arguments, bestie — not a single one — lamhalt just sends a message to each remote node telling it to shut itself down. iconic behaviour, honestly. 👑

and the way each remote node does it? it invokes tkill(1) locally to shut down. so if you wanna know exactly how LAM gets terminated on each individual node, go read tkill(1). iykyk. 🦋

⚠️ real talk for a sec: lamhalt may fail if one of the remote nodes has failed and doesn't respond to lamhalt's queries. if that happens, use the lamwipe(1) command instead to shut down LAM/MPI. and if lamwipe(1) also fails? you can manually invoke tkill(1) on the troubled node. and in extreme cases, you may have to terminate individual LAM processes with kill(1). scary but true 😭

okay now story time, because the lore matters 📖 older versions of lamhalt would return 1-3 seconds before the entire LAM universe was shut down. and that caused problems for some LAM users — especially the ones with scripts that invoked lamboot immediately after lamhalt. messy. chaotic. not the vibe. 🙈

so lamhalt got changed, periodt. now she waits until the entire LAM universe is down before exiting. which means running lamhalt takes a few seconds — typically less than 5. worth it for the accuracy tbh. 💅

and for the users who want the old lamhalt behaviour? use the -i (or "immediate") switch, which causes lamhalt to return immediately — likely before the entire LAM universe has been taken down. main character energy, zero patience. 🧚

🌈 EXAMPLES 🌈

• lamhalt -d — shutdown LAM on the machines and be verbose about its actions. she's telling you everything she's doing, step by step, like a group chat voice note 🎤

👑 SEE ALSO 👑

recon(1), lamboot(1), tkill(1), bhost(5), lam-helpfile(5), lamwipe(1)

go read your sisters, they're all iconic in their own ways 💜

and that's the whole page, bestie!! this one's from LAM 7.1.4, dated July, 2007 — yeah she's an elder but she still eats 💖 ✨ 🎀 go shut down that universe responsibly, mwah 🫶💅