x2golistdesktops(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

πŸ’… x2golistdesktops(8) β€” X2Go Server Tool ✨

okay bestie, gather round, because this one is genuinely a little bop. it's x2golistdesktops, a manual page from the X2Go Server Tool set, and it does exactly one job and does it flawlessly. no notes. πŸ‘‘


🌸 NAME 🌸

x2golistdesktops β€” List Available X Desktops πŸ–₯️✨


πŸŽ€ SYNOPSIS πŸŽ€

x2golistdesktops [<server_hostname>]

that's it. that's the whole vibe. one optional little argument and she's off. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the tea, bestie: x2golistdesktops hands you back a list of all the active desktop sessions chillin' on the server <server_hostname>. that's the whole assignment. πŸ“‹

and if you're feeling lazy (no judgement, we've all been there) and you don't pass a server hostname at the command line? it just uses the fully qualified domain name of the local system instead. self-sufficient queen. πŸ’–

now, the important bit β€” this thing runs with X2Go user privileges. and who's actually calling it? the X2Go clients do, because they need to render a list of available desktops that could be candidates for X2Go desktop sharing (aka shadow sessions πŸ‘€). so like, it's not just a list, it's a vibe check on who you could hop into.

and what actually ends up in that list? okay so, three whole categories:

  • local desktop sessions β€” the ones launched via KDM, GDM, etc., run by the same user
  • X2Go desktop sessions β€” also run by the same user
  • desktop sessions of other users β€” local or remote β€” but ONLY the ones that are announced via the x2godesktopsharing utility. if they didn't announce, they're not invited to the party. πŸšͺ
ngl that last bullet is the sneaky one β€” other users' sessions only show up if x2godesktopsharing is out here doing the announcing. no announcement, no appearance. periodt.

⭐ RETURN VALUES ⭐

you get back a list of available X desktops, served up line-by-line. one per line, clean, organized, iconic. πŸ“

and as for the exitcode? x2golistdesktop always returns 0. always. she does not fail, she does not flinch, she simply delivers. πŸ˜ŒπŸ’―


πŸ‘€ SEE ALSO πŸ‘€


πŸ’œ AUTHOR πŸ’œ

this manual was written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project (https://www.x2go.org). absolute legend behavior, honestly. πŸ™βœ¨


okay and that's the whole page, bestie!! πŸŽ€ this was Version 4.1.0.6, dated Aug 2023, and it ate. no crumbs. if you ever forget what it does, just remember: list the desktops, exit 0, never miss. πŸ’…πŸŒˆπŸ¦‹