.TH xlsclients "" "" "X Utility"
.PC "List client applications running on a display"
\fBxlsclients [\-display \fIdisplayname\^\fB] [\-a] [-l] [\-m \fImaxcmdlen\^\fB]\fR
.PP
.HS
.IC "\fB\-display \fIdisplayname\fR"
List information about the display
.I displayname
.IC \fB\-a\f\r
List the clients on all screens
.IC \fB\-l\fR
Output a long listing that also gives the window name,
the icon name, and class hints, in addition to the
machine name and command string
.IC "\-m \fImaxcmdlen\fR"
Give the maximum number of characters to print for a given command
.HE
The X utility
.B xlsclients
lists information about the client applications running on a display.
You can use it to generate a script that represents
a snapshot of your current session.
.PP
.B xlsclients
recognizes the following command-line options:
.IP \fB\-a\fR
List the clients on all screens.
By default,
.B xlsclients
lists only the clients on the default screen.
.IP "\fB\-display \fIdisplayname\fR"
List information about the display
.IR displayname .
.IP \fB\-l\fR
By default,
.B xlsclients
prints the machine name and command string.
This options tells
.B xlsclients
to output a long listing that also gives the window name,
the icon name, and class hints.
.IP "\fB\-m \fImaxcmdlen\fR"
Give the maximum number of characters to print for a given command.
The default is 10,000.
.SH Environment
.B xlsclients
reads the environmental variable
.B DISPLAY
to get the host, display number, and screen.
.SH "See Also"
.B
X utilities,
xwininfo
.R
.SH Notes
Copyright \(co 1989, Massachusetts Institute of Technology.
.PP
.II "Fulton, Jim"
.B xlsclients
was written by Jim Fulton of the MIT X Consortium.
