ACE/examples/README

   1 This directory contains a number of examples that illustrate how to
   2 use the following ACE library components.  If you want to see how
   3 to program using ACE, this is the best place to start reading code and
   4 learning the ACE design.
   5
   6 These examples are roughly divided up according to the class
   7 categories in ACE.  For more information on ACE class categories,
   8 please take a look at $ACE_ROOT/ACE-categories.
   9
  10   . ASX
  11     Illustrate various components in the ADAPTIVE Service
  12     eXecutive, which is a user-level implementation of
  13     System V STREAMS written in C++.
  14
  15   . Connection
  16     Illustrate how the various Acceptor and Connector
  17     components can be used.
  18
  19   . IOStream
  20     Illustrate how the ACE IOStreams wrapper works.
  21
  22   . IPC_SAP
  23     Illustrate the C++ wrappers for Sockets, TLI, UNIX and
  24     Win32 Named Pipes, and UNIX Stream Pipes.
  25
  26   . Log_Msg
  27     Illustrate some of the features of the logging
  28     facility used in ACE to consolidate debugging and
  29     error report.
  30
  31   . Logger
  32     This is a simple version of a Server Logging Daemon
  33     that illustrates the "bare-bones" usage of the
  34     Reactor.  A more sophisticated set of logging examples
  35     are in the $ACE_ROOT/netsvcs/{client,lib,server}
  36     directories.
  37
  38   . Mem_Map
  39     Illustrate how the ACE memory-mapped file components
  40     work.
  41
  42   . Misc
  43     Various miscellaneous tests that illustrate how ACE
  44     utility components work.
  45
  46   . NT_Service
  47     Illustrates how to write an NT Service using the
  48     ACE_NT_Service class, and how to insert it and remove it
  49     in the SCM, start it, and stop it, and how to run as a
  50     service.
  51
  52   . Reactor
  53     Contains many examples of how to utilize the ACE
  54     object-oriented event demultiplexer.
  55
  56   . Service_Configurator
  57     Illustrates the use of the ACE mechanism for
  58     dynamically configuring communication services.
  59
  60   . Shared_Malloc
  61     Illustrates the use of ACE wrappers for
  62     sophisticated use of the ACE_Malloc shared
  63     memory components.
  64
  65   . Shared_Memory
  66     Illustrates the use of simple ACE wrappers for
  67     shared memory and memory mapped file.
  68
  69   . System_V_IPC
  70     Illustrates how to use the ACE wrappers for System V
  71     IPC (i.e., semphores, shared memory, and message
  72     queues).
  73
  74   . Threads
  75     Illustrates the use of ACE wrappers for threading
  76     and synchronization.
  77