XSetCloseDownMode(3X11) XLIB FUNCTIONS XSetCloseDownMode(3X11)NAME
XSetCloseDownMode, XKillClient - control clients
SYNTAX
XSetCloseDownMode(display, close_mode)
Display *display;
int close_mode;
XKillClient(display, resource)
Display *display;
XID resource;
ARGUMENTS
close_mode
Specifies the client close-down mode. You can
pass DestroyAll, RetainPermanent, or
RetainTemporary.
display Specifies the connection to the X server.
resource Specifies any resource associated with the
client that you want to destroy or AllTemporary.
DESCRIPTION
The XSetCloseDownMode defines what will happen to the
client's resources at connection close. A connection
starts in DestroyAll mode. For information on what hap-
pens to the client's resources when the close_mode argu-
ment is RetainPermanent or RetainTemporary, see section
2.6.
XSetCloseDownMode can generate a BadValue error.
The XKillClient function forces a close down of the client
that created the resource if a valid resource is speci-
fied. If the client has already terminated in either
RetainPermanent or RetainTemporary mode, all of the
client's resources are destroyed. If AllTemporary is
specified, the resources of all clients that have termi-
nated in RetainTemporary are destroyed (see section 2.5).
This permits implementation of window manager facilities
that aid debugging. A client can set its close-down mode
to RetainTemporary. If the client then crashes, its win-
dows would not be destroyed. The programmer can then
inspect the application's window tree and use the window
manager to destroy the zombie windows.
XKillClient can generate a BadValue error.
DIAGNOSTICS
BadValue Some numeric value falls outside the range of
values accepted by the request. Unless a spe-
cific range is specified for an argument, the
full range defined by the argument's type is
X Version 11 Release 6.4 1
XSetCloseDownMode(3X11) XLIB FUNCTIONS XSetCloseDownMode(3X11)
accepted. Any argument defined as a set of
alternatives can generate this error.
SEE ALSO
Xlib - C Language X Interface
X Version 11 Release 6.4 2
