home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xremovehosts.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  6.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XAddHost(3X11)          XLIB FUNCTIONS       XAddHost(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemove-
  9.        Hosts, XSetAccessControl, XEnableAccessControl, XDis-
  10.        ableAccessControl, XHostAddress - control host access and
  11.        host control structure
  12.  
  13. SSYYNNTTAAXX
  14.        XAddHost(_d_i_s_p_l_a_y, _h_o_s_t)
  15.          Display *_d_i_s_p_l_a_y;
  16.          XHostAddress *_h_o_s_t;
  17.  
  18.        XAddHosts(_d_i_s_p_l_a_y, _h_o_s_t_s, _n_u_m___h_o_s_t_s)
  19.          Display *_d_i_s_p_l_a_y;
  20.          XHostAddress *_h_o_s_t_s;
  21.          int _n_u_m___h_o_s_t_s;
  22.  
  23.        XHostAddress *XListHosts(_d_i_s_p_l_a_y, _n_h_o_s_t_s___r_e_t_u_r_n,
  24.        _s_t_a_t_e___r_e_t_u_r_n)
  25.          Display *_d_i_s_p_l_a_y;
  26.          int *_n_h_o_s_t_s___r_e_t_u_r_n;
  27.          Bool *_s_t_a_t_e___r_e_t_u_r_n;
  28.  
  29.        XRemoveHost(_d_i_s_p_l_a_y, _h_o_s_t)
  30.          Display *_d_i_s_p_l_a_y;
  31.          XHostAddress *_h_o_s_t;
  32.  
  33.        XRemoveHosts(_d_i_s_p_l_a_y, _h_o_s_t_s, _n_u_m___h_o_s_t_s)
  34.          Display *_d_i_s_p_l_a_y;
  35.          XHostAddress *_h_o_s_t_s;
  36.          int _n_u_m___h_o_s_t_s;
  37.  
  38.        XSetAccessControl(_d_i_s_p_l_a_y, _m_o_d_e)
  39.          Display *_d_i_s_p_l_a_y;
  40.          int _m_o_d_e;
  41.  
  42.        XEnableAccessControl(_d_i_s_p_l_a_y)
  43.          Display *_d_i_s_p_l_a_y;
  44.  
  45.        XDisableAccessControl(_d_i_s_p_l_a_y)
  46.          Display *_d_i_s_p_l_a_y;
  47.  
  48. AARRGGUUMMEENNTTSS
  49.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  50.  
  51.        _h_o_s_t     Specifies the host that is to be added or
  52.          removed.
  53.  
  54.        _h_o_s_t_s     Specifies each host that is to be added or
  55.          removed.
  56.  
  57.        _m_o_d_e     Specifies the mode.  You can pass _E_n_a_b_l_e_A_c_c_e_s_s
  58.          or _D_i_s_a_b_l_e_A_c_c_e_s_s.
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XAddHost(3X11)          XLIB FUNCTIONS       XAddHost(3X11)
  71.  
  72.  
  73.        _n_h_o_s_t_s___r_e_t_u_r_n
  74.          Returns the number of hosts currently in the
  75.          access control list.
  76.  
  77.        _n_u_m___h_o_s_t_s Specifies the number of hosts.
  78.  
  79.        _s_t_a_t_e___r_e_t_u_r_n
  80.          Returns the state of the access control.
  81.  
  82. DDEESSCCRRIIPPTTIIOONN
  83.        The _X_A_d_d_H_o_s_t function adds the specified host to the
  84.        access control list for that display.  The server must be
  85.        on the same host as the client issuing the command, or a
  86.        _B_a_d_A_c_c_e_s_s error results.
  87.  
  88.        _X_A_d_d_H_o_s_t can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  89.  
  90.        The _X_A_d_d_H_o_s_t_s function adds each specified host to the
  91.        access control list for that display.  The server must be
  92.        on the same host as the client issuing the command, or a
  93.        _B_a_d_A_c_c_e_s_s error results.
  94.  
  95.        _X_A_d_d_H_o_s_t_s can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  96.  
  97.        The _X_L_i_s_t_H_o_s_t_s function returns the current access control
  98.        list as well as whether the use of the list at connection
  99.        setup was enabled or disabled.  _X_L_i_s_t_H_o_s_t_s allows a pro-
  100.        gram to find out what machines can make connections.  It
  101.        also returns a pointer to a list of host structures that
  102.        were allocated by the function.    When no longer needed,
  103.        this memory should be freed by calling _X_F_r_e_e.
  104.  
  105.        The _X_R_e_m_o_v_e_H_o_s_t function removes the specified host from
  106.        the access control list for that display.  The server must
  107.        be on the same host as the client process, or a _B_a_d_A_c_c_e_s_s
  108.        error results.  If you remove your machine from the access
  109.        list, you can no longer connect to that server, and this
  110.        operation cannot be reversed unless you reset the server.
  111.  
  112.        _X_R_e_m_o_v_e_H_o_s_t can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  113.  
  114.        The _X_R_e_m_o_v_e_H_o_s_t_s function removes each specified host from
  115.        the access control list for that display.  The X server
  116.        must be on the same host as the client process, or a
  117.        _B_a_d_A_c_c_e_s_s error results.     If you remove your machine from
  118.        the access list, you can no longer connect to that server,
  119.        and this operation cannot be reversed unless you reset the
  120.        server.
  121.  
  122.        _X_R_e_m_o_v_e_H_o_s_t_s can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e errors.
  123.  
  124.        The _X_S_e_t_A_c_c_e_s_s_C_o_n_t_r_o_l function either enables or disables
  125.        the use of the access control list at each connection
  126.        setup.
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XAddHost(3X11)          XLIB FUNCTIONS       XAddHost(3X11)
  137.  
  138.  
  139.        _X_S_e_t_A_c_c_e_s_s_C_o_n_t_r_o_l can generate _B_a_d_A_c_c_e_s_s and _B_a_d_V_a_l_u_e
  140.        errors.
  141.  
  142.        The _X_E_n_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l function enables the use of the
  143.        access control list at each connection setup.
  144.  
  145.        _X_E_n_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l can generate a _B_a_d_A_c_c_e_s_s error.
  146.  
  147.        The _X_D_i_s_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l function disables the use of the
  148.        access control list at each connection setup.
  149.  
  150.        _X_D_i_s_a_b_l_e_A_c_c_e_s_s_C_o_n_t_r_o_l can generate a _B_a_d_A_c_c_e_s_s error.
  151.  
  152. SSTTRRUUCCTTUURREESS
  153.        The _X_H_o_s_t_A_d_d_r_e_s_s structure contains:
  154.  
  155.        typedef struct {
  156.         int family;             /* for example FamilyInternet */
  157.         int length;             /* length of address, in bytes */
  158.         char *address;         /* pointer to where to find the address */
  159.        } XHostAddress;
  160.  
  161.        The family member specifies which protocol address family
  162.        to use (for example, TCP/IP or DECnet) and can be
  163.        _F_a_m_i_l_y_I_n_t_e_r_n_e_t, _F_a_m_i_l_y_D_E_C_n_e_t, or _F_a_m_i_l_y_C_h_a_o_s.  The length
  164.        member specifies the length of the address in bytes.  The
  165.        address member specifies a pointer to the address.
  166.  
  167. DDIIAAGGNNOOSSTTIICCSS
  168.        _B_a_d_A_c_c_e_s_s A client attempted to modify the access control
  169.          list from other than the local (or otherwise
  170.          authorized) host.
  171.  
  172.        _B_a_d_V_a_l_u_e     Some numeric value falls outside the range of
  173.          values accepted by the request.  Unless a spe-
  174.          cific range is specified for an argument, the
  175.          full range defined by the argument's type is
  176.          accepted.  Any argument defined as a set of
  177.          alternatives can generate this error.
  178.  
  179. SSEEEE AALLSSOO
  180.        XFree(3X11)
  181.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.