XRemoveHosB(3x) — HP-UX 9.10

NAME

XRemoveHosts − remove multiple hosts from the access control list.

Synopsis

XRemoveHosts(display, hosts, num_hosts)
Display *display;
XHostAddress *hosts;
int num_hosts;

Arguments

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

hostsSpecifies the list of hosts that are to be removed.

num_hostsSpecifies the number of hosts that are to be removed.

Description

XRemoveHosts() removes each specified host from the access control list of the connected server. The server must be on the same host as the process that call XRemoveHosts(), in order to change the access control list. If you remove your machine from the access control list, you can no longer connect to that server, and there is no way back from this call except to log out, edit the access control file, and reset the server. The address data must be a valid address for the type of network in which the server operates, as specified in the family member. For TCP/IP, the address should be in network byte order. For the DECnet family, the server performs no automatic swapping on the address bytes. A Phase IV address is two bytes long. The first byte contains the least significant eight bits of the node number. The second byte contains the most significant two bits of the node number in the least significant two bits of the byte, and the area in the most significant six bits of the byte. For more information on access control lists, see Volume One, Chapter 13, Other Programming Techniques.

Structures

typedef struct {
int family;/* for example Family Internet */
int length;/* length of address, in bytes */
char *address;/* pointer to where to find the bytes */
} XHostAddress;
/* constants used for family member of XHostAddress */
#define FamilyInternet0
#define FamilyDECnet1
#define FamilyChaos2

Errors

BadAccess
BadValue