# tlctl session

## Synopsis

tlctl session [options] <command> [args]

## Description

tlctl session can be used to inspect and control sessions in the ThinLinc cluster.

## Options

-h, --help

  Prints a short help text and exits.

## Commands

list [options]

  List the currently running sessions in the ThinLinc cluster. If no options are specified then all sessions will be listed. Multiple options can be combined to further restrict which sessions will be listed.

  Note that the listed information is updated at a fixed interval, and may therefore be outdated. If you want to get the most up-to-date information use the `--refresh` option, this operation can be time consuming.

  --refresh

    Force a refresh of the session list.

  --agent=AGENT

    Only show the sessions running on AGENT.

  --display=DISPLAY

    Only show the sessions with display id DISPLAY.

  --subcluster=SUBCLUSTER

    Only show the sessions running in SUBCLUSTER.

  --user=USERNAME

    Only show the sessions belonging to USERNAME.

terminate [options]

  Terminate one or more sessions in the ThinLinc cluster. At least one option must be given specifying with sessions to terminate. Multiple options can be combined to further restrict which sessions will be terminated.

  If the `--allow-abandon` option is specified, in addition to terminating reachable sessions, unreachable sessions will be abandoned. When a session is abandoned, the master will stop tracking it which may leave stray processes on the associated agent machine.

  --agent=AGENT

    Terminate all sessions running on AGENT.

  --all

    Terminate all sessions in the ThinLinc cluster.

  --allow-abandon

    Also abandon sessions that are unreachable and thus cannot be terminated.

  --display=DISPLAY

    Terminate all sessions with display id DISPLAY.

  --subcluster=SUBCLUSTER

    Terminate all sessions running in SUBCLUSTER.

  --user=USERNAME

    Terminate all sessions belonging to USERNAME.

  -y, --assume-yes

    Automatically answer yes for all questions.