"Fossies" - the Fresh Open Source Software Archive 
As a special service "Fossies" has tried to format the requested text file into HTML format (style:
standard) with prefixed line numbers.
Alternatively you can here
view or
download the uninterpreted source code file.
1
2 Seek to the section ``INSTALLATION'' if you want the quickie.
3
4
5 PROJECT OVERVIEW
6
7 I started ident2 awhile ago for several reasons.
8 A: I needed something to do.
9 B: I wanted to make my reply something other than my
10 generic UNIX username, for IRC chaos, I guess.
11 C: I needed the practice.
12 D: I wanted to contribute to the community!
13
14 I've since grown weary of meddling with this server. After the
15 second rewrite between a feature incorporation blitz and a
16 minimalization streak, I've decided to move on. I'll still add
17 bug fixes and address any security concerns, however.
18
19 TERMS OF USE
20
21 Ident2 is provided under the GNU General Public License.
22 This license can be viewed in the included 'COPYING' file or
23 found at http://www.gnu.org/
24
25
26 PLANNED PORTS
27
28 I am very much in favor of porting this server. I have hopefully
29 complied with POSIX well enough to make it reasonably simple.
30 Writing ports should be a no brainer as far as writing actual code
31 goes. The only parts that need implementing are the three m_*
32 functions listed in the MACHINE section in ident2.h
33
34 Ident2 was developed under Linux and has been ported to FreeBSD.
35
36 Also, I'm temporarily using snprintf as a security precaution.
37 This is not portable. I will fix this when I come to an OS
38 that does not implement snprintf.
39
40
41 PORT NOTES
42
43 The FreeBSD port will probably only compile under FreeBSD 3.x and up.
44 The Linux version was tested only on 2.2.x
45
46
47 CONTRIBUTIONS
48
49 Hans Chr. Saustrup, Aarhus, Denmark
50 hc@saustrup.dk / neurox [#danmark/ircnet]
51 fixing lots of my silly bugs.
52
53 Alexander Reelsen <ar@rhwd.net>
54 Working with me to get it included in
55 the Debian Project.
56
57 Ilya Novoselov <nullguid@t72.ru>
58 For fixing and reporting a bug in m_get_uid() under FreeBSD
59 (how embarassing)
60
61 GETTING
62
63 http://m.bacarella.com/
64
65
66 INSTALLATION
67
68 Check define.h first for things you might be interested in toggling.
69
70 ./configure
71 make
72 make install
73
74 If the script fails, your system is probably not supported or
75 you have a buggered install. I could've also screwed up.
76 If you think it's MY fault, e-mail me.
77 (seek to the section CONTACT, below)
78
79 The server should install to /usr/local/sbin/ident2
80
81 Start the server from the command line (as root), or
82 go right ahead and add it to /etc/inetd.conf if you're too
83 cool for your own good. If you have no idea how to do this,
84 please read the man page. ``man inetd.conf'' works nicely.
85 Here is what you might use:
86
87 auth stream tcp nowait root /usr/local/sbin/ident2 ident2
88
89 Yes, these fields are deliciously tab seperated.
90 If inetd.conf has no idea what 'auth' is, make sure
91 it appears in /etc/services. If not, well, you're going
92 to learn how to do two new things today.
93
94 Feel free to also spawn ident2 with tcp wrappers. It shouldn't mind.
95
96 If you're sick of the damned thing, you can uninstall it by
97 doing:
98 make uninstall
99
100 Be sure to remove it from inetd.conf if necessary.
101
102 COMMAND LINE PARAMETERS
103
104 Ident2 supports "standard" command line parameters as well
105 as the GNU long command-line options. ident2 will provide
106 a list of command line parameters if you invoke it with --help
107
108 IP MASQUERADING NOTES
109
110 IP Masquerading support was removed. I do not feel that I can
111 implement it without disgustifying my code, but furthermore, I
112 don't have the time/patience to make it work.
113
114 You can essentially achieve the same results by telling ident2
115 to simply send random replies to all requests.
116
117 CONFIGURING REPLIES
118
119 By default, without any command line options,
120 ident2 should be fully usable in production environments
121 that require user accountability. Divergence from the RFC
122 is only achieved by command line parameters that tell it
123 to do so.
124
125 In short, if you're looking for a drop in replacement,
126 just start ident2 from the command line (as root) with
127 nothing else.
128
129 If you're wondering how to set your own ident replies,
130 merely create a file .ident in your home directory and
131 do the following:
132 echo 'ident spanky' > ~/.ident
133
134 Start ident2 with the '-i' option. You may of course, replace
135 'spanky' with whatever your preffered ident reply might be.
136
137 Also note. If a user has the file ``.noident'' in their directory,
138 replies will be disabled. You must start the server with '-n' if
139 you want this feature.
140
141 MODES OF OPERATION
142
143 Ident2 has two modes of operation. inetd child, or
144 standalone daemon. The inetd child itself, never forks.
145 The daemon fork()s on every accepted connection.
146
147 Whatever the mode, execution must trickle down to the nexus
148 if anything useful is supposed to happen. The function nexus()
149 is basically where the logic occurs and the reply is decided on
150 and dispatched.
151
152 CONTACT
153
154 Michael Bacarella <mbac@netgraft.com>
155 http://m.bacarella.com/
156 http://netgraft.com/
157
158 MISC. COMMENTS
159
160 As the GNU GPL says, this code is provided without warranty.
161
162 Michael Bacarella II - mbac@netgraft.com
163 11/02/03 - 16:23PM - New York.
164