.TH xlsatoms "" "" "X Utility"
.PC "List atoms defined on server"
\fBxlsatoms [\-display \fIdpy\^\fB] [\-format \fIstring\^\fB] [\-range [\fIlow\^\fB] [\-\fIhigh\^\fB] ] [\-name \fIstring\fB]\fR
.PP
.HS
.SH Options:
.IP \fB\-display \fIdpy\fR"
Connect to display number
.I dpy
.IP "\fB\-format \fIstring\fR"
Format the output, where
.I string
is a
.BR printf() -style
formatting string
.IC "\fB\-name \fIstring\fR"
Name an atom to list
.IC "\-range [\fIlow\^\fB]-[\fIhigh\^\fB]\fR"
Set the range of atoms to check, by value
.HE
.II atom
.B xlsatoms
lists the atoms being used by the X server.
By default, it lists all atoms starting from one (the lowest
atom value defined by the protocol) until it finds an atom that is undefined.
If an explicit range is given,
.B xlsatoms
tries all atoms in the range, regardless of whether any are undefined.
.SH "Options"
.B xlsatoms
recognizes the following command-line options:
.IP "\fB\-display \fIdpy\fR"
Connect to display number
.IR dpy .
.IP "\fB\-format \fIstring\fR"
Format the output.
.I string
is a
.BR printf() -style
format string that
.B xlsatoms
uses to format an atom.
An atom consists of the arguments
.I value
and
.IR name ,
in that order; the former is an
.B "unsigned long"
and the latter a
.BR "char *" .
.B xlsatoms
automatically supplies a newline at the end of each line.
The default formatting string is
.BR %ld\et%s .
.IP "\fB\-name \fIstring\fR"
Name an atom to list.
If the atom
.I string
does not exist,
.B xlsatoms
prints a message on the standard error device.
.IP "\fB\-range [\fIlow\^\fB]-[\fIhigh\^\fB]\fR"
Set the range of atoms to check, by value.
If
.I low
is not given,
.B xlsatoms
assumes a value of one. 
If
.I high
is not given,
.B xlsatoms
stops at the first undefined atom at or above
.IR low .
.SH Environment
.B xlsatoms
reads the environmental variable
.B DISPLAY
to find the host and display to use.
.SH "See Also"
.B
xprop,
X utilities
.R
.SH Notes
Copyright \(co 1989, Massachusetts Institute of Technology.
.PP
.II "Fulton, Jim"
.B xlsatoms
was written by Jim Fulton of the MIT X Consortium.
