"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
the uninterpreted source code file.
2 Seek to the section ``INSTALLATION'' if you want the quickie.
5 PROJECT OVERVIEW
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!
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.
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/
26 PLANNED PORTS
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
34 Ident2 was developed under Linux and has been ported to FreeBSD.
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.
41 PORT NOTES
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
49 Hans Chr. Saustrup, Aarhus, Denmark
50 firstname.lastname@example.org / neurox [#danmark/ircnet]
51 fixing lots of my silly bugs.
53 Alexander Reelsen <email@example.com>
54 Working with me to get it included in
55 the Debian Project.
57 Ilya Novoselov <firstname.lastname@example.org>
58 For fixing and reporting a bug in m_get_uid() under FreeBSD
59 (how embarassing)
68 Check define.h first for things you might be interested in toggling.
72 make install
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)
79 The server should install to /usr/local/sbin/ident2
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:
87 auth stream tcp nowait root /usr/local/sbin/ident2 ident2
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.
94 Feel free to also spawn ident2 with tcp wrappers. It shouldn't mind.
96 If you're sick of the damned thing, you can uninstall it by
98 make uninstall
100 Be sure to remove it from inetd.conf if necessary.
102 COMMAND LINE PARAMETERS
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
108 IP MASQUERADING NOTES
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.
114 You can essentially achieve the same results by telling ident2
115 to simply send random replies to all requests.
117 CONFIGURING REPLIES
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.
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.
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
134 Start ident2 with the '-i' option. You may of course, replace
135 'spanky' with whatever your preffered ident reply might be.
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.
141 MODES OF OPERATION
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.
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.
154 Michael Bacarella <email@example.com>
158 MISC. COMMENTS
160 As the GNU GPL says, this code is provided without warranty.
162 Michael Bacarella II - firstname.lastname@example.org
163 11/02/03 - 16:23PM - New York.