# Bisqwit's identd

## 0. Contents

This is the documentation of bidentd-1.1.4.

## 1. Purpose

ident daemon for unix systems, implementing rfc1413 defined behaviour.
There is also a Debian package available, coordinated by Wesley W. Terpstra.
The package for your architechture can be downloaded from any official Debian mirror.

## 2. Why another identd daemon?

Because there is no other (wasn't in 2000 at least) which worked correctly over multiple NATs.
The program works like an ident daemon is supposed to work. It allows people to query who's connecting in which port. Masquerading is supported, and works recursively. Works only under Linux, due to the use of /proc filesystem.
My typical case (why I made this):

- Alpha has the internet connection. It has an ip in internet.
- Beta is masqueraded by Alpha.
- Gamma is masqueraded by Beta.
- Somebody in Gamma starts irc, and the irc server (in internet) gets the username of the user in Gamma, correctly.

All computers in the identd masquerading chain must be running bidentd, except the end part, which can be using any identd daemon, as long as that one does not care about the source ip address.

## 3. Notes

Version 1.0.8 and prior worked only on the 2.2 -series of the Linux kernel, but 1.0.9 supports 2.4 too.
Since 1.1.0, kernel family 2.6 is supported too.

## 4. Version history

    Tue 2010-04-29 09:17 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.1.4

    	    - Integrated Thibaut Varčne's patch fixing a forwarding-looping bug.

    Tue 2009-10-20 10:05 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.1.3

    	    - Integrated Wesley W.Terpstra's patch fixing compilation.

    Wed 2009-03-18 11:20 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.1.2.1

    	    - A maintenance update that does change functionality.

    Mon 2007-04-02 19:38 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.1.2

    	    - Fixed a reported compilation error on GCC 4.3.

    Sat 2005-05-13 13:35 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.1.1

    	    - Removed the rfc file from archive to make the life easier
    	      for the Debian politics.

    Mon 2005-03-14 21:15 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.1.0

    	    - Integrated Wesley W. Terpstra's patch for kernel 2.6-support.
    	    - Integrated Wesley W. Terpstra's patch for root privilege
    	      separation.

    Thu 2003-02-13 15:06 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.10

    	    - Fixed minor masquerading bugs: ^M and space were
    	      cumulated in the reply for each masquerading chain.
    	    - Fixed syslog: ^M was superfluously added to every message.

    Tue 2002-05-14 19:33 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.9.1

    	    - Updated the document generating mechanism.

    Sun 2002-05-01 18:59 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.9

    	    - Applied Wesley W. Terpstra's patch for kernel 2.4-support.
    	    - Updated the documentation about Debian support.

    Sun 2001-10-04 22:50 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.8

    	    - Updated the documentation.

    Sun 2001-07-14 18:27 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.7

    	    - Some minor changes to get this to compile with gcc-3.0.

    Sun 2000-11-01 23:35 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.6

    	    - Updated the documentation.

    Sun 2000-10-28 12:53 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.5

    	    - Changed ll_normal to ll_verbose somewhere in main.cc

    Mon 2000-10-23 23:37 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.4

    	    - Applied gaia's patch
    	    - Rewrote argv handling
    	    - Updated the manual page

    Mon 2000-10-23 23:00 Antti-Juhani Kaijanaho <gaia@iki.fi>

    	* Unreleased patch

    	    - Added logging support.

    	    - Fixed identd recommendation (nowait, not wait)

    Wed 2000-10-18 20:43 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.3

    	    - Renamed the package to bidentd, for
    	      convenience. It was identd previously.

    Wed 2000-10-18 14:33 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.2

    	    - Reindented the sourcecode.

    Wed 2000-10-18 02:56 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.1

    	    - Whoap. I accidentally installed it
    	      as inetd and wiped my inetd out.
    	    - This version should be working, and supports
    	      masquerading. It works even through chains
    	      of masquerades - multiple masquerades. Fetching
    	      recursively the identd from remote hosts. :)

    Thu 2000-10-17 18:38 Joel Yliluoma <joel.yliluoma@iki.fi>

    	* Version 1.0.0

    	    - Initial version
    	    - Does actually nothing.

## 5. Copying

bidentd has been written by Joel Yliluoma, and is distributed under the terms of the General Public License (GPL).

## 6. Requirements

GNU make is probably required.

## 7. Installation

> make install (as root)
> make startup (Follow the instructions)

## 8. Uninstallation

> make uninstall
> Edit /etc/inetd.conf

## 9. Updating from possible previous version

> make update

## 10. Compilation only.

> make

## 11. Downloading

The official home page of bidentd is at http://iki.fi/bisqwit/source/bidentd.html.
Check there for new versions.

Additionally, the most recent source code (bleeding edge) for bidentd can also be downloaded by cloning the Git repository by:

- `git clone git://bisqwit.iki.fi/bidentd.git`
- `git checkout origin/release -b release`
- `git checkout origin/master -b master`

Generated from `progdesc.php` (last updated: Thu, 29 Apr 2010 17:33:56 +0300)
with `docmaker.php` (last updated: Thu, 29 Apr 2010 17:33:56 +0300)
at Thu, 29 Apr 2010 17:33:56 +0300