~ubuntu-branches/ubuntu/hardy/tcp-wrappers/hardy

« back to all changes in this revision

Viewing changes to tcpdmatch.8

  • Committer: Bazaar Package Importer
  • Author(s): Anthony Towns
  • Date: 2001-11-18 00:24:50 UTC
  • Revision ID: james.westby@ubuntu.com-20011118002450-ur5lm4v87gx5oa6p
Tags: upstream-7.6
ImportĀ upstreamĀ versionĀ 7.6

Show diffs side-by-side

added added

removed removed

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