Please note that you need to use 'int' as a length type when

fetching strings.

diff --git a/README.PARAMETER_PARSING_API b/README.PARAMETER_PARSING_API
index 0fb2dacce85309855ed30182079362a5b9d0a985..788a27d8e688489d3092aa96cf8b58f7c86d8f52 100644 (file)
--- a/README.PARAMETER_PARSING_API
+++ b/README.PARAMETER_PARSING_API
@@ -105,7 +105,14 @@ if (zend_parse_parameters(3 TSRMLS_CC, "zbr!",
 /* Get either a set of 3 longs or a string. */
 long l1, l2, l3;
 char *s;
-long length;
+/* 
+ * The function expects a pointer to a integer in this case, not a long
+ * or any other type.  If you specify a type which is larger
+ * than a 'int', the upper bits might not be initialized
+ * properly, leading to random crashes on platforms like
+ * Tru64 or Linux/Alpha.
+ */
+int length;
 
 if (zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, ZEND_NUM_ARGS() TSRMLS_CC,
                                                         "lll", &l1, &l2, &l3) == SUCCESS) {