x2golistshadowsessions(8)

📦
version 4.1.0.6 · 3 versions
, in alpine 3.24, debian trixie, fedora 43, fedora 44, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 x2golistshadowsessions — bestie edition 💅

okay so picture this: you're deep in the X2Go server tool x2golistshadowsessions(8) section of the manual, and you just wanna know which shadow sessions are out here living their best life. That's literally it. That's the whole job. Let's get into it 🫶

✨ NAME ✨

x2golistshadowsessions — List Available X2Go Shadow Sessions for User

like... it lists them. for you. the user. iconic behaviour fr fr 👑

🌸 SYNOPSIS 🌸

x2golistshadowsessions [<server_hostname>|--all-servers]

🦋 DESCRIPTION 🦋

So x2golistshadowsessions hands you back a list of all the running or suspended X2Go shadow sessions — and when we say shadow sessions, we mean the sessions that serve up the X2Go Desktop Sharing feature ✨ — for the X2Go server <server_hostname>.

And if you're out here not passing a server hostname at the command line? No stress, no drama. The shadow session list query just runs for the local system instead. lowkey convenient 💅

One thing to know: x2golistshadowsessions runs with normal user privileges, no root energy required. And it's the tool X2Go clients use behind the scenes to render that cute little list of available X2Go shadow sessions for you to pick from. main character tooling, honestly 🎀

🌈 X2GO CLUSTER MODE 🌈

Now THIS is where it gets spicy 🌶️

If you run x2golistshadowsessions with the --all-servers option, it goes and queries the central database of your X2Go cluster for running/suspended shadow sessions belonging to the user executing this command. And because it's a whole cluster, those sessions might be active on any of the X2Go servers within your cluster. So many servers. So many vibes. All in one list ✨

💖 RETURN VALUES 💖

You get a line-by-line list of available X2Go sessions. Each line is made up of several session attribute fields, all separated by the pipe symbol (,|`). periodt.

Here's the tea on what each field in an output line actually means:

  • field 01: <agent_pid>
  • field 02: <session_id>
  • field 03: <port>
  • field 04: <host>
  • field 05: <state>
  • field 06: <init_time>
  • field 07: <session_cookie>
  • field 08: <client_ip>
  • field 09: <gr_port>
  • field 10: <snd_port>
  • field 11: <last_time>
  • field 12: <user>
  • field 13: <age_in_secs>
  • field 14: <sshfs_port>

And as for the exitcode? x2golistshadowsessions always returns 0. always. every single time. no cap. it's giving unbothered and thriving 😌

👀 SEE ALSO 👀

go read these too, bestie, they're all connected:

🧚 AUTHOR 🧚

This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project (https://www.x2go.org). we love a credited author 💜

and that's the whole page, bestie!! 🎀 Version 4.1.0.6, dating all the way back to Aug 2023 — she's been out here serving shadow session lists and she's still slaying 💅✨ go forth and list responsibly 🦋

📦 where this page comes from