---
name: "xlsclients"
section: "1x"
platform: "linux"
package: "xbase-clients"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/xlsclients/1x"
---

# xlsclients(1x)

list client applications running on a display

## NAME

xlsclients - list client applications running on a display

## SYNOPSIS

**xlsclients** \[-display *displayname*\] \[-a\] \[-l\] \[-m maxcmdlen\]

## DESCRIPTION

*Xlsclients* is a utility for listing information about the client applications  running on a display.  It may be used to generate scripts representing a snapshot of the user's current session.

## OPTIONS

- **-display *displayname***

  This option specifies the X server to contact.

- **-a**

  This option indicates that clients on all screens should be listed.  By  default, only those clients on the default screen are listed.

- **-l**

  List in long format, giving the window name, icon name, and class hints in addition to the machine name and command string shown in the default format.

- **-m *maxcmdlen***

  This option specifies the maximum number of characters in a command to  print out.  The default is 10000.

## ENVIRONMENT

- **DISPLAY**

  To get the default host, display number, and screen.

## SEE ALSO

[X(7x)](/X/7x.md), [xwininfo(1)](/xwininfo/1.md), [xprop(1)](/xprop/1.md)

## AUTHOR

Jim Fulton, MIT X Consortium