---
name: "x2golistsessions"
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/x2golistsessions"
---

# x2golistsessions(8)

List Available X2Go Sessions for User

## NAME

x2golistsessions - List Available X2Go Sessions for User

## SYNOPSIS

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

## DESCRIPTION

**x2golistsessions** returns a list of running or suspended X2Go sessions for X2Go server *\<server\_hostname\>*. If no server hostname is given at the command line, the session list query runs for the local system.

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

## X2GO CLUSTER MODE

If **x2golistsessions** is executed with the *--all-servers* option then the central database of your X2Go cluster is queried for running/suspended 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\>*\
     field 15: *\<tekictrl\_port\>* (if Telekinesis is available/enabled)\
     field 15: *\<tekidata\_port\>* (if Telekinesis is available/enabled)

As exitcode **x2golistsessions** always returns 0.

## SEE ALSO

[x2golistsessions\_root(8)](/x2golistsessions_root/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).