XKillClient(3X) — A/UX 3.0.1




XSetCloseDownMode(3X)                       XSetCloseDownMode(3X)



NAME
     XSetCloseDownMode, XKillClient - control clients

SYNOPSIS
     XSetCloseDownMode (display, close-mode)
     Display *display;
     int close-mode;

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

DESCRIPTION
     The XSetCloseDownMode function defines what happens 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 in Xlib
     - C Language Interface.

     The XKillClient function forces a closedown of the client
     that created the resource if a valid resource is specified.
     If the client has already terminated in either RetainPer-
     manent or
     RetainTemporary mode, all of the client's resources are des-
     troyed.  If AllTemporary is specified, the resources of all
     clients that have terminated in RetainTemporary are des-
     troyed (see Section 2.6 in Xlib - C Language Interface.)
     This permits implementation of window manager facilities
     that aid debugging.  A client can set close-down to Retain-
     Temporary.  If the client then crashes, its windows would
     not be destroyed. The programmer can then inspect the
     application's window tree and use the window manager to des-
     troy the zombie windows.

   Arguments
     These functions accept the following arguments:

     close-mode
             Specifies the client closedown mode to be changed.
             You can pass one of these constants:  DestroyAll,
             RetainPermanent, or RetainTemporary.

     display Specifies the connection to the X server.

     resource
             Specifies any resource associated with the client to
             be destroyed.  You can also pass AllTemporary.

ERRORS
     BadValue
             A numeric value falls outside the range of values



November, 1990                                                  1




XSetCloseDownMode(3X)                       XSetCloseDownMode(3X)



             accepted by the request.  Unless a range is speci-
             fied 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.

     The XSetCloseDownMode and XKillClient functions can generate
     a BadValue error.

SEE ALSO
     Xlib - C Language Interface













































2                                                  November, 1990

Museum