cde/programs/dtlogin/config/Xaccess.src

   1 XCOMM #####################################################################
   2 XCOMM
   3 XCOMM   Xaccess
   4 XCOMM   Common Desktop Environment
   5 XCOMM
   6 XCOMM   (c) Copyright 1993, 1994 Hewlett-Packard Company
   7 XCOMM   (c) Copyright 1993, 1994 International Business Machines Corp.
   8 XCOMM   (c) Copyright 1993, 1994 Sun Microsystems, Inc.
   9 XCOMM   (c) Copyright 1993, 1994 Novell, Inc.
  10 XCOMM
  11 XCOMM       ************** DO NOT EDIT THIS FILE **************
  12 XCOMM
  13 XCOMM   CDE_INSTALLATION_TOP/config/Xaccess is a factory-default file and will
  14 XCOMM   be unconditionally overwritten upon subsequent installation.
  15 XCOMM   Before making changes to the file, copy it to the configuration
  16 XCOMM   directory, CDE_CONFIGURATION_TOP/config. You must also update the accessFile
  17 XCOMM   resource in CDE_CONFIGURATION_TOP/config/Xconfig.
  18 XCOMM
  19 XCOMM   $XConsortium: Xaccess.src /main/5 1996/04/23 11:42:01 drk $
  20 XCOMM
  21 XCOMM #####################################################################
  22 XCOMM
  23 XCOMM   This file contains a list of host names which are allowed or
  24 XCOMM   denied XDMCP connection access to this machine.  When a remote
  25 XCOMM   display (typically an X-termimal) requests login service, Dtlogin
  26 XCOMM   will consult this file to determine if service should be granted
  27 XCOMM   or denied.
  28 XCOMM
  29 XCOMM   # Access control file for XDMCP connections
  30 XCOMM
  31 XCOMM   To control Direct and Broadcast access:
  32 XCOMM
  33 XCOMM       pattern
  34 XCOMM
  35 XCOMM   To control Indirect queries:
  36 XCOMM
  37 XCOMM       pattern         list of hostnames and/or macros ...
  38 XCOMM
  39 XCOMM   To use the chooser:
  40 XCOMM
  41 XCOMM       pattern         CHOOSER BROADCAST
  42 XCOMM
  43 XCOMM   or
  44 XCOMM
  45 XCOMM       pattern         CHOOSER list of hostnames and/or macros ...
  46 XCOMM
  47 XCOMM   To define macros:
  48 XCOMM
  49 XCOMM       %name           list of hosts ...
  50 XCOMM
  51 XCOMM
  52 XCOMM   The first form tells dtlogin which displays to respond to itself.
  53 XCOMM   The second form tells dtlogin to forward indirect queries from hosts
  54 XCOMM     matching the specified pattern to the indicated list of hosts.
  55 XCOMM   The third form tells dtlogin to handle indirect queries using the
  56 XCOMM     chooser; the chooser is directed to send its own queries out via the
  57 XCOMM     broadcast address and display the results on the terminal.
  58 XCOMM   The fourth form is similar to the third, except instead of using the
  59 XCOMM     broadcast address, it sends DirectQuerys to each of the hosts in
  60 XCOMM     the list
  61 XCOMM
  62 XCOMM   In all cases, dtlogin uses the first entry which matches the terminal;
  63 XCOMM   for IndirectQuery messages only entries with right hand sides can
  64 XCOMM   match, for Direct and Broadcast Query messages, only entries without
  65 XCOMM   right hand sides can match.
  66 XCOMM
  67 XCOMM   Information regarding the format of entries in this file is
  68 XCOMM   included at the end of the file.
  69 XCOMM
  70 XCOMM #####################################################################
  71
  72 XCOMM   Entries...
  73
  74 *                       # grant service to all remote displays
  75
  76 XCOMM
  77 XCOMM The nicest way to run the chooser is to just ask it to broadcast
  78 XCOMM requests to the network - that way new hosts show up automatically.
  79 XCOMM Sometimes, however, the chooser can't figure out how to broadcast,
  80 XCOMM so this may not work in all environments.
  81 XCOMM
  82
  83 *               CHOOSER BROADCAST       # any indirect host can get a chooser
  84
  85 XCOMM
  86 XCOMM If you'd prefer to configure the set of hosts each terminal sees,
  87 XCOMM then just uncomment these lines (and comment the CHOOSER line above)
  88 XCOMM and edit the %hostlist line as appropriate
  89 XCOMM
  90
  91 XCOMM %hostlist      host-a host-b
  92
  93 XCOMM *              CHOOSER %hostlist       #
  94
  95
  96
  97 XCOMM #####################################################################
  98 XCOMM
  99 XCOMM                      ENTRY FORMAT
 100 XCOMM
 101 XCOMM   An entry in this file is either a host name or a pattern.  A
 102 XCOMM   pattern may contain one or more meta characters (`*' matches any
 103 XCOMM   sequence of 0 or more characters, and `?'  matches any single
 104 XCOMM   character) which are compared against the host name of the remote
 105 XCOMM   device requesting service.
 106 XCOMM
 107 XCOMM   If the entry is a host name, all comparisons are done using
 108 XCOMM   network addresses, so any name which converts to the correct
 109 XCOMM   network address may be used.  For patterns, only canonical host
 110 XCOMM   names are used in the comparison, so do not attempt to match
 111 XCOMM   aliases.
 112 XCOMM
 113 XCOMM   Preceding either a host name or a pattern with a `!'  character
 114 XCOMM   causes hosts which match that entry to be excluded.
 115 XCOMM
 116 XCOMM   When checking access for a particular display host, each entry is
 117 XCOMM   scanned in turn and the first matching entry determines the
 118 XCOMM   response.
 119 XCOMM
 120 XCOMM   Blank lines are ignored, `#' is treated as a comment delimiter
 121 XCOMM   causing the rest of that line to be ignored,
 122 XCOMM
 123 XCOMM   ex.
 124 XCOMM   !xtra.lcs.mit.edu  # disallow direct/broadcast service for xtra
 125 XCOMM   bambi.ogi.edu      # allow access from this particular display
 126 XCOMM   *.lcs.mit.edu      # allow access from any display in LCS