swift-orphans(1)

🌸 NAME 🌸

swift-orphans — the OpenStack Swift orphans tool 💖. That's the whole name, bestie, and the manual page is literally called swift-orphans(1), so you already know what time it is. Orphan hunting era. 👑

✨ SYNOPSIS ✨

swift-orphans [-h|--help] [-a|--age] [-k|--kill] [-w|--wide] [-r|--run-dir]

🦋 DESCRIPTION 🦋

Okay so, plot twist: swift-orphans lists orphaned Swift processes, and if you're feeling spicy, it will kill them too. 💀 Not me being the one to do the dirty work.

Here's the vibe: it goes and scans /var/run/swift — or whatever directory you handed to the -r switch, if you're fancy — looking for .pid files. Then it lists any processes that look like Swift processes but aren't associated with the pids in those .pid files. Those are the orphans. They're just out there, unsupervised, no pid file to call home. 😭

Heads up bestie: any Swift processes running with the 'once' parameter get ignored. Those are usually for full-speed audit scans and such, so leave them alone, they're busy. 🏃♀️💨

Example — this one sends SIGTERM to all orphaned Swift processes older than two hours:

swift-orphans -a 2 -k TERM

Ate. ✨

💅 OPTIONS 💅 (yes bestie, the options are as follows)

• -a HOURS, --age=HOURS — look for processes at least HOURS old. Default: 24. ⏰
• -k SIGNAL, --kill=SIGNAL — send SIGNAL to the matched processes. Default: it just lists process information, no violence. 🫶
• -w, --wide — don't clip the listing at 80 characters. Let it breathe, let it be free. 🦋

🎀 DOCUMENTATION 🎀

Want more? Of course you do. More documentation about OpenStack Swift lives at:

https://docs.openstack.org/swift/latest/

Go read it, it's giving study session energy. 📚✨

That's the whole page, fr fr. This one comes from Linux and it's dated 3/15/2012 — yes, a vintage icon, we respect our elders in this house. 💜 🎀