$Id: README 94642 2011-10-06 15:06:39Z johnnyw $

This directory contains program(s) that demonstrate how to use ACE's
Log_Msg class to record various information.

        * test_callback.cpp: This program tests the Log_Msg
          abstraction wrt writing to user defined callback objects.

        * test_ostream.cpp: This program illustrates how the
          ACE_Log_Msg abstraction can be used to write to
          stderr and to a file.  For even more sophisticated
          use-cases of ACE_Log_Msg please see the
          $ACE_ROOT/netsvcs/clients/Logger/ examples.

  * test_log_msg.cpp: This program tests various feature of the
          Log_Msg facility.  It opens a log file and writes some
          messages using different log priorities and output stream.

    You can invoke the program with or without command
    parameters.  When invoked with any parameters like,

    ./Log_Msg foobar

    the log messages are direct to stdout (or, ostream in C++.)
    In this case, the program simulates an error EWOULDBLOCK and
    write an error log to stdout as,

    would block
    op_status and errnum work!

    When invoked without any parameters, except does the same
    test as above but logs to default log stream "stderr," the
    program also demonstrates logging messages/errors with
    different priority and changing the logging destination.  A
    sample output is,

      would block
      op_status and errnum work!
        3.141600,         hello = 10000
        6.283200,         world = 20000
        6.283200,         world = 20000
        9.424800,         world = 30000
      12.566400,         world = 40000
      15.708000,         world = 50000
      HEXDUMP 48 bytes
      01 00 00 00 02 00 00 00  04 00 00 00 08 00 00 00   ................
      10 00 00 00 20 00 00 00  40 00 00 00 80 00 00 00   .... ...@.......
      00 01 00 00 00 02 00 00  00 04 00 00 00 08 00 00   ................
      ./Log_Msg.EXE: (2710), badname: Function not implemented

    In this test, there are two lines containing "world` =
    20000."  That's because in the program, both stderr and
    stdout are "turned on" for logging before writing this log
    message.  The line containing "world = 30000" is written to
    stdout only.  Rest of the lines are all to the stderr.  You
    can examine this behavior by redirecting stderr and stdout
    to different files.

    The HEXDUMP output shows how to take an arbitrary object and
    hexdump its content for debugging.  Finally, the program
    shows an ordinary use case of logging error messages using
    the ACE_ERROR macro.

    If you look into the program, there is also a demonstration
    showing how to disable certain priorities of error message
    temporarily.

