x2goruncommand(8)

✨ x2goruncommand — the X2Go Server Tool that launches ur command 💖

okay so bestie, welcome to the x2goruncommand(8) manual page, and lemme tell u, this little icon is the one that actually runs the thing inside ur X2Go session. no cap. let's get into it 🌸

---

🌈 NAME 🌈

x2goruncommand — Launch Command inside an X2Go Session

---

🎀 SYNOPSIS 🎀

x2goruncommand <display> <agent_pid> <session_id> <command>
<sound_system> <session_type>

---

💅 DESCRIPTION 💅

so basically, x2goruncommand launches a(n X-based) command inside of a given X2Go session. that's the whole gig. it's giving "middle manager of commands" and honestly? obsessed 🫶

and like, important detail: x2goruncommand is run with X2Go user privileges and is normally executed by an X2Go client application. so it's not out here doing anything spicy on its own — it's the client's little helper. periodt ✨

---

👑 ARGUMENTS 👑

six of them, bestie. all of them matter. don't skip any, i'm watching 👀

• <display> — the X display number/port of the session this command is for. like, which screen are we talking to 🖥️
• <agent_pid> — the process ID (pid) of the x2goagent instance that the given session runs in. that's ur agent's little ID badge 🪪
• <session_id> — the unique identifier of the X2Go session that this command is intended for. yes, unique. no two sessions share one. main character energy only 💖
• <command> — execute command <command>. and here's the tea: full paths will be ignored, so the command has to be in the server's $PATH. so like, don't try to be cute with /usr/bin/whatever, it's not gonna work bestie 😭

possible generic values for <command> are: WWWBROWSER, OFFICE, MAILCLIENT and TERMINAL. cute little aliases, slay 🌟

• <sound_system> — either of the possible sound systems supported by X2Go: pulse, esd, arts (obsolete) or none.

heads up: arts is obsolete, ok? it's giving ancient. but it's still on the list so we're listing it 🎧

• <session_type> — allowed values for <session_type> are: D (desktop) and R (rootless). just those two. D or R. pick one, bestie 🦋

---

🫶 RETURN VALUES 🫶

okay so here's the thing — by x2goruncommand, nothing is reported on stdout or stderr. silence. it says nothing. it's mysterious. it's ✨enigmatic✨

and as exitcode, x2goruncommand always returns 0.

always. zero. no matter what. so don't go reading exit codes like tea leaves, there's nothing there 💀

---

🔥 SEE ALSO 🔥

go read these next, they're the friend group:

• x2gostartagent(8)
• x2goresume-session(8)
• x2gosuspend-session(8)
• x2goterminate-sessions(8)

---

🌸 AUTHOR 🌸

this manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project (https://www.x2go.org). ty king, we love a documentation moment 👑

---

and that's the whole page bestie, u ate that 💅✨

Version 4.1.0.6 · Aug 2023 — okay byeee, go launch something iconic, ily 🎀💖🦋