Next Prev Up

# 14.6 Managing Host Access

An X server maintains a list of hosts from which client programs can be run. Only clients executing on hosts that belong to this access control list are allowed to open a connection to the server. Typically, the access control list can be changed by clients running on the same host as the server. Some server implementations can also implement other authorization mechanisms in addition to, or in place of, this mechanism. The action of this mechanism can be conditional based on the authorization protocol name and data received by the server at connection setup.

The following paragraphs describe the CLX functions used to:

- Add or remove hosts on the access control list.
- Return the hosts on the access control list.
- Return or change the state of the access control list mechanism

access-control | display | Function

| display A display. Returns and (with setf) changes the state of the access control list mechanism for the display server. Returns true if access control is enabled; otherwise, nil is returned. If enabled, the access control list is used to validate each client during connection setup. Only a client running on the same host as the server is allowed to enable or disable the access control list mechanism. enabled-p Type boolean.

access-hosts | display &key ( :result-type 'list) | Function

| display A display. :result-type The type of hosts sequence to return. Returns a sequence containing the hosts that belong to the access control list of the display server. Elements of the returned hosts sequence are either strings or some other type of object recognized as a host name by add-access-host and remove-access-host. The second returned value specifies whether the access control list mechanism is currently enabled or disabled (see access-control). hosts sequence of string. enabled-p Type boolean.

add-access-host | display host | Function

| display A display. host A host name. Either a string or some other implementation-dependent type. Adds the specified host to the access control list. Only a client running on the same host as the server can change the access control list.

remove-access-host | display host | Function

| display A display. host A host name. Either a string or some other implementation-dependent type. Removes the specified host from the access control list. Only a client running on the same host as the server can change the access control list.

Next Prev Up

© 1988, 1989 Texas Instruments Incorporated
Conversion to HTML made by Gilbert Baumann.
Last build: Tue Dec 16 23:30:42 1997