


XSetCloseDownMode(3X11)				      XSetCloseDownMode(3X11)
X11R5									X11R5



NAME
  XSetCloseDownMode, XKillClient - control clients

SYNTAX
  XSetCloseDownMode(_d_i_s_p_l_a_y, _c_l_o_s_e__m_o_d_e)
	Display	*_d_i_s_p_l_a_y;
	int _c_l_o_s_e__m_o_d_e;

  XKillClient(_d_i_s_p_l_a_y, _r_e_s_o_u_r_c_e)
	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	ter-
  minated 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 des-
  troyed (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 des-
  troyed. 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 argu-
	    ment, 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	delim off




