NAME

XSetCloseDownMode, XKillClient - control clients

SYNTAX

int XSetCloseDownMode(Display *_d_i_s_p_l_a_y, int _c_l_o_s_e___m_o_d_e); int XKillClient(Display *_d_i_s_p_l_a_y, XID _r_e_s_o_u_r_c_e);

ARGUMENTS

_c_l_o_s_e___m_o_d_e Specifies the client close-down mode.
You can pass _D_e_s_t_r_o_y_A_l_l, _R_e_t_a_i_n_P_e_r_m_a_n_e_n_t, or _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y.
_d_i_s_p_l_a_y Specifies the connection to the X server.
_r_e_s_o_u_r_c_e Specifies any resource associated with the client that you want to destroy or
_A_l_l_T_e_m_p_o_r_a_r_y.

DESCRIPTION

The _X_S_e_t_C_l_o_s_e_D_o_w_n_M_o_d_e defines what will happen to the client's resources at connection close. A connection starts in _D_e_s_t_r_o_y_A_l_l mode. For information on what happens to the client's resources when the close_mode argument is _R_e_t_a_i_n_P_e_r_m_a_n_e_n_t or _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y, see section 2.6.

_X_S_e_t_C_l_o_s_e_D_o_w_n_M_o_d_e can generate a _B_a_d_V_a_l_u_e error.

The _X_K_i_l_l_C_l_i_e_n_t 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 _R_e_t_a_i_n_P_e_r_m_a_n_e_n_t or _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y mode, all of the client's resources are destroyed. If _A_l_l_T_e_m_p_o_r_a_r_y is specified, the resources of all clients that have terminated in _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y 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 _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y. 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 destroy the zombie windows.

_X_K_i_l_l_C_l_i_e_n_t can generate a _B_a_d_V_a_l_u_e error.

DIAGNOSTICS

_B_a_d_V_a_l_u_e
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

_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e