From 29cb19ad1848fc74e542daaa2f58f501ea4e78a8 Mon Sep 17 00:00:00 2001 From: Wez Furlong Date: Sat, 16 Mar 2002 03:50:17 +0000 Subject: [PATCH] some minor docu-in-header changes --- main/php_streams.h | 16 ++++++++++++++-- main/streams.c | 3 +-- 2 files changed, 15 insertions(+), 4 deletions(-) diff --git a/main/php_streams.h b/main/php_streams.h index 2b4c0162bc..289ae46b63 100755 --- a/main/php_streams.h +++ b/main/php_streams.h @@ -25,6 +25,18 @@ /* See README.STREAMS in php4 root dir for more info about this stuff */ +/* The contents of the php_stream_ops and php_stream should only be accessed + * using the functions/macros in this header. + * If you need to get at something that doesn't have an API, + * drop me a line and we can sort out a way to do + * it properly. + * + * The only exceptions to this rule are that stream implementations can use + * the php_stream->abstract pointer to hold their context, and streams + * opened via stream_open_wrappers can use the zval ptr in + * php_stream->wrapperdata to hold meta data for php scripts to + * retrieve using fgetwrapperdata(). */ + typedef struct _php_stream php_stream; typedef struct _php_stream_ops { @@ -64,6 +76,7 @@ struct _php_stream { int fclose_stdiocast; FILE *stdiocast; /* cache this, otherwise we might leak! */ }; /* php_stream */ +/* state definitions when closing down; these are private to streams.c */ #define PHP_STREAM_FCLOSE_NONE 0 #define PHP_STREAM_FCLOSE_FDOPEN 1 #define PHP_STREAM_FCLOSE_FOPENCOOKIE 2 @@ -92,8 +105,7 @@ PHPAPI int php_stream_puts(php_stream *stream, char *buf); * Uses mmap if the src is a plain file and at offset 0 */ #define PHP_STREAM_COPY_ALL -1 PHPAPI size_t php_stream_copy_to_stream(php_stream *src, php_stream *dest, size_t maxlen); -/* read all data from stream and put into a buffer. Caller must free buffer when done, - * according to allocopts. +/* read all data from stream and put into a buffer. Caller must free buffer when done. * The copy will use mmap if available. */ PHPAPI size_t php_stream_read_all(php_stream *src, char **buf, int persistent); diff --git a/main/streams.c b/main/streams.c index 5e52851464..3b58318036 100755 --- a/main/streams.c +++ b/main/streams.c @@ -34,6 +34,7 @@ #define MAP_FAILED ((void *) -1) #endif +#define CHUNK_SIZE 8192 #ifdef PHP_WIN32 #define EWOULDBLOCK WSAEWOULDBLOCK @@ -227,8 +228,6 @@ PHPAPI int php_stream_seek(php_stream *stream, off_t offset, int whence) return -1; } -#define CHUNK_SIZE 8192 - PHPAPI size_t php_stream_read_all(php_stream *src, char **buf, int persistent) { size_t ret = 0; -- 2.40.0