libut                                                  
A server development library                               
Copyright (c) 2003-2005 Troy Hanson
All rights reserved.

http://libut.sourceforge.net

This is BSD-licensed open source software. See the LICENSE file.
 
PLATFORMS
---------
Libut has been built on Linux, Solaris, OpenBSD, and Mac OSX.

BUILDING THE UT LIBRARY
------------------------
Untar the distribution and cd into its top-level directory. Then,
    ./configure
    make
    make install

The ./configure script takes a number of options, such as 
--prefix=/path/to/install. Run ./configure --help for more information.

The "make install" step is optional. This installs header files, the compiled
library (libut.a) and the manual pages in standard locations
(/usr/local/include, /usr/local/lib, and /usr/local/man). Running ./configure
with the --prefix option changes the installation root directory.

TRY OUT THE UT LIBRARY
------------------------
If the build completed successfully, you can run the test application now.
    tests/idle/idle

You should see log messages appear. Now, from another window you can connect
to the control port: 
    telnet localhost 4445

You need to specify localhost (or 127.0.0.1) rather than the hostname
in the telnet command as shown. That's because the control port is not
visible to the network, but only to the host itself.

Once connected to the control port, you can run commands like these:
    help
    mem
    tmr
    fds
    var
    exit

When you're done, type CTRL-C in the window where you started
the "idle" application, to terminate the process.


HOW DO I WRITE A PROGRAM BASED ON UT?
-------------------------------------
Please see the libut web page at http://libut.sourceforge.net


$Id: README,v 1.6 2005/11/09 05:43:31 thanson Exp $
