home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xkillclient.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XSetCloseDownMode(3X11)      XLIB FUNCTIONS  XSetCloseDownMode(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XSetCloseDownMode, XKillClient - control clients
  9.  
  10. SSYYNNTTAAXX
  11.        XSetCloseDownMode(_d_i_s_p_l_a_y, _c_l_o_s_e___m_o_d_e)
  12.          Display *_d_i_s_p_l_a_y;
  13.          int _c_l_o_s_e___m_o_d_e;
  14.  
  15.        XKillClient(_d_i_s_p_l_a_y, _r_e_s_o_u_r_c_e)
  16.          Display *_d_i_s_p_l_a_y;
  17.          XID _r_e_s_o_u_r_c_e;
  18.  
  19. AARRGGUUMMEENNTTSS
  20.        _c_l_o_s_e___m_o_d_e
  21.          Specifies the client close-down mode.    You can
  22.          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
  23.          _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y.
  24.  
  25.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  26.  
  27.        _r_e_s_o_u_r_c_e     Specifies any resource associated with the
  28.          client that you want to destroy or _A_l_l_T_e_m_p_o_r_a_r_y.
  29.  
  30. DDEESSCCRRIIPPTTIIOONN
  31.        The _X_S_e_t_C_l_o_s_e_D_o_w_n_M_o_d_e defines what will happen to the
  32.        client's resources at connection close.    A connection
  33.        starts in _D_e_s_t_r_o_y_A_l_l mode.  For information on what hap-
  34.        pens to the client's resources when the close_mode argu-
  35.        ment 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
  36.        2.6.
  37.  
  38.        _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.
  39.  
  40.        The _X_K_i_l_l_C_l_i_e_n_t function forces a close down of the client
  41.        that created the resource if a valid resource is speci-
  42.        fied.  If the client has already terminated in either
  43.        _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
  44.        client's resources are destroyed.  If _A_l_l_T_e_m_p_o_r_a_r_y is
  45.        specified, the resources of all clients that have termi-
  46.        nated in _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y are destroyed (see section 2.5).
  47.        This permits implementation of window manager facilities
  48.        that aid debugging.  A client can set its close-down mode
  49.        to _R_e_t_a_i_n_T_e_m_p_o_r_a_r_y.  If the client then crashes, its win-
  50.        dows would not be destroyed.  The programmer can then
  51.        inspect the application's window tree and use the window
  52.        manager to destroy the zombie windows.
  53.  
  54.        _X_K_i_l_l_C_l_i_e_n_t can generate a _B_a_d_V_a_l_u_e error.
  55.  
  56. DDIIAAGGNNOOSSTTIICCSS
  57.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  58.          values accepted by the request.  Unless a spe-
  59.          cific range is specified for an argument, the
  60.          full range defined by the argument's type is
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSetCloseDownMode(3X11)      XLIB FUNCTIONS  XSetCloseDownMode(3X11)
  71.  
  72.  
  73.          accepted.  Any argument defined as a set of
  74.          alternatives can generate this error.
  75.  
  76. SSEEEE AALLSSOO
  77.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.