  		     Murple's BSD Talk Daemon v1.4.3
           A talkd daemon with sound and answering machine built-in.

FEATURES
--------
* FLASH BOMB AWARE
This version of the BSD talkd suppresses VT100 (flash) bombs.  The user
being bombed won't even see it.  Warning messages will be written to the
syslog telling who the bomb was directed at and the host address specified
in the talk packet.  Since this can be faked, it is labelled 'apparently
from'.  You can match the PID of the talkd with the PID of the entry made
by tcpd to get the real hostname.

* SOUND FILE PLAYED
The option to have a sound file played when you receive a talk request,
rather than just a beep, has been added. The included sound file is the
sound of a telephone ringing. You may of course also choose just to use
the annoying ^G beep if you don't have sound capabilities.
A new feature in 1.4.2 is a configuration option which only play the ring sound
if the user is listed as being logged in to a particular tty, like the console. 

* ANSWERING MACHINE
An answering machine, derived from the 'talk' client, allows the caller
to leave a message, which will be mailed to the callee, by connecting 
automatically if the callee doesn't respond with the answering machine.
The machine displays an invite, and the callee can enter its message
and then close the connection as usual.

* SEND REQUESTS TO ONE CONSOLE
The second new feature in 1.4.2 makes talkd prefer one particular tty, like
the console, over all others for printing an announcement banner.  As long
as the user specified is listed as logged in on that tty, and write
permissions are enabled, the message will be sent only to that console.

Combining the two 'console' features can have very desirable effects.  If I am
logged in under X on my system's console and a user somewhere tries to talk
to me, I will not only hear a ring, but the announcement banner will appear
very neatly within my xconsole.  Likewise, if other users logged in to my
computer from other locations receive a talk, the talk daemon will not
arbitrarily play the ring sound on my console, it will beep on their
session.  Neat hun?

INSTALLATION
------------
You must be root to install this. Duh!

First of all, run "configure". (Actually, this is only needed on a bsd system.)

Then, you must edit the config.h and MCONFIG:

In config.h, you will set the defaults for the sound options. The default
is to use the "play" command to play the file "/usr/sounds/talk.wav".
This config file also deals with langage choice : currently, french and
english are pre-formatted, but any announcement can be set.
Also check in config.h whether you want to enable the CONSOLE* options,
(e.g. if you're never running X, you probably don't want it), and the
SOUND* options (unset if no sound is possible on your machine !)

The MCONFIG has various compiler options you need to set. The defaults
will work on Linux systems. You also need to make sure the paths are
correct, and that they agree with the paths set in config.h. The default
path for the daemon is "/usr/sbin/in.talkd", for the soundfile is
"/usr/sounds/talk.wav", and for the man page "/usr/man/man8".

Any user can set its own message left by the answering machine when he is
away. To achieve this, any user must create a ~/.talkdrc
An example for this file is given in the source distribution.


Once everything is configured, all you need to do is type "make install"
and everything will compile and install. Try talking to yourself to
test it.

CHANGES and CREDITS
---------------------
 1.0.0 : (1983) BSD 4.3 talk daemon. Regents of the University of California.
 
 Crypt Keeper (ckeeper@iac.net) 1995
 1.1.0 : vt100 flash.
 
 Craig Schenk (murple@erols.com)
 1.2.0 : wave playing added, Makefile, man and this doc rewritten. 
 
 Daniel Barlow (dan_b@io.com), Feb 10 1995
 1.2.1 : searches utmp file for active tty to display talk request to.

 David Faure <david.faure@ifhamy.insa-lyon.fr>, Sat Mar 22 14:17:02  1997
 1.2.2 : french option, adress of caller ommitted if same than callee
 1.2.3 : wave playing improved
 1.3.0 : Header files and configure created
 1.4.0 : Answering machine added (directory answmach)
 1.4.1 : configure deleted (not needed at the moment)

 David M Dandar <ddandar@technet.tjhsst.edu>, Sat Apr  5 20:02:42 EST 1997 
 1.4.2 : console features added 

 David Faure <david.faure@ifhamy.insa-lyon.fr>, Tue Apr  8 01:39:57  1997
 1.4.3 : ~/.talkd.message is now read to display message.
            (Idea from Steven D. Rutter <che@umbc.edu>)
	 Mailed message has now 'Reply-To' set. (sendmail used instead of mail)
	    (Idea from Sho Nakagama <nakagama@email.njin.net>)

 1.4.4 : Possibility to configure the delay before the answering machine starts
	 Config file changed to ~/.talkdrc, subject option added. 
	 Back to BSD compatibility (not working at the moment).

ACTUAL MAINTAINER OF THE SOURCE
-------------------------------

David Faure <david.faure@ifhamy.insa-lyon.fr>

TESTED PLATFORMS : LINUX/BSD
----------------------------

This talkd has been tested on several Linux platforms all around the world,
including mine (Linux 2.0.29).
It has also be tested (and corrected in 1.4.3.) under FreeBSD 2.2.1.
Please tell me if it compiles and runs under other OSes, including
other BSDs.

COMPLICATIONS with CONSOLE options
----------------------------------
Not all systems log console logins as being associated with one particular
name, like "console".  In addition, those that run X windows often "log"
users in and out of the console with a simple program called sessreg that
edits the utmp file.  Most sessreg programs, however, don't associate a PID
with the session.  This causes some versions of init to remove what it
believes to be a bogus session from the utmp file.  If you have this
problem, then you need a version of sessreg which allows you to set the PID
field in the utmp file.  Some time ago I modified a stock sessreg program to
have this capability, but have since lost the source.  In my case, I
modified my XDM login script which runs the sessreg program to pass the
$PPID variable to sessreg.  This ends up being the process ID of the
session's xdm, which exits when the user logs out anyway.
David M Dandar <ddandar@technet.tjhsst.edu>

MANDATORY LEGAL SHIT
--------------------
Copyright (c) 1983 Regents of the University of California.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software
   must display the following acknowledgement:
     This product includes software developed by the University of
     California, Berkeley and its contributors.
4. Neither the name of the University nor the names of its contributors
   may be used to endorse or promote products derived from this software
   without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE. FOR THIS VERSION, "THE CONTRIBUTORS" SHALL ALSO INCLUDE
CRAIG SCHENK, CRYPT KEEPER, DAVID FAURE, AND DAVID M DANDAR.

