home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / grafik / amiwin / x11 / man / xhost.man < prev    next >
Encoding:
Text File  |  1996-07-16  |  4.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XHOST(1)                 USER COMMANDS                   XHOST(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      xhost - server access control program for X
  10.  
  11. SYNOPSIS
  12.      xhost [[+-]name ...]
  13.  
  14. DESCRIPTION
  15.      The xhost program is used to add and delete  host  names  or
  16.      user  names to the list allowed to make connections to the X
  17.      server.  In the case of hosts, this provides  a  rudimentary
  18.      form of privacy control and security.  It is only sufficient
  19.      for a workstation (single  user)  environment,  although  it
  20.      does  limit  the  worst  abuses.  Environments which require
  21.      more sophisticated measures should implement the  user-based
  22.      mechanism or use the hooks in the protocol for passing other
  23.      authentication data to the server.
  24.  
  25. OPTIONS
  26.      Xhost accepts the following command line  options  described
  27.      below.  For security, the options that effect access control
  28.      may only be run from the "controlling host".   For  worksta-
  29.      tions, this is the same machine as the server.  For X termi-
  30.      nals, it is the login host.
  31.  
  32.      -help   Prints a usage message.
  33.  
  34.      [+]name The given name (the plus sign is optional) is  added
  35.              to the list allowed to connect to the X server.  The
  36.              name can be a host name or a user name.
  37.  
  38.      -name   The given name is removed from the list  of  allowed
  39.              to  connect  to  the server.  The name can be a host
  40.              name or a user name.  Existing connections  are  not
  41.              broken,  but new connection attempts will be denied.
  42.              Note that the  current  machine  is  allowed  to  be
  43.              removed;  however,  further  connections  (including
  44.              attempts to add it  back)  will  not  be  permitted.
  45.              Resetting  the  server (thereby breaking all connec-
  46.              tions) is the only way to  allow  local  connections
  47.              again.
  48.  
  49.      +       Access is granted to everyone, even if  they  aren't
  50.              on the list (i.e., access control is turned off).
  51.  
  52.      -       Access is restricted  to  only  those  on  the  list
  53.              (i.e., access control is turned on).
  54.  
  55.      nothing If no command line arguments are  given,  a  message
  56.              indicating   whether   or   not  access  control  is
  57.              currently enabled is printed, followed by  the  list
  58.              of  those  allowed  to  connect.   This  is the only
  59.              option that may be used from machines other than the
  60.  
  61.  
  62.  
  63. X Version 11         Last change: Release 6                     1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XHOST(1)                 USER COMMANDS                   XHOST(1)
  71.  
  72.  
  73.  
  74.              controlling host.
  75.  
  76. NAMES
  77.      A complete name has the  syntax  ``family:name''  where  the
  78.      families are as follows:
  79.  
  80.      inet      Internet host
  81.      dnet      DECnet host
  82.      nis       Secure RPC network name
  83.      krb       Kerberos V5 principal
  84.      local     contains only one name, the empty string
  85.  
  86.      The family is case insensitive.   The  format  of  the  name
  87.      varies with the family.
  88.  
  89.      When Secure RPC is being used, the network independent  net-
  90.      name  (e.g., "nis:unix.uid@domainname") can be specified, or
  91.      a local user can be specified with just the username  and  a
  92.      trailing at-sign (e.g., "nis:pat@").
  93.  
  94.      For backward compatibility with  pre-R6  xhost,  names  that
  95.      contain  an at-sign (@) are assumed to be in the nis family.
  96.      Otherwise the inet family is assumed.
  97.  
  98. DIAGNOSTICS
  99.      For each name added to the access control list,  a  line  of
  100.      the  form  "name  being  added  to  access  control list" is
  101.      printed.  For each name  removed  from  the  access  control
  102.      list,  a  line  of  the form "name being removed from access
  103.      control list" is printed.
  104.  
  105. FILES
  106.      /etc/X*.hosts
  107.  
  108. SEE ALSO
  109.      X(1), Xsecurity(1), Xserver(1), xdm(1)
  110.  
  111. ENVIRONMENT
  112.      DISPLAY to get the default host and display to use.
  113.  
  114. BUGS
  115.      You can't specify a display  on  the  command  line  because
  116.      -display  is  a valid command line argument (indicating that
  117.      you want to remove the machine named  ``display''  from  the
  118.      access list).
  119.  
  120.      The X server stores network addresses, not host names.  This
  121.      is not really a bug.  If somehow you change a host's network
  122.      address while the server is still  running,  xhost  must  be
  123.      used to add the new address and/or remove the old address.
  124.  
  125.  
  126.  
  127.  
  128.  
  129. X Version 11         Last change: Release 6                     2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XHOST(1)                 USER COMMANDS                   XHOST(1)
  137.  
  138.  
  139.  
  140. AUTHORS
  141.      Bob Scheifler, MIT Laboratory for Computer Science,
  142.      Jim Gettys, MIT Project Athena (DEC).
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. X Version 11         Last change: Release 6                     3
  196.  
  197.  
  198.  
  199.