XAddHost(3X) — X Version 11

NAME

XAddHost, XAddHosts, XListHosts, XRemoveHost, XRemoveHosts, XSetAccessControl, XEnableAccessControl, XDisableAccessContro − control host access

SYNTAX

XAddHost(display, host)
Display ∗display;
XHostAddress ∗host;

XAddHosts(display, hosts, num_hosts)
      Display ∗display;
      XHostAddress ∗hosts;
      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 ∗hosts;
      int num_hosts;

XSetAccessControl(display, mode)
Display ∗display;
int mode;

XEnableAccessControl(display)
Display ∗display;

XDisableAccessControl(display)
Display ∗display;

ARGUMENTS

displaySpecifies the connection to the X server.

modeSpecifies whether you want to change the access control to enable or disable. EnableAccess enables host access control or DisableAccess disables host access control.

hostSpecifies the network address of the host machine.

hostsSpecifies each host that is to be added.

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

num_hostsSpecifies the number of hosts.

state_returnReturns the state of the access control (enabled or disabled).

DESCRIPTION

The XAddHost function adds the specified host to the access control list for that display. The display hardware must be on the same host as the program issuing the command.

The XAddHosts function adds each specified host to the access control list for that display. The display hardware must be on the same host as the program issuing the command.

The XListHosts function returns the current access control list as well as whether the use of the list at connection setup was enabled or disabled.

The XRemoveHost function removes the specified host from the access control list for that display. The display hardware must be on the same host as the client process.

The XRemoveHosts function removes each specified host from the access control list for that display. The display hardware must be on the same host as the client process.

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 access control list at connection setups.

The XDisableAccessControl function disables the use of the access control list at connection setups.

.PN XAddHost , .PN XAddHosts , .PN XRemoveHost , and .PN XRemoveHosts can generate BadAlloc and BadValue errors.

.PN XSetAccessControl can generate

BadAlloc and BadValue errors.

.PN XEnableAccessControl and .PN XDisableAccessControl can generate a BadAccess error.

DIAGNOSTICS

BadAccess A client attempted to modify the access control list from other than the local (or otherwise authorized) host.

BadAlloc The server failed to allocate the requested resource or server memory.

BadValue Some numeric value falls outside the range of values accepted by the request. Unless a specific range is specified 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.