XSetCloseDownMode(3X11) 												   XSetCloseDownMode(3X11)

NAME

       XSetCloseDownMode, XKillClient - control clients

SYNOPSIS

       XSetCloseDownMode(display, close_mode)
	       Display *display;
	       int close_mode;

       XKillClient(display, resource)
	       Display *display;
	       XID resource;

ARGUMENTS

       Specifies  the  client  close-down  mode.  You can pass DestroyAll, RetainPermanent, or RetainTemporary.  Specifies the connection to the X
       server.	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 happens to the client's resources when the close_mode argument 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 specified. If the client has
       already terminated in either RetainPermanent or RetainTemporary mode, all of the client's resources are destroyed. If AllTemporary is spec-
       ified, the resources of all clients that have terminated 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

       Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified  for	an  argument,  the
       full range defined by the argument's type is accepted.  Any argument defined as a set of alternatives can generate this error.

SEE ALSO

       Xlib -- C Language X Interface

															   XSetCloseDownMode(3X11)