xremovehosb(3) [hpux man page]

XRemoveHosts()															    XRemoveHosts()

Name
  XRemoveHosts - remove multiple hosts from the access control list.

Synopsis
  XRemoveHosts(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 the list of hosts that are to be removed.

  num_hosts Specifies 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 sig-
  nificant six bits of the byte.

  For more information on access control lists, 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;

     /* constants used for family member of XHostAddress */
     #define FamilyInternet	 0
     #define FamilyDECnet	 1
     #define FamilyChaos	 2

Errors
  BadAccess
  BadValue

See Also
  XAddHost(), XAddHosts(), XDisableAccessControl(), XEnableAccessControl(), XListHosts(), XRemoveHost(), XSetAccessControl().

Xlib - Host Access														    XRemoveHosts()

XAddHosts()															       XAddHosts()

Name
  XAddHosts - 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.

Description
  XAddHosts()  adds  each specified host to the access control list for the server specified by display.  The access control list is a primi-
  tive 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 display.

  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 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 sig-
  nificant 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 Also
  XAddHost(), XDisableAccessControl(), XEnableAccessControl(), XListHosts(), XRemoveHost(), XRemoveHosts(), XSetAccessControl().

Xlib - Host Access														       XAddHosts()