PHP/Java Bridge SvnRepo

PHP 5 support

Added support for Slowlaris' broken stdio:
SFREAD SFWRITE SFDOPEN SFCLOSE SFEOF SFERROR: Use these instead of the stdio
versions. On Solaris these functions access the raw socket, which is slow
but at least it works

Fixed a bug that appeared on Slowlaris 9 stdio implementations.

From the BSD fopen(3) manpage (solaris' own manpage is pretty useless):

Reads and writes may be intermixed on read/write streams in any order,
and do not require an intermediate seek as in previous versions of stdio.
This is not portable to other systems, however; ANSI C requires that a
file positioning function intervene between output and input, unless an
input operation encounters end-of-file.

One of these "other systems" is solaris 9. From Linux' manpage:

Reads and writes may be intermixed on read/write streams in any order.
Note that ANSI C requires that a file positioning function intervene
between output and input, unless an input operation encounters end-of-
file. (If this condition is not met, then a read is allowed to return
the result of writes other than the most recent.) Therefore it is good
practice (and indeed sometimes necessary under Linux) to put an fseek
or fgetpos operation between write and read operations on such a
stream. This operation may be an apparent no-op (as in fseek(..., 0L,
SEEK_CUR) called for its synchronizing side effect.

The problem is that the above paragraph does not apply to fdopen'ed streams
because these streams are not seekable. Applying a seek operation on a
socket stream generates an error:

From Nathan Kurz:

Ok, so I'll put one in. But everything I try comes back with an error that the
operation is not permitted. I've tried all the combinations of fseek() and
fsetpos() that I can think of (to the current position, to the beginning, the
end) but (logically enough) none are supported.

So one cannot use fseek on sockets streams. That's why *all* stdio
implementations, except Solaris' do *not* require fseek() anymore.

But that still does not solve our problem; we must rewind the Solaris stdio
buffers somehow. fseek() does not work, but fortunately fflush() does
what we want. In other words, this is a hack that Sun invented to make
stdio buffers work with socket streams. Die, sun, DIE!

Bugfix: Call fflush right before fwrite and fread so that the
Sun stdio implementation rewinds the bufer pointers.

more expressive error messages

version

update to 1.0.0

Initial