MATE-SESSION-INHIB(1)

✨ MATE-SESSION-INHIB ✨

okay bestie, welcome to the mate-session-inhibit page β€” this is the User Commands manual, and honestly? it's a little legend. it's a whole tool whose entire job is telling your session to chill out and not do the thing while you're busy. πŸ’…


🌸 NAME 🌸

mate-session-inhibit β€” inhibit mate-session functionality 🫢


πŸŽ€ SYNOPSIS πŸŽ€

mate-session-inhibit [OPTION...] {COMMAND}

πŸ’– DESCRIPTION πŸ’–

so like, mate-session-inhibit can inhibit certain mate-session functionality while it's executing the given COMMAND. literally while your command is running, the session is on pause for whatever you asked it to pause. periodt. βœ‹

the way it does this? it calls the Inhibit() method of the mate-session D-Bus API and creates an inhibitor. and here's the slay part β€” that inhibitor is automatically removed when mate-session-inhibit exits. no cleanup, no mess, no notes. it just knows. 🧚

a typical use case, iykyk: preventing the session from going idle (and thus locking the screen 😭) while a movie player is running. imagine your screen locking mid-movie. not on my watch. πŸ“


✨ OPTIONS ✨

  • -h, --help β€” print help and exit. your little map of everything. πŸ—ΊοΈ
  • --version β€” print version information and exit. who are you, what era are you from. πŸ‘‘
  • --app-id ID β€” the application id to use when calling the mate-session Inhibit() method. if you don't specify this one, "unknown" is used. it's giving mystery. πŸ™ˆ
  • --reason REASON β€” a human-readable reason to pass along when calling the mate-session Inhibit() method. if you skip it, "not specified" is used. so like, tell them why, bestie, they're asking nicely. πŸ’¬
  • --inhibit ARG β€” ARG specifies the things to inhibit, as a colon-separated list. the possible values are logout, switch-user, suspend, idle, automount. if you use this option more than once, the values are combined (stacking, we love to see it ✨). if you don't specify it at all, "idle" is assumed. πŸ‘‘
ngl the defaults are doing a lot of heavy lifting here β€” no --inhibit means "idle", no --app-id means "unknown", no --reason means "not specified". the tool is very forgiving. a supportive icon fr fr. 🫢

πŸ¦‹ SEE ALSO πŸ¦‹

systemd-inhibit(1) β€” the cousin. the other one. go say hi. πŸ‘‹


and that's the page, bestie!! this came to you from the mate-session source, page MATE-SESSION-INHIB(1) β€” go forth and inhibit responsibly, mwah πŸ’…πŸ’–πŸŒˆ