Bucktooth: Installing Bucktooth on your platform
------------------------------------------------

Bucktooth, in its current form, is designed to be installed and run from
inetd. This means you don't need to boot a daemon, and it also means it
only runs when you need it to, and it also means it's small because inetd
does all the work for it. It also means you need access to your system's
inetd configuration files (usually /etc/inetd.conf and /etc/services),
and that usually means you have to be root.

Bucktooth also supports the very cool and much more useful xinetd clone.
If you want to use this instead and be one of the beautiful people, just
substitute xinetd and configure.xinetd for what follows. (Note: the
xinetd configure script is hardcoded to use /etc/xinetd.conf.)

Also, Bucktooth supports launchd through configure.launchd. This does not
require either file, and will generate property lists for you. Replace
configure with configure.launchd for the portion below.

To install, unpack your Bucktooth archive to a convenient directory (don't
delete it -- you'll need it later if you intend to do configuration changes)
and

	perl configure

in its install directory. Then follow the prompts.

The configure script will drop a transcript file, which you can use to
similarly configure any future versions of Bucktooth. Save this file (it's
usually called transcript.0.configure or some such). It will also drop a
completely configured executable, and if you have permission and the
desire, connect your inetd up to it (check your inetd.conf file to see that
it did it right). Remember to bounce your inetd so that it will start
services (send it a -HUP, usually).

Your new Bucktooth server should answer on the port you have selected. Enjoy.


.