XSetCloseDownMode() XSetCloseDownMode()
Name
XSetCloseDownMode - change the close down mode of a client.
Synopsis
XSetCloseDownMode(display, close_mode)
Display *display;
int close_mode;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
close_mode
Specifies the client close down mode you want. Pass one of these constants: DestroyAll, RetainPermanent, or RetainTemporary.
Description
XSetCloseDownMode() defines what will happen to the client's resources at connection close. A connection between a client and the server
starts in DestroyAll mode, and all resources associated with that connection will be freed when the client process dies. If the close down
mode is RetainTemporary or RetainPermanent when the client dies, its resources live on until a call to XKillClient(). The resource argu-
ment of XKillClient() can be used to specify which client to kill, or it may be the constant AllTemporary, in which case XKillClient()
kills all resources of all clients that have terminated in RetainTemporary mode.
One use of RetainTemporary or RetainPermanent might be to allow an application to recover from a failure of the network connection to the
display server. After restarting, the application would need to be able to identify its own resources and reclaim control of them.
Errors
BadValue
See Also
XKillClient().
Xlib - Client Connections XSetCloseDownMode()
