---------------------------------------------------------------------- ELOQUENCE B.08.10 - patch PE81-1108260 ---------------------------------------------------------------------- This patch adds enhancements or fixes defects of the eloq.cgi program as released with Eloquence B.08.10. This patch will be integrated in the Eloquence B.08.10 release. Eloquence B.08.10 must be installed before applying this patch. Severity: PE81-1108260: BUG FIX, ENHANCEMENT Superseded patches: none Patch PE81-1108260 ------------------ Platforms: All Bug fix: * Fixed a problem where a POST request was not recognized if the application/x-www-form-urlencoded content type was used and a character set was specified in addition, for example: application/x-www-form-urlencoded; charset=ISO-8859-1 In this case, an error message like below was issued: Invalid content type in POST request. Enhancements: * The Content-Type character set, if specified, is now evaluated to determine whether or not eloq.cgi should apply an HP-ROMAN8 to ISO-8859-1 or HP-ROMAN9 to ISO-8859-15 character conversion of the program output. By default, if the first line of the program output is one of Content-Type: text/html Content-Type: text/plain without explicitly specifying a character set, ISO-8859-1 is assumed, so that eloq.cgi converts the program output from HP-ROMAN8 to ISO-8859-1. In addition, a character set may be specified to activate the character conversion for content types other than text/html and text/plain, for example: Content-Type: text/richtext; charset=ISO-8859-1 To activate the eloq.cgi character conversion of the program output, either the ISO-8859-1 or the ISO-8859-15 character set must be specified. Other character sets are not recognized. Content type and character set are not case sensitive. * POST request decoding has been enhanced. If the application/x-www-form-urlencoded or multipart/form-data content type is used, the POST request data is assumed to contain form items, which are stored into corresponding WWW_ prefixed environment variables. The form item values are converted to the HP-ROMAN8 character set, according to the content type character set, if specified. The ISO-8859-1 and ISO-8859-15 and UTF-8 character sets are recognized. If no character set is specified, ISO-8859-1 is assumed. An UTF-8 encoded item is first converted to ISO-8859-1 and then converted to HP-ROMAN8. Any content type other than application/x-www-form-urlencoded or multipart/form-data is used to store the binary POST request data to a temporary file. The temporary file is removed by eloq.cgi after the program has ended. To prevent eloq.cgi from removing the temporary file, a program may move or rename the file. The environment variables below are provided by eloq.cgi to the program: POSTDATA_TYPE Contains the content type. If the request is not a POST request or the content type is not specified, this variable is not set. For example: application/x-www-form-urlencoded POSTDATA_CHARSET Contains the character set. If no character set is specified, this variable is not set. For example: ISO-8859-1 POSTDATA_NAME Contains the temporary file name. If no temporary file is created, this variable is not set. POSTDATA_SIZE Contains the size of the POST request data in bytes. If a temporary file is created, this is equivalent to the temporary file size. In addition, if the content type is text/xml, the environment variables below are set for backward compatibility: XML_TEMPFILE Same as POSTDATA_NAME (see above). XML_TEMPFILE_SIZE Same as POSTDATA_SIZE (see above). * Logging of error/informational/debug messages has been added. The EQCGI_LOGFILE environment variable may be set to specify a log file. If set, the log file directory must allow read/write access to the user running the web server process. If the EQCGI_LOGFILE environment variable is not set, messages are output to stderr, which is usually redirected to the web server error log file. The EQCGI_LOGLEVEL environment variable may be set to specify the log level. If not set or set to zero, only error messages are output. If set to 1, informational messages are output in addition. If set to 2, debug messages are output in addition. If set to 3, more verbose debug messages are output. Note: The EQCGI_DEBUG environment variable is no longer used. Installation: ------------- Please download the patch archive that corresponds with the installed release. The patch files follow the conventions below: PE81-1108260-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.1 gzip -dc /path/to/PE81-1108260-hpux.tar.gz | tar xf - Files: lbin/eloq.cgi share/doc/PE81-1108260-README Linux: In order to install this patch, you need to unpack it with tar. Installation requires root privileges. cd /opt/eloquence/8.1 tar xzf /path/to/PE81-1108260-linux.tar.gz Files: lbin/eloq.cgi share/doc/PE81-1108260-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 automatic installation of this patch, please download the patch file PE81-1108260-win32.exe. Installation does not require a reboot unless the patched files were active. For a manual installation of the patch, please download the patch file PE81-1108260-win32.zip and unpack its contents. Then perform the following steps: * Please copy the eloq.cgi file into the Eloquence lbin directory. (Default location: C:\Program Files\Eloquence\8.1\lbin) * Please copy the PE81-1108260-README.txt file into the Eloquence share\doc directory. (Default location: C:\Program Files\Eloquence\8.1\share\doc) Files: eloq.cgi PE81-1108260-README.txt