home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xinitthreads.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  2.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XInitThreads(3X11)      XLIB FUNCTIONS       XInitThreads(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XInitThreads, XLockDisplay, XUnlockDisplay - multi-
  9.        threading support
  10.  
  11. SSYYNNTTAAXX
  12.        Status XInitThreads();
  13.  
  14.        void XLockDisplay(_d_i_s_p_l_a_y)
  15.          Display *_d_i_s_p_l_a_y;
  16.  
  17.        void XUnlockDisplay(_d_i_s_p_l_a_y)
  18.          Display *_d_i_s_p_l_a_y;
  19.  
  20. AARRGGUUMMEENNTTSS
  21.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  22.  
  23. DDEESSCCRRIIPPTTIIOONN
  24.        The _X_I_n_i_t_T_h_r_e_a_d_s function initializes Xlib support for
  25.        concurrent threads.  This function must be the first Xlib
  26.        function a multi-threaded program calls, and it must com-
  27.        plete before any other Xlib call is made.  This function
  28.        returns a nonzero status if initialization was successful;
  29.        otherwise, it returns zero.  On systems that do not sup-
  30.        port threads, this function always returns zero.
  31.  
  32.        It is only necessary to call this function if multiple
  33.        threads might use Xlib concurrently.  If all calls to Xlib
  34.        functions are protected by some other access mechanism
  35.        (for example, a mutual exclusion lock in a toolkit or
  36.        through explicit client programming), Xlib thread initial-
  37.        ization is not required.     It is recommended that single-
  38.        threaded programs not call this function.
  39.  
  40.  
  41.        The _X_L_o_c_k_D_i_s_p_l_a_y function locks out all other threads from
  42.        using the specified display.  Other threads attempting to
  43.        use the display will block until the display is unlocked
  44.        by this thread.    Nested calls to _X_L_o_c_k_D_i_s_p_l_a_y work cor-
  45.        rectly; the display will not actually be unlocked until
  46.        _X_U_n_l_o_c_k_D_i_s_p_l_a_y has been called the same number of times as
  47.        _X_L_o_c_k_D_i_s_p_l_a_y.  This function has no effect unless Xlib was
  48.        successfully initialized for threads using _X_I_n_i_t_T_h_r_e_a_d_s.
  49.  
  50.        The _X_U_n_l_o_c_k_D_i_s_p_l_a_y function allows other threads to use
  51.        the specified display again.  Any threads that have
  52.        blocked on the display are allowed to continue.    Nested
  53.        locking works correctly; if _X_L_o_c_k_D_i_s_p_l_a_y has been called
  54.        multiple times by a thread, then _X_U_n_l_o_c_k_D_i_s_p_l_a_y must be
  55.        called an equal number of times before the display is
  56.        actually unlocked.  This function has no effect unless
  57.        Xlib was successfully initialized for threads using
  58.        _X_I_n_i_t_T_h_r_e_a_d_s.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XInitThreads(3X11)      XLIB FUNCTIONS       XInitThreads(3X11)
  71.  
  72.  
  73. SSEEEE AALLSSOO
  74.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  75.  
  76.  
  77.  
  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.