GNOME-SESSION-INHI(1)

✨ GNOME-SESSION-INHI(1) ✨

okay bestie, pull up a chair, because today we're talking about gnome-session-inhibit — it's a user command from the GNOME-SESSION family and honestly? it's giving very useful 💅

---

🌸 NAME 🌸

gnome-session-inhibit — inhibit gnome-session functionality no cap, that's literally the whole point 💖

---

🦋 SYNOPSIS 🦋

gnome-session-inhibit [OPTION...] [COMMAND]

---

⭐ DESCRIPTION ⭐

so here's the tea ☕ — gnome-session-inhibit can inhibit certain gnome-session functionality while it's busy executing the COMMAND you hand it. the way it does this is lowkey iconic: it calls the Inhibit() method of the gnome-session D-Bus API and creates an inhibitor. and the best part? that inhibitor gets automatically removed the moment gnome-session-inhibit exits. no cleanup, no drama, she handles herself 🫶

a typical use case — and bestie this is the one you'll actually use — is stopping the session from going idle (which, iykyk, means locking the screen 😭) while a movie player is running. movie night stays uninterrupted. main character energy fr fr 🎬✨

---

💅 OPTIONS 💅

• -h, --help — print help and dip out. that's it, that's the whole job 💀
• --version — print version information and exit. flex the numbers, queen 👑
• --app-id ID — the application id to use when calling the gnome-session Inhibit() method. if you don't pass this option, "unknown" is used. mysterious. anonymous. iconic 🙈
• --reason REASON — a human-readable reason to pass along when calling the gnome-session Inhibit() method. if you don't pass this option, "not specified" is used (so unbothered, so chill) ✨
• --inhibit ACTION — ACTION specifies the actions to inhibit. this option can be repeated to inhibit multiple actions, go off 🔥. the possible values for an ACTION are: logout, switch-user, suspend, idle, automount. if you don't pass this option at all, "idle" is assumed 🌈
• --inhibit-only — do not launch COMMAND and instead wait forever. forever. FOREVER. she's committed, she's patient, she's eternal 💀💖
• -l, --list — list the existing inhibitions and exit. a little peek at what's currently being held back 👀

not me reminding you that --inhibit-only literally means waiting forever — like, no COMMAND gets launched and the process just sits there. use it on purpose, bestie, not by accident 😭

---

🎀 SEE ALSO 🎀

systemd-inhibit(1) — the cousin, the other one, the one you also want in your contacts 💜

---

and that's the whole page!! this one came to you from the gnome-session fam, page GNOME-SESSION-INHI(1), and yeah — time to log off, hydrate, and maybe inhibit your own idle timer 🍓🧚✨