NAME

XListHosts − obtain a list of hosts having access to this display. 

Synopsis

XHostAddress *XListHosts(display, nhosts_return, state_return)
Display *display;
int *nhosts_return;
Bool *state_return;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

nhosts_return
Returns the number of hosts currently in the access control list.

state_return
Returns whether the access control list is currently being used by the server to process new connection requests from clients. True if enabled, False if disabled. 

Description

XListHosts() returns the current access control list as well as whether the use of the list is enabled or disabled.  XListHosts() allows a program to find out what machines make connections, by looking at a list of host structures.  This XHostAddress list should be freed when it is no longer needed.  For more information on access control lists, see Volume One, Chapter 13, Other Programming Techniques. 

Structures

typedef struct {
    int family;
    int length;
    char *address;
} XHostAddress;

See Also

XAddHost(), XAddHosts(), XDisableAccessControl(), XEnableAccessControl(), XRemoveHost(), XRemoveHosts(), XSetAccessControl(). 

Copyright O’Reilly & Assoc.  —