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