XDG-SU(1)

📦 version 1.2.1, in opensuse-leap 16.0

💅 XDG-SU(1) — the xdg-su manual, but make it make sense

okay so bestie, listen. you know how sometimes you need a GUI program to run as another user (usually root, let's be real) and your desktop just kinda... asks you for a password in a cute little popup instead of making you live in the terminal? yeah. that's xdg-su. it's giving "sudo but make it cute and graphical" and honestly? iconic. ✨

🌸 NAME 🌸

xdg-su — run a GUI program as another user (typically root) after prompting for that user's password 🫶

🎀 SYNOPSIS 🎀

xdg-su [-u user] -c command
xdg-su {--help | --manual | --version}

✨ DESCRIPTION ✨

okay so here's the whole vibe. xdg-su pops up a graphical dialog that asks the user for a password, and then it runs command as user — or, if you didn't tell it who, it runs it as root. 👑

quick facts, no cap:

  • xdg-su is for use inside a desktop session only. it's a desktop girlie, don't try to make it do terminal things. 💅
  • xdg-su discards any stdout and stderr output from command. like, it does not want to hear it. gone. not your business anymore. 🙈

🦋 OPTIONS 🦋

  • -c command — the command to run. this one is mandatory, bestie, you literally cannot skip it. ✋
  • -u user — run command as user. the default is to run as root. 👑
  • --help — show command synopsis. the little tl;dr. 📋
  • --manual — show this manual page. hi, you're here! 🎀
  • --version — show the xdg-utils version information. 🌈

💀 EXIT CODES 💀

an exit code of 0 means success (slay 💖). a non-zero exit code means failure (not slay 😭). here are the failure codes it can return:

  1. Error in command line syntax. you typed it wrong, bestie. 🫠
  2. One of the files passed on the command line did not exist. it's not there. it never was. 💀
  3. A required tool could not be found. missing piece, can't do the thing. 🔍
  4. The action failed. it just didn't work. rough. 😔

🌟 EXAMPLES 🌟

xdg-su -u root -c "/opt/shinythings/bin/install-GUI --install fast"

runs the /opt/shinythings/bin/install-GUI command with root permissions. main character energy, honestly — that path is long enough to be a personality trait. 🔥

👀 SEE ALSO 👀

su(1) — the OG. the classic. the one that doesn't do dialogs but still ate. 💜

🫶 AUTHORS 🫶

  • Kevin Krammer — Author.
  • Jeremy White — Author.

Copyright © 2006

and that's the whole page, bestie! 💖 this was release 0.5 of the xdg-utils situation, dated 07/21/2024, and it belongs to the xdg-su manual. iykyk. 🧚✨

📦 where this page comes from