Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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

Xlib - Host Access						   XAddHosts()

Vote for polarhome