----------------------------------------------------------------------

ELOQUENCE B.08.30 - patch PE83-2211101

----------------------------------------------------------------------

This patch adds enhancements or fixes defects of the database fwutil
library as released with Eloquence B.08.30-1810. This patch will be
integrated in the Eloquence B.08.30 release.

Eloquence B.08.30-1810 must be installed before applying this patch.

Severity:
 PE83-2211101: BUG FIX

Superseded patches:
 PE83-2111030: ENHANCEMENT
 PE83-2110220: BUG FIX
 PE83-2110210: ENHANCEMENT
 PE83-2108090: BUG FIX
 PE83-2107061: BUG FIX
 PE83-2107060: ENHANCEMENT


Patch PE83-2211101
------------------

Platforms: All

* Fixed a race condition which could cause an unexpected abort with
  a message like below:

  End-of-file: next forward-log segment ... does not match - aborting

  When encountering end-of-file while reading a forward-log file,
  fwutil checks whether a subsequent forward-log segment is present.
  Under rare conditions this could impose a race condition, more data
  could be pending in the current forward-log segment.

* Changed the internal library revision to "B.08.30.08".


Patch PE83-2111030
------------------

Platforms: All

* The fwutil library Fwu_reset_item_index() function has been
  added to reset the Fwu_get_item() iterator index.

* Changed the internal library revision to "B.08.30.07".


Patch PE83-2110220
------------------

Platforms: All

* Fixed increased system call overhead if Fwu_set_exit_callback()
  sets an exit callback function, introduced with previous patch
  PE83-2110210.

* Changed the internal library revision to "B.08.30.06".


Patch PE83-2110210
------------------

Platforms: All

* The fwutil library Fwu_set_exit_callback() function has been
  added to allow to gracefully exit a running Fwu_process().

    typedef int (*Fwu_exit_callback_t)(void);
    extern void Fwu_set_exit_callback(Fwu_exit_callback_t cb);

  For example:

    static int check_exit_condition(void)
    {
      if (exit_condition)
        return 1;
      return 0;
    }

    Fwu_set_exit_callback(check_exit_condition);

  In this example, the callback function checks a global variable
  which could be set in a signal handler.

  A running Fwu_process() invokes the callback function once a
  second at most. When the callback function returns nonzero,
  Fwu_process() exits.

* Changed the internal library revision to "B.08.30.05".


Patch PE83-2108090
------------------

Platforms: All

* Fixed status file version not updated.

* Changed the internal library revision to "B.08.30.04".


Patch PE83-2107061
------------------

Platforms: All

* Fixed increased system call overhead, introduced with previous
  patch PE83-2107060.

* Changed the internal library revision to "B.08.30.03".


Patch PE83-2107060
------------------

Platforms: All

* The fwutil library Fwu_status function was enhanced to report the
  transaction timestamp and processing delay.

* Changed the internal library revision to "B.08.30.02".


Installation:
-------------

Please download the patch archive that corresponds with the installed
release.  The patch files follow the conventions below:

   PE83-2211101-hpux-ia64.tar.gz
        ^       ^    ^
        |       |    Architecture / OS specific build
        |       Operating system
        Patch ID


HP-UX:

In order to install this patch, you need to unpack it with gzip and tar.
Gzip is included with HP-UX. Installation requires root privileges.

cd /opt/eloquence/8.3
gzip -dc /path/to/PE83-1510221-hpux.tar.gz | tar xf -

Files:

   include/fwutil.h
   lib/pa20_32/libfwutil.sl (HP-UX PA-RISC 2.0 32bit)
   lib/pa20_64/libfwutil.sl (HP-UX PA-RISC 2.0 64bit)
   lib/hpux32/libfwutil.so  (HP-UX Itanium 32bit)
   lib/hpux64/libfwutil.so  (HP-UX Itanium 64bit)
   share/doc/PE83-2211101-README


Linux:

In order to install this patch, you need to unpack it with tar.
Installation requires root privileges.

cd /opt/eloquence/8.3
tar xzf /path/to/PE83-2211101-linux.tar.gz

Files:

   include/fwutil.h
   lib/libfwutil.so
   lib64/libfwutil.so
   share/doc/PE83-2211101-README


Windows:

Two options are available for patch installation. The patch is
available as self extracting archive for automatic installation
and as a zip archive for manual installation. Both patches are
equivalent. Installation requires administrative capabilities.

For autmatic installation of this patch, please download the patch
file PE83-2211101-win32.exe. Before installation, please consider
closing all applications, then execute the patch installation program.
Installation does not require a reboot unless the patched files
were active.

For a manual installation of the patch, please download the patch
file PE83-2211101-win32.zip and unpack its contents. Then perform
the following steps:

* Please copy the fwutil.h file into the Eloquence include directory.
  (Default location: C:\Program Files\Eloquence\8.3\include)

* Please copy the .dll files into the Eloquence bin directory.
  (Default location: C:\Program Files\Eloquence\8.3\bin)

* Please copy the .lib files into the Eloquence lib directory.
  (Default location: C:\Program Files\Eloquence\8.3\lib)

* Please copy the PE83-2211101-README.txt file into the Eloquence
  share\doc directory.
  (Default location: C:\Program Files\Eloquence\8.3\share\doc)

Files:

   fwutil.h
   fwutil.dll
   fwutil64.dll
   fwutil.lib
   fwutil64.lib
   PE83-2211101-README.txt