XAddHost(3X) XAddHost(3X)NAME XAddHost, XAddHosts, XHostAddress, XListHosts, XRemoveHost, XRemoveHosts, XSetAccessControl, XEnableAccessControl, XDisableAccessControl - control access to hosts SYNOPSIS XAddHost(display, host) Display *display; XHostAddress *host; XAddHosts(display, hosts, num-hosts) Display *display; XHostAddress *host; int num-hosts; XHostAddress *XListHosts(display, nhosts-return, state-return) Display *display; int *nhosts-return; Bool *state-return; XRemoveHost(display, host) Display *display; XHostAddress *host; XRemoveHosts(display, hosts, num-hosts) Display *display; XHostAddress *host; int num-hosts; XSetAccessControl(display, mode) Display *display; int mode; XEnableAccessControl(display) Display *display; XDisableAccessControl(display) Display *display; DESCRIPTION The XAddHost function adds the specified host to the access control list for that display. The display must be on the same host as the client issuing the command, or a BadAccess error results. The XAddHosts function adds each specified host to the ac- cess control list for that display. The display must be on the same host as the client issuing the command, or a BadAc- cess error results. The XListHosts function returns the current access control list as well as whether the use of the list at connection November, 1990 1
XAddHost(3X) XAddHost(3X)setup was enabled or disabled. XListHosts allows a program to find out what machines can make connections. It returns a pointer to a list of host structures that were allocated by the function. When no longer needed, this memory should be freed by calling XFree. The XRemoveHost function removes the specified host from the access control list for that display. The display must be on the same host as the client process, or a BadAccess error results. If you remove your machine from the access list, you can no longer connect to that server. This operation cannot be reversed until you reset the server. The XRemoveHosts function removes each specified host from the access control list for that display. The display must be on the same host as the client process, or a BadAccess error results. If you remove your machine from the access list, you can no longer connect to that server. This opera- tion cannot be reversed until you reset the server. The XSetAccessControl function either enables or disables the use of the access control list at connection setups. The XEnableAccessControl function enables the use of the ac- cess control list at each connection setup. The XDisableAccessControl function disables the use of the access control list at each connection setup. Arguments These functions accept the following arguments: display Specifies the connection to the X server. host Specifies the network address of the host machine. hosts Specifies each host that is to be added or removed. mode Specifies whether you want to change the access con- trol. EnableAccess enables host access control, and DisableAccess disables host access control. nhosts-return Returns the number of hosts in the access control list. num-hosts Specifies the number of hosts. state-return Returns the state of access control (enabled or dis- abled). 2 November, 1990
XAddHost(3X) XAddHost(3X)Structures The XHostAddress structure is defined as follows. typedef struct { int family;/* for example FamilyInternet */ int length;/* length of address, in bytes */ char *address;/* pointer to where */ /* to find the address */ } XHostAddress; The family member specifies which protocol address family to use (for example, TCP/IP) and can be FamilyInternet or FamilyChaos. The length member specifies the length of the address in bytes. The address member specifies a pointer to the address. ERRORS BadAccess A client attempted to modify the access control list from other than the local (or otherwise authorized) host. BadValue Some numeric value falls outside the range of values accepted by the request. Unless a range is speci- fied for an argument, the full range defined by the argument's type is accepted. Any argument defined as a set of alternatives can generate this error. The XAddHost, XAddHosts, XRemoveHost, XRemoveHosts, and XSetAccessControl functions can generate BadAccess and BadValue errors. The XEnableAccessControl and XDisableAccessControl functions can generate a BadAccess error. SEE ALSO Xlib - C Language Interface November, 1990 3