chiark / gitweb /
debugging for thing that crashed
[innduct.git] / doc / man / ident.8
1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sh \" Subsection heading
6 .br
7 .if t .Sp
8 .ne 5
9 .PP
10 \fB\\$1\fR
11 .PP
12 ..
13 .de Sp \" Vertical space (when we can't use .PP)
14 .if t .sp .5v
15 .if n .sp
16 ..
17 .de Vb \" Begin verbatim text
18 .ft CW
19 .nf
20 .ne \\$1
21 ..
22 .de Ve \" End verbatim text
23 .ft R
24 .fi
25 ..
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<>.
32 .tr \(*W-
33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34 .ie n \{\
35 .    ds -- \(*W-
36 .    ds PI pi
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
39 .    ds L" ""
40 .    ds R" ""
41 .    ds C` ""
42 .    ds C' ""
43 'br\}
44 .el\{\
45 .    ds -- \|\(em\|
46 .    ds PI \(*p
47 .    ds L" ``
48 .    ds R" ''
49 'br\}
50 .\"
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.
55 .if \nF \{\
56 .    de IX
57 .    tm Index:\\$1\t\\n%\t"\\$2"
58 ..
59 .    nr % 0
60 .    rr F
61 .\}
62 .\"
63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
64 .\" way too many mistakes in technical documents.
65 .hy 0
66 .if n .na
67 .\"
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
71 .if n \{\
72 .    ds #H 0
73 .    ds #V .8m
74 .    ds #F .3m
75 .    ds #[ \f1
76 .    ds #] \fP
77 .\}
78 .if t \{\
79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80 .    ds #V .6m
81 .    ds #F 0
82 .    ds #[ \&
83 .    ds #] \&
84 .\}
85 .    \" simple accents for nroff and troff
86 .if n \{\
87 .    ds ' \&
88 .    ds ` \&
89 .    ds ^ \&
90 .    ds , \&
91 .    ds ~ ~
92 .    ds /
93 .\}
94 .if t \{\
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'
101 .\}
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 \
117 \{\
118 .    ds : e
119 .    ds 8 ss
120 .    ds o a
121 .    ds d- d\h'-1'\(ga
122 .    ds D- D\h'-1'\(hy
123 .    ds th \o'bp'
124 .    ds Th \o'LP'
125 .    ds ae ae
126 .    ds Ae AE
127 .\}
128 .rm #[ #] #H #V #F C
129 .\" ========================================================================
130 .\"
131 .IX Title "IDENT 8"
132 .TH IDENT 8 "2008-04-06" "INN 2.4.5" "InterNetNews Documentation"
133 .SH "NAME"
134 ident \- nnrpd ident resolver
135 .SH "SYNOPSIS"
136 .IX Header "SYNOPSIS"
137 \&\fBident\fR [\fB\-p\fR \fIport\fR] [\fB\-t\fR]
138 .SH "DESCRIPTION"
139 .IX Header "DESCRIPTION"
140 This program attempts to resolve usernames for \fBnnrpd\fR by using the
141 ident protocol to query the remote host.  It contacts the remote host
142 using either IPv4 or IPv6 depending on which protocol was used for the
143 incoming \s-1NNTP\s0 connection.
144 .SH "OPTIONS"
145 .IX Header "OPTIONS"
146 .IP "\fB\-p\fR \fIport\fR" 4
147 .IX Item "-p port"
148 If this option is given, attempt to contact identd on the specified
149 remote port (which can be a numeric or symbolic specification).
150 Non-numeric values will be looked up using \fIgetservbyname\fR\|(3).  The
151 default value is the result of \f(CW\*(C`getservbyname("ident")\*(C'\fR if available,
152 or port 113 otherwise.
153 .IP "\fB\-t\fR" 4
154 .IX Item "-t"
155 If this option is given, the identity returned will never have a domain
156 part.  That is, if the remote server returns a result containing an \f(CW\*(C`@\*(C'\fR
157 character, \fBident\fR truncates the response at the \f(CW\*(C`@\*(C'\fR.  This is useful
158 to allow the \fIdefault-domain\fR parameter in \fIreaers.conf\fR to override
159 the domain supplied by the remote host (particularly if the supplied
160 domain part is an unqualified local machine name rather than a full
161 domain name).
162 .SH "EXAMPLE"
163 .IX Header "EXAMPLE"
164 The following \fIreaders.conf\fR\|(5) fragment tells nnrpd to trust ident
165 information for hosts on a local network, but to replace the domain
166 returned from the ident query:
167 .PP
168 .Vb 5
169 \&    auth LAN {
170 \&        hosts: "192.168/16"
171 \&        res: "ident \-t"
172 \&        default\-domain: "internal.example.com"
173 \&    }
174 .Ve
175 .PP
176 .Vb 4
177 \&    access LAN {
178 \&        users: "*@internal.example.com"
179 \&        newsgroups: example.*
180 \&    }
181 .Ve
182 .PP
183 Access is granted to the example.* groups for all users on the local
184 network whose machines respond to ident queries.
185 .SH "HISTORY"
186 .IX Header "HISTORY"
187 This documentation was written by Jeffrey M. Vinocur <jeff@litech.org>.
188 .PP
189 $Id: ident.8 7880 2008-06-16 20:37:13Z iulius $
190 .SH "SEE ALSO"
191 .IX Header "SEE ALSO"
192 \&\fInnrpd\fR\|(8), \fIreaders.conf\fR\|(5)