usr/src/man/man1m/tcpdmatch.1m

   1 '\" t
   2 .\"
   3 .\" Modified for Solaris to to add the Solaris stability classification,
   4 .\" and to add a note about source availability.
   5 .\"
   6 .TH TCPDMATCH 1M "Sep 15, 2011"
   7 .SH NAME
   8 tcpdmatch \- tcp wrapper oracle
   9 .SH SYNOPSYS
  10 tcpdmatch [-d] [-i inet_conf] daemon client
  11 .sp
  12 tcpdmatch [-d] [-i inet_conf] daemon[@server] [user@]client
  13 .SH DESCRIPTION
  14 .PP
  15 \fItcpdmatch\fR predicts how the tcp wrapper would handle a specific
  16 request for service.  Examples are given below.
  17 .PP
  18 The program examines the \fItcpd\fR access control tables (default
  19 \fI/etc/hosts.allow\fR and \fI/etc/hosts.deny\fR) and prints its
  20 conclusion.  For maximal accuracy, it extracts additional information
  21 from your \fIinetd\fR  network configuration file.
  22 .PP
  23 When \fItcpdmatch\fR finds a match in the access control tables, it
  24 identifies the matched rule. In addition, it displays the optional
  25 shell commands or options in a pretty-printed format; this makes it
  26 easier for you to spot any discrepancies between what you want and what
  27 the program understands.
  28 .SH ARGUMENTS
  29 The following two arguments are always required:
  30 .IP daemon
  31 A daemon process name. Typically, the last component of a daemon
  32 executable pathname.
  33 .IP client
  34 A host name or network address, or one of the `unknown' or `paranoid'
  35 wildcard patterns.
  36 .sp
  37 When a client host name is specified, \fItcpdmatch\fR gives a
  38 prediction for each address listed for that client.
  39 .sp
  40 When a client address is specified, \fItcpdmatch\fR predicts what
  41 \fItcpd\fR would do when client name lookup fails.
  42 .PP
  43 Optional information specified with the \fIdaemon@server\fR form:
  44 .IP server
  45 A host name or network address, or one of the `unknown' or `paranoid'
  46 wildcard patterns. The default server name is `unknown'.
  47 .PP
  48 Optional information specified with the \fIuser@client\fR form:
  49 .IP user
  50 A client user identifier. Typically, a login name or a numeric userid.
  51 The default user name is `unknown'.
  52 .SH OPTIONS
  53 .IP -d
  54 Examine \fIhosts.allow\fR and \fIhosts.deny\fR files in the current
  55 directory instead of the default ones.
  56 .IP "-i inet_conf"
  57 Specify this option when \fItcpdmatch\fR is unable to find your
  58 \fIinetd.conf\fR network configuration file, or when
  59 you suspect that the program uses the wrong one.
  60 .SH EXAMPLES
  61 To predict how \fItcpd\fR would handle a telnet request from the local
  62 system:
  63 .sp
  64 tcpdmatch in.telnetd localhost
  65 .PP
  66 The same request, pretending that hostname lookup failed:
  67 .sp
  68 tcpdmatch in.telnetd 127.0.0.1
  69 .PP
  70 To predict what tcpd would do when the client name does not match the
  71 client address:
  72 .sp
  73 tcpdmatch in.telnetd paranoid
  74 .PP
  75 On some systems, daemon names have no `in.' prefix, or \fItcpdmatch\fR
  76 may need some help to locate the inetd configuration file.
  77 .SH FILES
  78 .PP
  79 The default locations of the \fItcpd\fR access control tables are:
  80 .PP
  81 /etc/hosts.allow
  82 .br
  83 /etc/hosts.deny
  84 .SH SEE ALSO
  85 .na
  86 .nf
  87 tcpdchk(1M), tcpd configuration checker
  88 hosts_access(4), format of the tcpd access control tables.
  89 hosts_options(4), format of the language extensions.
  90 inetd.conf(4), format of the inetd control file.
  91 inetd(1M), how to invoke tcpd from inetd using the libwrap library.
  92 inetadm(1M), managing inetd services in the Service Management Framework.
  93
  94 .SH AUTHORS
  95 .na
  96 Wietse Venema (wietse@wzv.win.tue.nl),
  97 Department of Mathematics and Computing Science,
  98 Eindhoven University of Technology
  99 Den Dolech 2, P.O. Box 513,
 100 5600 MB Eindhoven, The Netherlands
 101 \" @(#) tcpdmatch.8 1.5 96/02/11 17:01:35
 102 .\" Begin Sun update
 103 .SH ATTRIBUTES
 104 See
 105 .BR attributes (5)
 106 for descriptions of the following attributes:
 107 .sp
 108 .TS
 109 box;
 110 c | c
 111 l | l .
 112 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 113 =
 114 Interface Stability     Committed
 115 .TE
 116 .\" End Sun update