xlisthosts(3) hpux man page | unix.com

XListHosts()															      XListHosts()

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
  display   Specifies 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.

Returns
  The list of structures describing each host.

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().

Xlib - Host Access														      XListHosts()