---
name: "x2golistshadowsessions"
section: "8"
platform: "linux"
package: "x2goserver"
version: "4.1.0.6-1.1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/x2golistshadowsessions"
---

# x2golistshadowsessions(8)

List Available X2Go Shadow Sessions for User

## NAME

x2golistshadowsessions - List Available X2Go Shadow Sessions for User

## SYNOPSIS

x2golistshadowsessions \[*\<server\_hostname\>*\|*--all-servers*\]

## DESCRIPTION

**x2golistshadowsessions** returns a list of running or suspended X2Go shadow sessions (sessions that provide the X2Go Desktop Sharing feature) for X2Go server *\<server\_hostname\>*. If no server hostname is given at the command line, the shadow session list query runs for the local system.

**x2golistshadowsessions** is run with normal user privileges and it is used by X2Go clients to render a list of available X2Go shadow sessions.

## X2GO CLUSTER MODE

If **x2golistshadowsessions** is executed with the *--all-servers* option then the central database of your X2Go cluster is queried for running/suspended shadow sessions belonging to the user executing this command. These sessions may be active on any of the X2Go servers within your cluster.

## RETURN VALUES

A line-by-line list of available X2Go sessions. Each line consists of several session attribute fields separated by the pipe symbol (,,\|'').

The meaning of the session attributes of each output line are shown below:

  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\>*

As exitcode **x2golistshadowsessions** always returns 0.

## SEE ALSO

[x2golistsessions(8)](/x2golistsessions/8.md), [x2golistdesktops(8)](/x2golistdesktops/8.md), [x2goresume-session(8)](/x2goresume-session/8.md), [x2gosuspend-session(8)](/x2gosuspend-session/8.md), [x2goterminate-session(8)](/x2goterminate-session/8.md)

## AUTHOR

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