XAddHosts()XAddHosts()NameXAddHosts – add multiple hosts to the access control list.
Synopsis
XAddHosts(display, hosts, num_hosts)
Display *display;
XHostAddress *hosts;
int num_hosts;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
hosts Specifies each host that is to be added.
num_hosts Specifies the number of hosts that are to be added.
DescriptionXAddHosts() adds each specified host to the access control list for the
server specified by display. The access control list is a primitive
security feature that allows access to the server only by other
machines listed in a file on the machine running the server. On UNIX
systems, this file is /etc/X?.hosts, where ? is the number of the dis‐
play.
The application that calls XAddHosts() and the server whose list is
being updated must be running on the same host machine.
The address data must be a valid address for the type of network in
which the server operates, as specified by the family member. Inter‐
net, DECnet and ChaosNet networks are currently supported.
For TCP/IP, the address should be in network byte order. For the DEC‐
net 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, see Volume One, Chapter 15,
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;
/* The following constants for family member */
#define FamilyInternet 0
#define FamilyDECnet 1
#define FamilyChaos 2
Errors
BadAccess
BadValue
See AlsoXAddHost(), XDisableAccessControl(), XEnableAccessControl(),
XListHosts(), XRemoveHost(), XRemoveHosts(), XSetAccessControl().
Xlib - Host Access XAddHosts()