1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
4 .\" ========================================================================
5 .de Sh \" Subsection heading
13 .de Sp \" Vertical space (when we can't use .PP)
17 .de Vb \" Begin verbatim text
22 .de Ve \" End verbatim text
26 .\" Set up some character translations and predefined strings. \*(-- will
27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
29 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
30 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
31 .\" nothing in troff, for use with C<>.
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
37 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
51 .\" If the F register is turned on, we'll generate index entries on stderr for
52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53 .\" entries marked with X<> in POD. Of course, you'll have to process the
54 .\" output yourself in some meaningful fashion.
57 . tm Index:\\$1\t\\n%\t"\\$2"
63 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69 .\" Fear. Run. Save yourself. No user-serviceable parts.
70 . \" fudge factors for nroff and troff
79 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
85 . \" simple accents for nroff and troff
95 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
102 . \" troff and (daisy-wheel) nroff accents
103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110 .ds ae a\h'-(\w'a'u*4/10)'e
111 .ds Ae A\h'-(\w'A'u*4/10)'E
112 . \" corrections for vroff
113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115 . \" for low resolution devices (crt and lpr)
116 .if \n(.H>23 .if \n(.V>19 \
129 .\" ========================================================================
132 .TH DOMAIN 8 "2008-04-06" "INN 2.4.5" "InterNetNews Documentation"
134 domain \- nnrpd domain resolver
136 .IX Header "SYNOPSIS"
137 \&\fBdomain\fR \fBdomainname\fR
139 .IX Header "DESCRIPTION"
140 This program can be used in \fIreaders.conf\fR to grant access based on the
141 subdomain part of the remote hostname. In particular, it only returns
142 success if the remote hostname ends in \fBdomainname\fR. (A leading dot on
143 \&\fBdomainname\fR is optional; even without it, the argument must match on
144 dot-separated boundaries). The \*(L"username\*(R" returned is whatever initial
145 part of the remote hostname remains after \fBdomainname\fR is removed. It
146 is an error if there is no initial part (that is, if the remote hostname
147 is \fIexactly\fR the specified \fBdomainname\fR).
150 The following \fIreaders.conf\fR\|(5) fragment grants access to hosts with
151 internal domain names:
155 \& res: "domain .internal"
156 \& default\-domain: "example.com"
162 \& users: "*@example.com"
163 \& newsgroups: example.*
167 Access is granted to the example.* groups for all connections from hosts
168 that resolve to hostnames ending in \f(CW\*(C`.internal\*(C'\fR; a connection from
169 \&\*(L"foo.internal\*(R" would match access groups as \*(L"foo@example.com\*(R".
172 It seems the code does not confirm that the matching part is actually at
173 the end of the remote hostname (e.g., \*(L"domain: example.com\*(R" would match
174 the remote host \*(L"foo.example.com.org\*(R" by ignoring the trailing \*(L".org\*(R"
177 Does this resolver actually provide any useful functionality not
178 available by using wildcards in the \fIreaders.conf\fR\|(5) \fIhosts\fR parameter?
179 If so, the example above should reflect this functionality.
182 This documentation was written by Jeffrey M. Vinocur <jeff@litech.org>.
184 $Id: domain.8 7880 2008-06-16 20:37:13Z iulius $
186 .IX Header "SEE ALSO"
187 \&\fInnrpd\fR\|(8), \fIreaders.conf\fR\|(5)