x2golistsessions(8)

💖 x2golistsessions — the X2Go Server Tool that spills the tea on ur sessions 💖

okay bestie, so this little icon is x2golistsessions, and she lives in section 8 of the manual (that's the sysadmin/tool girlies section, iykyk). She's part of the X2Go Server Tool lineup and honestly? she's the one who always knows what everyone's doing. 🫶

---

✨ SYNOPSIS ✨

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

that's it. that's the whole vibe. one optional little argument and she's off. 💅

---

🌸 DESCRIPTION 🌸

so basically, x2golistsessions hands you back a whole list of running or suspended X2Go sessions that belong to the X2Go server you name as <server_hostname>. If you don't give her a server hostname at the command line? No stress — she just runs the session list query for the local system instead. lowkey convenient fr fr. ✨

and here's the thing: x2golistsessions runs with normal user privileges, no sudo drama, no root energy required. X2Go clients use her to render that pretty list of available X2Go sessions you see when you're picking where to log in. main character behavior honestly. 👑

---

🦋 X2GO CLUSTER MODE 🦋

if you run x2golistsessions with the --all-servers option, she doesn't just peek at one machine — she goes and queries the central database of your X2Go cluster for running/suspended sessions that belong to the user executing this command. so those sessions could be active on any of the X2Go servers in your cluster. it's giving surveillance but make it cute. 🌈

---

🎀 RETURN VALUES 🎀

what you get back is a line-by-line list of available X2Go sessions. Each line is made of several session attribute fields, and they're all separated by the pipe symbol (,,|''). 🍓

here's what every session attribute in each output line actually means, field by field:

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>
field 15: <tekictrl_port> (if Telekinesis is available/enabled)
field 15: <tekidata_port> (if Telekinesis is available/enabled)

and as for the exitcode? x2golistsessions always returns 0. always. she does not do failure codes, she does not do drama. iconic. ✨

---

👀 SEE ALSO 👀

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

• x2golistsessions_root(8)
• x2golistdesktops(8)
• x2goresume-session(8)
• x2gosuspend-session(8)
• x2goterminate-session(8)

---

💜 AUTHOR 💜

this manual was written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project (https://www.x2go.org). shoutout to him, fr. 🫶

---

and that's the whole page babes — Version 4.1.0.6, dated Aug 2023, still serving. no cap. go list some sessions. 💅✨🎀