(This is file $Id: README 70326 2006-01-10 07:23:43Z jtc $)

The files in this directory contain the source code from the book
``C++ Network Programming: Systematic Reuse with ACE and Frameworks''
(C++NPv2) by Douglas C. Schmidt and Stephen D. Huston (Addison-Wesley
2001, ISBN 0-201-79525-6).

We have compiled and run these files on the following platforms:

        Sun Solaris 8 on SPARC using Sun Forte 6.
        Redhat Linux 7.1 using g++ 2.96.
        Microsoft Windows 2000 using Microsoft Visual C++ 6.

You must have the ACE_ROOT environment variable set correctly to build
these examples. ACE_ROOT must refer to the top-level ACE_wrappers
directory.  Please see $ACE_ROOT/ACE-INSTALL.html for instructions on
how to build the ACE toolkit.

Mapping Source Files to Book Chapters
-------------------------------------

The files in this directory map to the chapters in C++NPv2 as follows:

Chapter 3       Logging_Acceptor.cpp
                Logging_Acceptor.h
                Logging_Acceptor_Ex.h
                Logging_Event_Handler.cpp
                Logging_Event_Handler.h
                Logging_Event_Handler_Ex.cpp
                Logging_Event_Handler_Ex.h
                Logging_Handler.cpp
                Logging_Handler.h
                Reactor_Logging_Server.cpp
                Reactor_Logging_Server_T.h
                Reactor_Logging_Server_T.cpp

Chapter 4       Select_Reactor_Logging_Server.cpp
                TP_Reactor_Logging_Server.cpp
                WFMO_Reactor_Logging_Server.cpp

Chapter 5       Configurable_Logging_Server.cpp
                Reactor_Logging_Server_Adapter.cpp
                Reactor_Logging_Server_Adapter.h
                Service_Reporter.cpp
                Service_Reporter.h
                Server_Shutdown.cpp
                SLD.cpp
                SLDEX_export.h
                SLD_export.h
                SLDex.cpp

Chapter 6       Client_Logging_Daemon.cpp
                CLD_export.h
                TPLS_export.h
                TP_Logging_Server.cpp
                TP_Logging_Server.h

Chapter 7       AC_CLD_export.h
                AC_Client_Logging_Daemon.cpp
                SR_Configurable_Logging_Server.cpp
                TPC_Logging_Server.cpp
                TPC_Logging_Server.h
                TPCLS_export.h

Chapter 8       AIO_CLD_export.h
                AIO_Client_Logging_Daemon.cpp

Chapter 9       display_logfile.cpp

Microsoft Visual C++ users:
---------------------------

The examples.dsw file is a Microsoft Visual C++ workspace file that
contains projects for the individual programs. You can either build
them separately, or use the Batch Build command to build multiple
projects at once.

All other users:
----------------

Assuming that your system is configured correctly, you should be able
to type

% make

to compile all of the programs, and

% make clean

to remove all the files that were generated during compilation.

There are also individual Makefiles for each separate example program.
These makefiles have a ".mak" suffix. For example, display_logfile.mak
is the makefile for the display_logfile program.

All of the files in these directories are copyright Addison Wesley,
and they come with absolutely no warranty whatsoever.  Permission is
hereby granted to use these programs for educational or commercial
purposes.
