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