text: /*
    +----------------------------------------------------------------------+
    | PHP Version 5                                                        |
    +----------------------------------------------------------------------+
    | Copyright (c) 1997-2013 The PHP Group                                |
    +----------------------------------------------------------------------+
    | This source file is subject to version 3.01 of the PHP license,      |
    | that is bundled with this package in the file LICENSE, and is        |
    | available through the world-wide-web at the following url:           |
    | http://www.php.net/license/3_01.txt                                  |
    | If you did not receive a copy of the PHP license and are unable to   |
    | obtain it through the world-wide-web, please send a note to          |
    | license@php.net so we can mail you a copy immediately.               |
    +----------------------------------------------------------------------+
    | Authors: Wez Furlong <wez@thebrainroom.com>                          |
    |          Sara Golemon <pollita@php.net>                              |
    +----------------------------------------------------------------------+
  */
  
  /* $Id$ */
  
  #include "php.h"
  #include "php_globals.h"
  #include "ext/standard/flock_compat.h"
  #include "ext/standard/file.h"
  #include "ext/standard/php_filestat.h"
  #include "php_open_temporary_file.h"
  #include "ext/standard/basic_functions.h"
  #include "php_ini.h"
  #include "streamsfuncs.h"
  #include "php_network.h"
  #include "php_string.h"
  
  #ifndef PHP_WIN32
  #define php_select(m, r, w, e, t)	select(m, r, w, e, t)
  typedef unsigned long long php_timeout_ull;
  #else
  #include "win32/select.h"
  #include "win32/sockets.h"
  typedef unsigned __int64 php_timeout_ull;
  #endif
  
  static php_stream_context *decode_context_param(zval *contextresource TSRMLS_DC);
  
  /* Streams based network functions */
  
  #if HAVE_SOCKETPAIR
  /* {{{ proto array stream_socket_pair(int domain, int type, int protocol)
     Creates a pair of connected, indistinguishable socket streams */
  PHP_FUNCTION(stream_socket_pair)
  {
  	long domain, type, protocol;
  	php_stream *s1, *s2;
  	php_socket_t pair[2];
  
  	if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "lll",
  			&domain, &type, &protocol)) {
  		RETURN_FALSE;
  	}
  
  	if (0 != socketpair(domain, type, protocol, pair)) {
  		char errbuf[256];
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "failed to create sockets: [%d]: %s",
  			php_socket_errno(), php_socket_strerror(php_socket_errno(), errbuf, sizeof(errbuf)));
  		RETURN_FALSE;
  	}
  
  	array_init(return_value);
  
  	s1 = php_stream_sock_open_from_socket(pair[0], 0);
  	s2 = php_stream_sock_open_from_socket(pair[1], 0);
  
  	/* set the __exposed flag.
  	 * php_stream_to_zval() does, add_next_index_resource() does not */
  	php_stream_auto_cleanup(s1);
  	php_stream_auto_cleanup(s2);
  
  	add_next_index_resource(return_value, php_stream_get_resource_id(s1));
  	add_next_index_resource(return_value, php_stream_get_resource_id(s2));
  }
  /* }}} */
  #endif
  
  /* {{{ proto resource stream_socket_client(string remoteaddress [, long &errcode [, string &errstring [, double timeout [, long flags [, resource context]]]]])
     Open a client connection to a remote address */
  PHP_FUNCTION(stream_socket_client)
  {
  	char *host;
  	int host_len;
  	zval *zerrno = NULL, *zerrstr = NULL, *zcontext = NULL;
  	double timeout = FG(default_socket_timeout);
  	php_timeout_ull conv;
  	struct timeval tv;
  	char *hashkey = NULL;
  	php_stream *stream = NULL;
  	int err;
  	long flags = PHP_STREAM_CLIENT_CONNECT;
  	char *errstr = NULL;
  	php_stream_context *context = NULL;
  
  	RETVAL_FALSE;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|zzdlr", &host, &host_len, &zerrno, &zerrstr, &timeout, &flags, &zcontext) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	context = php_stream_context_from_zval(zcontext, flags & PHP_FILE_NO_DEFAULT_CONTEXT);
  
  	if (flags & PHP_STREAM_CLIENT_PERSISTENT) {
  		spprintf(&hashkey, 0, "stream_socket_client__%s", host);
  	}
  
  	/* prepare the timeout value for use */
  	conv = (php_timeout_ull) (timeout * 1000000.0);
  #ifdef PHP_WIN32
  	tv.tv_sec = (long)(conv / 1000000);
  	tv.tv_usec =(long)(conv % 1000000);
  #else
  	tv.tv_sec = conv / 1000000;
  	tv.tv_usec = conv % 1000000;
  #endif
  	if (zerrno)	{
  		zval_dtor(zerrno);
  		ZVAL_LONG(zerrno, 0);
  	}
  	if (zerrstr) {
  		zval_dtor(zerrstr);
  		ZVAL_STRING(zerrstr, "", 1);
  	}
  
  	stream = php_stream_xport_create(host, host_len, REPORT_ERRORS,
  			STREAM_XPORT_CLIENT | (flags & PHP_STREAM_CLIENT_CONNECT ? STREAM_XPORT_CONNECT : 0) |
  			(flags & PHP_STREAM_CLIENT_ASYNC_CONNECT ? STREAM_XPORT_CONNECT_ASYNC : 0),
  			hashkey, &tv, context, &errstr, &err);
  
  
  	if (stream == NULL) {
  		/* host might contain binary characters */
  		char *quoted_host = php_addslashes(host, host_len, NULL, 0 TSRMLS_CC);
  
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "unable to connect to %s (%s)", quoted_host, errstr == NULL ? "Unknown error" : errstr);
  		efree(quoted_host);
  	}
  
  	if (hashkey) {
  		efree(hashkey);
  	}
  
  	if (stream == NULL)	{
  		if (zerrno) {
  			zval_dtor(zerrno);
  			ZVAL_LONG(zerrno, err);
  		}
  		if (zerrstr && errstr) {
  			/* no need to dup; we need to efree buf anyway */
  			zval_dtor(zerrstr);
  			ZVAL_STRING(zerrstr, errstr, 0);
  		} else if (errstr) {
  			efree(errstr);
  		}
  		RETURN_FALSE;
  	}
  
  	if (errstr) {
  		efree(errstr);
  	}
  
  	php_stream_to_zval(stream, return_value);
  
  }
  /* }}} */
  
  /* {{{ proto resource stream_socket_server(string localaddress [, long &errcode [, string &errstring [, long flags [, resource context]]]])
     Create a server socket bound to localaddress */
  PHP_FUNCTION(stream_socket_server)
  {
  	char *host;
  	int host_len;
  	zval *zerrno = NULL, *zerrstr = NULL, *zcontext = NULL;
  	php_stream *stream = NULL;
  	int err = 0;
  	long flags = STREAM_XPORT_BIND | STREAM_XPORT_LISTEN;
  	char *errstr = NULL;
  	php_stream_context *context = NULL;
  
  	RETVAL_FALSE;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|zzlr", &host, &host_len, &zerrno, &zerrstr, &flags, &zcontext) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	context = php_stream_context_from_zval(zcontext, flags & PHP_FILE_NO_DEFAULT_CONTEXT);
  
  	if (context) {
  		zend_list_addref(context->rsrc_id);
  	}
  
  	if (zerrno)	{
  		zval_dtor(zerrno);
  		ZVAL_LONG(zerrno, 0);
  	}
  	if (zerrstr) {
  		zval_dtor(zerrstr);
  		ZVAL_STRING(zerrstr, "", 1);
  	}
  
  	stream = php_stream_xport_create(host, host_len, REPORT_ERRORS,
  			STREAM_XPORT_SERVER | flags,
  			NULL, NULL, context, &errstr, &err);
  
  	if (stream == NULL) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "unable to connect to %s (%s)", host, errstr == NULL ? "Unknown error" : errstr);
  	}
  
  	if (stream == NULL)	{
  		if (zerrno) {
  			zval_dtor(zerrno);
  			ZVAL_LONG(zerrno, err);
  		}
  		if (zerrstr && errstr) {
  			/* no need to dup; we need to efree buf anyway */
  			zval_dtor(zerrstr);
  			ZVAL_STRING(zerrstr, errstr, 0);
  		} else if (errstr) {
  			efree(errstr);
  		}
  		RETURN_FALSE;
  	}
  
  	if (errstr) {
  		efree(errstr);
  	}
  
  	php_stream_to_zval(stream, return_value);
  }
  /* }}} */
  
  /* {{{ proto resource stream_socket_accept(resource serverstream, [ double timeout [, string &peername ]])
     Accept a client connection from a server socket */
  PHP_FUNCTION(stream_socket_accept)
  {
  	double timeout = FG(default_socket_timeout);
  	zval *zpeername = NULL;
  	char *peername = NULL;
  	int peername_len;
  	php_timeout_ull conv;
  	struct timeval tv;
  	php_stream *stream = NULL, *clistream = NULL;
  	zval *zstream;
  
  	char *errstr = NULL;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r|dz", &zstream, &timeout, &zpeername) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zstream);
  
  	/* prepare the timeout value for use */
  	conv = (php_timeout_ull) (timeout * 1000000.0);
  #ifdef PHP_WIN32
  	tv.tv_sec = (long)(conv / 1000000);
  	tv.tv_usec = (long)(conv % 1000000);
  #else
  	tv.tv_sec = conv / 1000000;
  	tv.tv_usec = conv % 1000000;
  #endif
  	if (zpeername) {
  		zval_dtor(zpeername);
  		ZVAL_NULL(zpeername);
  	}
  
  	if (0 == php_stream_xport_accept(stream, &clistream,
  				zpeername ? &peername : NULL,
  				zpeername ? &peername_len : NULL,
  				NULL, NULL,
  				&tv, &errstr
  				TSRMLS_CC) && clistream) {
  
  		if (peername) {
  			ZVAL_STRINGL(zpeername, peername, peername_len, 0);
  		}
  		php_stream_to_zval(clistream, return_value);
  	} else {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "accept failed: %s", errstr ? errstr : "Unknown error");
  		RETVAL_FALSE;
  	}
  
  	if (errstr) {
  		efree(errstr);
  	}
  }
  /* }}} */
  
  /* {{{ proto string stream_socket_get_name(resource stream, bool want_peer)
     Returns either the locally bound or remote name for a socket stream */
  PHP_FUNCTION(stream_socket_get_name)
  {
  	php_stream *stream;
  	zval *zstream;
  	zend_bool want_peer;
  	char *name = NULL;
  	int name_len;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rb", &zstream, &want_peer) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zstream);
  
  	if (0 != php_stream_xport_get_name(stream, want_peer,
  				&name,
  				&name_len,
  				NULL, NULL
  				TSRMLS_CC)) {
  		RETURN_FALSE;
  	}
  
  	RETURN_STRINGL(name, name_len, 0);
  }
  /* }}} */
  
  /* {{{ proto long stream_socket_sendto(resouce stream, string data [, long flags [, string target_addr]])
     Send data to a socket stream.  If target_addr is specified it must be in dotted quad (or [ipv6]) format */
  PHP_FUNCTION(stream_socket_sendto)
  {
  	php_stream *stream;
  	zval *zstream;
  	long flags = 0;
  	char *data, *target_addr = NULL;
  	int datalen, target_addr_len = 0;
  	php_sockaddr_storage sa;
  	socklen_t sl = 0;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rs|ls", &zstream, &data, &datalen, &flags, &target_addr, &target_addr_len) == FAILURE) {
  		RETURN_FALSE;
  	}
  	php_stream_from_zval(stream, &zstream);
  
  	if (target_addr_len) {
  		/* parse the address */
  		if (FAILURE == php_network_parse_network_address_with_port(target_addr, target_addr_len, (struct sockaddr*)&sa, &sl TSRMLS_CC)) {
  			php_error_docref(NULL TSRMLS_CC, E_WARNING, "Failed to parse `%s' into a valid network address", target_addr);
  			RETURN_FALSE;
  		}
  	}
  
  	RETURN_LONG(php_stream_xport_sendto(stream, data, datalen, flags, target_addr ? &sa : NULL, sl TSRMLS_CC));
  }
  /* }}} */
  
  /* {{{ proto string stream_socket_recvfrom(resource stream, long amount [, long flags [, string &remote_addr]])
     Receives data from a socket stream */
  PHP_FUNCTION(stream_socket_recvfrom)
  {
  	php_stream *stream;
  	zval *zstream, *zremote = NULL;
  	char *remote_addr = NULL;
  	int remote_addr_len;
  	long to_read = 0;
  	char *read_buf;
  	long flags = 0;
  	int recvd;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl|lz", &zstream, &to_read, &flags, &zremote) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zstream);
  
  	if (zremote) {
  		zval_dtor(zremote);
  		ZVAL_NULL(zremote);
  	}
  
  	if (to_read <= 0) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Length parameter must be greater than 0");
  		RETURN_FALSE;
  	}
  
  	read_buf = safe_emalloc(1, to_read, 1);
  
  	recvd = php_stream_xport_recvfrom(stream, read_buf, to_read, flags, NULL, NULL,
  			zremote ? &remote_addr : NULL,
  			zremote ? &remote_addr_len : NULL
  			TSRMLS_CC);
  
  	if (recvd >= 0) {
  		if (zremote) {
  			ZVAL_STRINGL(zremote, remote_addr, remote_addr_len, 0);
  		}
  		read_buf[recvd] = '\0';
  
  		RETURN_STRINGL(read_buf, recvd, 0);
  	}
  
  	efree(read_buf);
  	RETURN_FALSE;
  }
  /* }}} */
  
  /* {{{ proto string stream_get_contents(resource source [, long maxlen [, long offset]])
     Reads all remaining bytes (or up to maxlen bytes) from a stream and returns them as a string. */
  PHP_FUNCTION(stream_get_contents)
  {
  	php_stream	*stream;
  	zval		*zsrc;
  	long		maxlen		= PHP_STREAM_COPY_ALL,
  				desiredpos	= -1L;
  	int			len;
  	char		*contents	= NULL;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r|ll", &zsrc, &maxlen, &desiredpos) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zsrc);
  
  	if (desiredpos >= 0) {
  		int		seek_res = 0;
  		off_t	position;
  
  		position = php_stream_tell(stream);
  		if (position >= 0 && desiredpos > position) {
  			/* use SEEK_CUR to allow emulation in streams that don't support seeking */
  			seek_res = php_stream_seek(stream, desiredpos - position, SEEK_CUR);
  		} else if (desiredpos < position)  {
  			/* desired position before position or error on tell */
  			seek_res = php_stream_seek(stream, desiredpos, SEEK_SET);
  		}
  
  		if (seek_res != 0) {
  			php_error_docref(NULL TSRMLS_CC, E_WARNING,
  				"Failed to seek to position %ld in the stream", desiredpos);
  			RETURN_FALSE;
  		}
  	}
  
  	len = php_stream_copy_to_mem(stream, &contents, maxlen, 0);
  
  	if (contents) {
  		RETVAL_STRINGL(contents, len, 0);
  	} else {
  		RETVAL_EMPTY_STRING();
  	}
  }
  /* }}} */
  
  /* {{{ proto long stream_copy_to_stream(resource source, resource dest [, long maxlen [, long pos]])
     Reads up to maxlen bytes from source stream and writes them to dest stream. */
  PHP_FUNCTION(stream_copy_to_stream)
  {
  	php_stream *src, *dest;
  	zval *zsrc, *zdest;
  	long maxlen = PHP_STREAM_COPY_ALL, pos = 0;
  	size_t len;
  	int ret;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rr|ll", &zsrc, &zdest, &maxlen, &pos) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(src, &zsrc);
  	php_stream_from_zval(dest, &zdest);
  
  	if (pos > 0 && php_stream_seek(src, pos, SEEK_SET) < 0) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Failed to seek to position %ld in the stream", pos);
  		RETURN_FALSE;
  	}
  
  	ret = php_stream_copy_to_stream_ex(src, dest, maxlen, &len);
  
  	if (ret != SUCCESS) {
  		RETURN_FALSE;
  	}
  	RETURN_LONG(len);
  }
  /* }}} */
  
  /* {{{ proto array stream_get_meta_data(resource fp)
      Retrieves header/meta data from streams/file pointers */
  PHP_FUNCTION(stream_get_meta_data)
  {
  	zval *arg1;
  	php_stream *stream;
  	zval *newval;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &arg1) == FAILURE) {
  		return;
  	}
  	php_stream_from_zval(stream, &arg1);
  
  	array_init(return_value);
  
  	if (stream->wrapperdata) {
  		MAKE_STD_ZVAL(newval);
  		MAKE_COPY_ZVAL(&stream->wrapperdata, newval);
  
  		add_assoc_zval(return_value, "wrapper_data", newval);
  	}
  	if (stream->wrapper) {
  		add_assoc_string(return_value, "wrapper_type", (char *)stream->wrapper->wops->label, 1);
  	}
  	add_assoc_string(return_value, "stream_type", (char *)stream->ops->label, 1);
  
  	add_assoc_string(return_value, "mode", stream->mode, 1);
  
  #if 0	/* TODO: needs updating for new filter API */
  	if (stream->filterhead) {
  		php_stream_filter *filter;
  
  		MAKE_STD_ZVAL(newval);
  		array_init(newval);
  
  		for (filter = stream->filterhead; filter != NULL; filter = filter->next) {
  			add_next_index_string(newval, (char *)filter->fops->label, 1);
  		}
  
  		add_assoc_zval(return_value, "filters", newval);
  	}
  #endif
  
  	add_assoc_long(return_value, "unread_bytes", stream->writepos - stream->readpos);
  
  	add_assoc_bool(return_value, "seekable", (stream->ops->seek) && (stream->flags & PHP_STREAM_FLAG_NO_SEEK) == 0);
  	if (stream->orig_path) {
  		add_assoc_string(return_value, "uri", stream->orig_path, 1);
  	}
  
  	if (!php_stream_populate_meta_data(stream, return_value)) {
  		add_assoc_bool(return_value, "timed_out", 0);
  		add_assoc_bool(return_value, "blocked", 1);
  		add_assoc_bool(return_value, "eof", php_stream_eof(stream));
  	}
  
  }
  /* }}} */
  
  /* {{{ proto array stream_get_transports()
     Retrieves list of registered socket transports */
  PHP_FUNCTION(stream_get_transports)
  {
  	HashTable *stream_xport_hash;
  	char *stream_xport;
  	uint stream_xport_len;
  	ulong num_key;
  
  	if (zend_parse_parameters_none() == FAILURE) {
  		return;
  	}
  
  	if ((stream_xport_hash = php_stream_xport_get_hash())) {
  		HashPosition pos;
  		array_init(return_value);
  		zend_hash_internal_pointer_reset_ex(stream_xport_hash, &pos);
  		while (zend_hash_get_current_key_ex(stream_xport_hash,
  					&stream_xport, &stream_xport_len,
  					&num_key, 0, &pos) == HASH_KEY_IS_STRING) {
  			add_next_index_stringl(return_value, stream_xport, stream_xport_len - 1, 1);
  			zend_hash_move_forward_ex(stream_xport_hash, &pos);
  		}
  	} else {
  		RETURN_FALSE;
  	}
  }
  /* }}} */
  
  /* {{{ proto array stream_get_wrappers()
      Retrieves list of registered stream wrappers */
  PHP_FUNCTION(stream_get_wrappers)
  {
  	HashTable *url_stream_wrappers_hash;
  	char *stream_protocol;
  	int key_flags;
  	uint stream_protocol_len = 0;
  	ulong num_key;
  
  	if (zend_parse_parameters_none() == FAILURE) {
  		return;
  	}
  
  	if ((url_stream_wrappers_hash = php_stream_get_url_stream_wrappers_hash())) {
  		HashPosition pos;
  		array_init(return_value);
  		for (zend_hash_internal_pointer_reset_ex(url_stream_wrappers_hash, &pos);
  			(key_flags = zend_hash_get_current_key_ex(url_stream_wrappers_hash, &stream_protocol, &stream_protocol_len, &num_key, 0, &pos)) != HASH_KEY_NON_EXISTENT;
  			zend_hash_move_forward_ex(url_stream_wrappers_hash, &pos)) {
  				if (key_flags == HASH_KEY_IS_STRING) {
  					add_next_index_stringl(return_value, stream_protocol, stream_protocol_len - 1, 1);
  				}
  		}
  	} else {
  		RETURN_FALSE;
  	}
  
  }
  /* }}} */
  
  /* {{{ stream_select related functions */
  static int stream_array_to_fd_set(zval *stream_array, fd_set *fds, php_socket_t *max_fd TSRMLS_DC)
  {
  	zval **elem;
  	php_stream *stream;
  	int cnt = 0;
  
  	if (Z_TYPE_P(stream_array) != IS_ARRAY) {
  		return 0;
  	}
  	for (zend_hash_internal_pointer_reset(Z_ARRVAL_P(stream_array));
  		 zend_hash_get_current_data(Z_ARRVAL_P(stream_array), (void **) &elem) == SUCCESS;
  		 zend_hash_move_forward(Z_ARRVAL_P(stream_array))) {
  
  		/* Temporary int fd is needed for the STREAM data type on windows, passing this_fd directly to php_stream_cast()
  			would eventually bring a wrong result on x64. php_stream_cast() casts to int internally, and this will leave
  			the higher bits of a SOCKET variable uninitialized on systems with little endian. */
  		int tmp_fd;
  
  		php_stream_from_zval_no_verify(stream, elem);
  		if (stream == NULL) {
  			continue;
  		}
  		/* get the fd.
  		 * NB: Most other code will NOT use the PHP_STREAM_CAST_INTERNAL flag
  		 * when casting.  It is only used here so that the buffered data warning
  		 * is not displayed.
  		 * */
  		if (SUCCESS == php_stream_cast(stream, PHP_STREAM_AS_FD_FOR_SELECT | PHP_STREAM_CAST_INTERNAL, (void*)&tmp_fd, 1) && tmp_fd != -1) {
  
  			php_socket_t this_fd = (php_socket_t)tmp_fd;
  
  			PHP_SAFE_FD_SET(this_fd, fds);
  
  			if (this_fd > *max_fd) {
  				*max_fd = this_fd;
  			}
  			cnt++;
  		}
  	}
  	return cnt ? 1 : 0;
  }
  
  static int stream_array_from_fd_set(zval *stream_array, fd_set *fds TSRMLS_DC)
  {
  	zval **elem, **dest_elem;
  	php_stream *stream;
  	HashTable *new_hash;
  	int ret = 0;
  
  	if (Z_TYPE_P(stream_array) != IS_ARRAY) {
  		return 0;
  	}
  	ALLOC_HASHTABLE(new_hash);
  	zend_hash_init(new_hash, zend_hash_num_elements(Z_ARRVAL_P(stream_array)), NULL, ZVAL_PTR_DTOR, 0);
  
  	for (zend_hash_internal_pointer_reset(Z_ARRVAL_P(stream_array));
  		 zend_hash_has_more_elements(Z_ARRVAL_P(stream_array)) == SUCCESS;
  		 zend_hash_move_forward(Z_ARRVAL_P(stream_array))) {
  
  		int type;
  		char *key;
  		uint key_len;
  		ulong num_ind;
  		/* Temporary int fd is needed for the STREAM data type on windows, passing this_fd directly to php_stream_cast()
  			would eventually bring a wrong result on x64. php_stream_cast() casts to int internally, and this will leave
  			the higher bits of a SOCKET variable uninitialized on systems with little endian. */
  		int tmp_fd;
  
  
  		type = zend_hash_get_current_key_ex(Z_ARRVAL_P(stream_array),
  				&key, &key_len, &num_ind, 0, NULL);
  		if (type == HASH_KEY_NON_EXISTENT ||
  			zend_hash_get_current_data(Z_ARRVAL_P(stream_array), (void **) &elem) == FAILURE) {
  			continue; /* should not happen */
  		}
  
  		php_stream_from_zval_no_verify(stream, elem);
  		if (stream == NULL) {
  			continue;
  		}
  		/* get the fd
  		 * NB: Most other code will NOT use the PHP_STREAM_CAST_INTERNAL flag
  		 * when casting.  It is only used here so that the buffered data warning
  		 * is not displayed.
  		 */
  		if (SUCCESS == php_stream_cast(stream, PHP_STREAM_AS_FD_FOR_SELECT | PHP_STREAM_CAST_INTERNAL, (void*)&tmp_fd, 1) && tmp_fd != -1) {
  
  			php_socket_t this_fd = (php_socket_t)tmp_fd;
  
  			if (PHP_SAFE_FD_ISSET(this_fd, fds)) {
  				if (type == HASH_KEY_IS_LONG) {
  					zend_hash_index_update(new_hash, num_ind, (void *)elem, sizeof(zval *), (void **)&dest_elem);
  				} else { /* HASH_KEY_IS_STRING */
  					zend_hash_update(new_hash, key, key_len, (void *)elem, sizeof(zval *), (void **)&dest_elem);
  				}
  				
  				if (dest_elem) {
  					zval_add_ref(dest_elem);
  				}
  				ret++;
  				continue;
  			}
  		}
  	}
  
  	/* destroy old array and add new one */
  	zend_hash_destroy(Z_ARRVAL_P(stream_array));
  	efree(Z_ARRVAL_P(stream_array));
  
  	zend_hash_internal_pointer_reset(new_hash);
  	Z_ARRVAL_P(stream_array) = new_hash;
  
  	return ret;
  }
  
  static int stream_array_emulate_read_fd_set(zval *stream_array TSRMLS_DC)
  {
  	zval **elem, **dest_elem;
  	php_stream *stream;
  	HashTable *new_hash;
  	int ret = 0;
  
  	if (Z_TYPE_P(stream_array) != IS_ARRAY) {
  		return 0;
  	}
  	ALLOC_HASHTABLE(new_hash);
  	zend_hash_init(new_hash, zend_hash_num_elements(Z_ARRVAL_P(stream_array)), NULL, ZVAL_PTR_DTOR, 0);
  
  	for (zend_hash_internal_pointer_reset(Z_ARRVAL_P(stream_array));
  		 zend_hash_get_current_data(Z_ARRVAL_P(stream_array), (void **) &elem) == SUCCESS;
  		 zend_hash_move_forward(Z_ARRVAL_P(stream_array))) {
  
  		php_stream_from_zval_no_verify(stream, elem);
  		if (stream == NULL) {
  			continue;
  		}
  		if ((stream->writepos - stream->readpos) > 0) {
  			/* allow readable non-descriptor based streams to participate in stream_select.
  			 * Non-descriptor streams will only "work" if they have previously buffered the
  			 * data.  Not ideal, but better than nothing.
  			 * This branch of code also allows blocking streams with buffered data to
  			 * operate correctly in stream_select.
  			 * */
  			zend_hash_next_index_insert(new_hash, (void *)elem, sizeof(zval *), (void **)&dest_elem);
  			if (dest_elem) {
  				zval_add_ref(dest_elem);
  			}
  			ret++;
  			continue;
  		}
  	}
  
  	if (ret > 0) {
  		/* destroy old array and add new one */
  		zend_hash_destroy(Z_ARRVAL_P(stream_array));
  		efree(Z_ARRVAL_P(stream_array));
  
  		zend_hash_internal_pointer_reset(new_hash);
  		Z_ARRVAL_P(stream_array) = new_hash;
  	} else {
  		zend_hash_destroy(new_hash);
  		FREE_HASHTABLE(new_hash);
  	}
  
  	return ret;
  }
  /* }}} */
  
  /* {{{ proto int stream_select(array &read_streams, array &write_streams, array &except_streams, int tv_sec[, int tv_usec])
     Runs the select() system call on the sets of streams with a timeout specified by tv_sec and tv_usec */
  PHP_FUNCTION(stream_select)
  {
  	zval			*r_array, *w_array, *e_array, **sec = NULL;
  	struct timeval	tv;
  	struct timeval *tv_p = NULL;
  	fd_set			rfds, wfds, efds;
  	php_socket_t	max_fd = 0;
  	int				retval, sets = 0;
  	long			usec = 0;
  	int				set_count, max_set_count = 0;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a!a!a!Z!|l", &r_array, &w_array, &e_array, &sec, &usec) == FAILURE)
  		return;
  
  	FD_ZERO(&rfds);
  	FD_ZERO(&wfds);
  	FD_ZERO(&efds);
  
  	if (r_array != NULL) {
  		set_count = stream_array_to_fd_set(r_array, &rfds, &max_fd TSRMLS_CC);
  		if (set_count > max_set_count)
  			max_set_count = set_count;
  		sets += set_count;
  	}
  
  	if (w_array != NULL) {
  		set_count = stream_array_to_fd_set(w_array, &wfds, &max_fd TSRMLS_CC);
  		if (set_count > max_set_count)
  			max_set_count = set_count;
  		sets += set_count;
  	}
  
  	if (e_array != NULL) {
  		set_count = stream_array_to_fd_set(e_array, &efds, &max_fd TSRMLS_CC);
  		if (set_count > max_set_count)
  			max_set_count = set_count;
  		sets += set_count;
  	}
  
  	if (!sets) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "No stream arrays were passed");
  		RETURN_FALSE;
  	}
  
  	PHP_SAFE_MAX_FD(max_fd, max_set_count);
  
  	/* If seconds is not set to null, build the timeval, else we wait indefinitely */
  	if (sec != NULL) {
  		convert_to_long_ex(sec);
  
  		if (Z_LVAL_PP(sec) < 0) {
  			php_error_docref(NULL TSRMLS_CC, E_WARNING, "The seconds parameter must be greater than 0");
  			RETURN_FALSE;
  		} else if (usec < 0) {
  			php_error_docref(NULL TSRMLS_CC, E_WARNING, "The microseconds parameter must be greater than 0");
  			RETURN_FALSE;
  		}
  
  		/* Solaris + BSD do not like microsecond values which are >= 1 sec */
  		if (usec > 999999) {
  			tv.tv_sec = Z_LVAL_PP(sec) + (usec / 1000000);
  			tv.tv_usec = usec % 1000000;
  		} else {
  			tv.tv_sec = Z_LVAL_PP(sec);
  			tv.tv_usec = usec;
  		}
  
  		tv_p = &tv;
  	}
  
  	/* slight hack to support buffered data; if there is data sitting in the
  	 * read buffer of any of the streams in the read array, let's pretend
  	 * that we selected, but return only the readable sockets */
  	if (r_array != NULL) {
  
  		retval = stream_array_emulate_read_fd_set(r_array TSRMLS_CC);
  		if (retval > 0) {
  			if (w_array != NULL) {
  				zend_hash_clean(Z_ARRVAL_P(w_array));
  			}
  			if (e_array != NULL) {
  				zend_hash_clean(Z_ARRVAL_P(e_array));
  			}
  			RETURN_LONG(retval);
  		}
  	}
  
  	retval = php_select(max_fd+1, &rfds, &wfds, &efds, tv_p);
  
  	if (retval == -1) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "unable to select [%d]: %s (max_fd=%d)",
  				errno, strerror(errno), max_fd);
  		RETURN_FALSE;
  	}
  
  	if (r_array != NULL) stream_array_from_fd_set(r_array, &rfds TSRMLS_CC);
  	if (w_array != NULL) stream_array_from_fd_set(w_array, &wfds TSRMLS_CC);
  	if (e_array != NULL) stream_array_from_fd_set(e_array, &efds TSRMLS_CC);
  
  	RETURN_LONG(retval);
  }
  /* }}} */
  
  /* {{{ stream_context related functions */
  static void user_space_stream_notifier(php_stream_context *context, int notifycode, int severity,
  		char *xmsg, int xcode, size_t bytes_sofar, size_t bytes_max, void * ptr TSRMLS_DC)
  {
  	zval *callback = (zval*)context->notifier->ptr;
  	zval *retval = NULL;
  	zval zvs[6];
  	zval *ps[6];
  	zval **ptps[6];
  	int i;
  
  	for (i = 0; i < 6; i++) {
  		INIT_ZVAL(zvs[i]);
  		ps[i] = &zvs[i];
  		ptps[i] = &ps[i];
  		MAKE_STD_ZVAL(ps[i]);
  	}
  
  	ZVAL_LONG(ps[0], notifycode);
  	ZVAL_LONG(ps[1], severity);
  	if (xmsg) {
  		ZVAL_STRING(ps[2], xmsg, 1);
  	} else {
  		ZVAL_NULL(ps[2]);
  	}
  	ZVAL_LONG(ps[3], xcode);
  	ZVAL_LONG(ps[4], bytes_sofar);
  	ZVAL_LONG(ps[5], bytes_max);
  
  	if (FAILURE == call_user_function_ex(EG(function_table), NULL, callback, &retval, 6, ptps, 0, NULL TSRMLS_CC)) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "failed to call user notifier");
  	}
  	for (i = 0; i < 6; i++) {
  		zval_ptr_dtor(&ps[i]);
  	}
  	if (retval) {
  		zval_ptr_dtor(&retval);
  	}
  }
  
  static void user_space_stream_notifier_dtor(php_stream_notifier *notifier)
  {
  	if (notifier && notifier->ptr) {
  		zval_ptr_dtor((zval **)&(notifier->ptr));
  		notifier->ptr = NULL;
  	}
  }
  
  static int parse_context_options(php_stream_context *context, zval *options TSRMLS_DC)
  {
  	HashPosition pos, opos;
  	zval **wval, **oval;
  	char *wkey, *okey;
  	uint wkey_len, okey_len;
  	int ret = SUCCESS;
  	ulong num_key;
  
  	zend_hash_internal_pointer_reset_ex(Z_ARRVAL_P(options), &pos);
  	while (SUCCESS == zend_hash_get_current_data_ex(Z_ARRVAL_P(options), (void**)&wval, &pos)) {
  		if (HASH_KEY_IS_STRING == zend_hash_get_current_key_ex(Z_ARRVAL_P(options), &wkey, &wkey_len, &num_key, 0, &pos)
  				&& Z_TYPE_PP(wval) == IS_ARRAY) {
  
  			zend_hash_internal_pointer_reset_ex(Z_ARRVAL_PP(wval), &opos);
  			while (SUCCESS == zend_hash_get_current_data_ex(Z_ARRVAL_PP(wval), (void**)&oval, &opos)) {
  
  				if (HASH_KEY_IS_STRING == zend_hash_get_current_key_ex(Z_ARRVAL_PP(wval), &okey, &okey_len, &num_key, 0, &opos)) {
  					php_stream_context_set_option(context, wkey, okey, *oval);
  				}
  				zend_hash_move_forward_ex(Z_ARRVAL_PP(wval), &opos);
  			}
  
  		} else {
  			php_error_docref(NULL TSRMLS_CC, E_WARNING, "options should have the form [\"wrappername\"][\"optionname\"] = $value");
  		}
  		zend_hash_move_forward_ex(Z_ARRVAL_P(options), &pos);
  	}
  
  	return ret;
  }
  
  static int parse_context_params(php_stream_context *context, zval *params TSRMLS_DC)
  {
  	int ret = SUCCESS;
  	zval **tmp;
  
  	if (SUCCESS == zend_hash_find(Z_ARRVAL_P(params), "notification", sizeof("notification"), (void**)&tmp)) {
  
  		if (context->notifier) {
  			php_stream_notification_free(context->notifier);
  			context->notifier = NULL;
  		}
  
  		context->notifier = php_stream_notification_alloc();
  		context->notifier->func = user_space_stream_notifier;
  		context->notifier->ptr = *tmp;
  		Z_ADDREF_P(*tmp);
  		context->notifier->dtor = user_space_stream_notifier_dtor;
  	}
  	if (SUCCESS == zend_hash_find(Z_ARRVAL_P(params), "options", sizeof("options"), (void**)&tmp)) {
  		if (Z_TYPE_PP(tmp) == IS_ARRAY) {
  			parse_context_options(context, *tmp TSRMLS_CC);
  		} else {
  			php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid stream/context parameter");
  		}
  	}
  
  	return ret;
  }
  
  /* given a zval which is either a stream or a context, return the underlying
   * stream_context.  If it is a stream that does not have a context assigned, it
   * will create and assign a context and return that.  */
  static php_stream_context *decode_context_param(zval *contextresource TSRMLS_DC)
  {
  	php_stream_context *context = NULL;
  
  	context = zend_fetch_resource(&contextresource TSRMLS_CC, -1, NULL, NULL, 1, php_le_stream_context(TSRMLS_C));
  	if (context == NULL) {
  		php_stream *stream;
  
  		stream = zend_fetch_resource(&contextresource TSRMLS_CC, -1, NULL, NULL, 2, php_file_le_stream(), php_file_le_pstream);
  
  		if (stream) {
  			context = stream->context;
  			if (context == NULL) {
  				/* Only way this happens is if file is opened with NO_DEFAULT_CONTEXT
  				   param, but then something is called which requires a context.
  				   Don't give them the default one though since they already said they
  	 			   didn't want it. */
  				context = stream->context = php_stream_context_alloc(TSRMLS_C);
  			}
  		}
  	}
  
  	return context;
  }
  /* }}} */
  
  /* {{{ proto array stream_context_get_options(resource context|resource stream)
     Retrieve options for a stream/wrapper/context */
  PHP_FUNCTION(stream_context_get_options)
  {
  	zval *zcontext;
  	php_stream_context *context;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zcontext) == FAILURE) {
  		RETURN_FALSE;
  	}
  	context = decode_context_param(zcontext TSRMLS_CC);
  	if (!context) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid stream/context parameter");
  		RETURN_FALSE;
  	}
  
  	RETURN_ZVAL(context->options, 1, 0);
  }
  /* }}} */
  
  /* {{{ proto bool stream_context_set_option(resource context|resource stream, string wrappername, string optionname, mixed value)
     Set an option for a wrapper */
  PHP_FUNCTION(stream_context_set_option)
  {
  	zval *options = NULL, *zcontext = NULL, *zvalue = NULL;
  	php_stream_context *context;
  	char *wrappername, *optionname;
  	int wrapperlen, optionlen;
  
  	if (zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, ZEND_NUM_ARGS() TSRMLS_CC,
  				"rssz", &zcontext, &wrappername, &wrapperlen,
  				&optionname, &optionlen, &zvalue) == FAILURE) {
  		if (zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, ZEND_NUM_ARGS() TSRMLS_CC,
  					"ra", &zcontext, &options) == FAILURE) {
  			php_error_docref(NULL TSRMLS_CC, E_WARNING, "called with wrong number or type of parameters; please RTM");
  			RETURN_FALSE;
  		}
  	}
  
  	/* figure out where the context is coming from exactly */
  	context = decode_context_param(zcontext TSRMLS_CC);
  	if (!context) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid stream/context parameter");
  		RETURN_FALSE;
  	}
  
  	if (options) {
  		/* handle the array syntax */
  		RETVAL_BOOL(parse_context_options(context, options TSRMLS_CC) == SUCCESS);
  	} else {
  		php_stream_context_set_option(context, wrappername, optionname, zvalue);
  		RETVAL_TRUE;
  	}
  }
  /* }}} */
  
  /* {{{ proto bool stream_context_set_params(resource context|resource stream, array options)
     Set parameters for a file context */
  PHP_FUNCTION(stream_context_set_params)
  {
  	zval *params, *zcontext;
  	php_stream_context *context;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ra", &zcontext, &params) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	context = decode_context_param(zcontext TSRMLS_CC);
  	if (!context) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid stream/context parameter");
  		RETURN_FALSE;
  	}
  
  	RETVAL_BOOL(parse_context_params(context, params TSRMLS_CC) == SUCCESS);
  }
  /* }}} */
  
  /* {{{ proto array stream_context_get_params(resource context|resource stream)
     Get parameters of a file context */
  PHP_FUNCTION(stream_context_get_params)
  {
  	zval *zcontext, *options;
  	php_stream_context *context;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zcontext) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	context = decode_context_param(zcontext TSRMLS_CC);
  	if (!context) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid stream/context parameter");
  		RETURN_FALSE;
  	}
  
  	array_init(return_value);
  	if (context->notifier && context->notifier->ptr && context->notifier->func == user_space_stream_notifier) {
  		add_assoc_zval_ex(return_value, ZEND_STRS("notification"), context->notifier->ptr);
  		Z_ADDREF_P(context->notifier->ptr);
  	}
  	ALLOC_INIT_ZVAL(options);
  	ZVAL_ZVAL(options, context->options, 1, 0);
  	add_assoc_zval_ex(return_value, ZEND_STRS("options"), options);
  }
  /* }}} */
  
  /* {{{ proto resource stream_context_get_default([array options])
     Get a handle on the default file/stream context and optionally set parameters */
  PHP_FUNCTION(stream_context_get_default)
  {
  	zval *params = NULL;
  	php_stream_context *context;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|a", &params) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	if (FG(default_context) == NULL) {
  		FG(default_context) = php_stream_context_alloc(TSRMLS_C);
  	}
  	context = FG(default_context);
  
  	if (params) {
  		parse_context_options(context, params TSRMLS_CC);
  	}
  
  	php_stream_context_to_zval(context, return_value);
  }
  /* }}} */
  
  /* {{{ proto resource stream_context_set_default(array options)
     Set default file/stream context, returns the context as a resource */
  PHP_FUNCTION(stream_context_set_default)
  {
  	zval *options = NULL;
  	php_stream_context *context;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &options) == FAILURE) {
  		return;
  	}
  
  	if (FG(default_context) == NULL) {
  		FG(default_context) = php_stream_context_alloc(TSRMLS_C);
  	}
  	context = FG(default_context);
  
  	parse_context_options(context, options TSRMLS_CC);
  
  	php_stream_context_to_zval(context, return_value);
  }
  /* }}} */
  
  /* {{{ proto resource stream_context_create([array options[, array params]])
     Create a file context and optionally set parameters */
  PHP_FUNCTION(stream_context_create)
  {
  	zval *options = NULL, *params = NULL;
  	php_stream_context *context;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|a!a!", &options, &params) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	context = php_stream_context_alloc(TSRMLS_C);
  
  	if (options) {
  		parse_context_options(context, options TSRMLS_CC);
  	}
  
  	if (params) {
  		parse_context_params(context, params TSRMLS_CC);
  	}
  
  	RETURN_RESOURCE(context->rsrc_id);
  }
  /* }}} */
  
  /* {{{ streams filter functions */
  static void apply_filter_to_stream(int append, INTERNAL_FUNCTION_PARAMETERS)
  {
  	zval *zstream;
  	php_stream *stream;
  	char *filtername;
  	int filternamelen;
  	long read_write = 0;
  	zval *filterparams = NULL;
  	php_stream_filter *filter = NULL;
  	int ret;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rs|lz", &zstream,
  				&filtername, &filternamelen, &read_write, &filterparams) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zstream);
  
  	if ((read_write & PHP_STREAM_FILTER_ALL) == 0) {
  		/* Chain not specified.
  		 * Examine stream->mode to determine which filters are needed
  		 * There's no harm in attaching a filter to an unused chain,
  		 * but why waste the memory and clock cycles?
  		 */
  		if (strchr(stream->mode, 'r') || strchr(stream->mode, '+')) {
  			read_write |= PHP_STREAM_FILTER_READ;
  		}
  		if (strchr(stream->mode, 'w') || strchr(stream->mode, '+') || strchr(stream->mode, 'a')) {
  			read_write |= PHP_STREAM_FILTER_WRITE;
  		}
  	}
  
  	if (read_write & PHP_STREAM_FILTER_READ) {
  		filter = php_stream_filter_create(filtername, filterparams, php_stream_is_persistent(stream) TSRMLS_CC);
  		if (filter == NULL) {
  			RETURN_FALSE;
  		}
  
  		if (append) {
  			ret = php_stream_filter_append_ex(&stream->readfilters, filter TSRMLS_CC);
  		} else {
  			ret = php_stream_filter_prepend_ex(&stream->readfilters, filter TSRMLS_CC);
  		}
  		if (ret != SUCCESS) {
  			php_stream_filter_remove(filter, 1 TSRMLS_CC);
  			RETURN_FALSE;
  		}
  	}
  
  	if (read_write & PHP_STREAM_FILTER_WRITE) {
  		filter = php_stream_filter_create(filtername, filterparams, php_stream_is_persistent(stream) TSRMLS_CC);
  		if (filter == NULL) {
  			RETURN_FALSE;
  		}
  
  		if (append) {
  			ret = php_stream_filter_append_ex(&stream->writefilters, filter TSRMLS_CC);
  		} else {
  			ret = php_stream_filter_prepend_ex(&stream->writefilters, filter TSRMLS_CC);
  		}
  		if (ret != SUCCESS) {
  			php_stream_filter_remove(filter, 1 TSRMLS_CC);
  			RETURN_FALSE;
  		}
  	}
  
  	if (filter) {
  		RETURN_RESOURCE(filter->rsrc_id = ZEND_REGISTER_RESOURCE(NULL, filter, php_file_le_stream_filter()));
  	} else {
  		RETURN_FALSE;
  	}
  }
  /* }}} */
  
  /* {{{ proto resource stream_filter_prepend(resource stream, string filtername[, int read_write[, string filterparams]])
     Prepend a filter to a stream */
  PHP_FUNCTION(stream_filter_prepend)
  {
  	apply_filter_to_stream(0, INTERNAL_FUNCTION_PARAM_PASSTHRU);
  }
  /* }}} */
  
  /* {{{ proto resource stream_filter_append(resource stream, string filtername[, int read_write[, string filterparams]])
     Append a filter to a stream */
  PHP_FUNCTION(stream_filter_append)
  {
  	apply_filter_to_stream(1, INTERNAL_FUNCTION_PARAM_PASSTHRU);
  }
  /* }}} */
  
  /* {{{ proto bool stream_filter_remove(resource stream_filter)
  	Flushes any data in the filter's internal buffer, removes it from the chain, and frees the resource */
  PHP_FUNCTION(stream_filter_remove)
  {
  	zval *zfilter;
  	php_stream_filter *filter;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zfilter) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	filter = zend_fetch_resource(&zfilter TSRMLS_CC, -1, NULL, NULL, 1, php_file_le_stream_filter());
  	if (!filter) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Invalid resource given, not a stream filter");
  		RETURN_FALSE;
  	}
  
  	if (php_stream_filter_flush(filter, 1) == FAILURE) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Unable to flush filter, not removing");
  		RETURN_FALSE;
  	}
  
  	if (zend_list_delete(Z_LVAL_P(zfilter)) == FAILURE) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "Could not invalidate filter, not removing");
  		RETURN_FALSE;
  	} else {
  		php_stream_filter_remove(filter, 1 TSRMLS_CC);
  		RETURN_TRUE;
  	}
  }
  /* }}} */
  
  /* {{{ proto string stream_get_line(resource stream, int maxlen [, string ending])
     Read up to maxlen bytes from a stream or until the ending string is found */
  PHP_FUNCTION(stream_get_line)
  {
  	char *str = NULL;
  	int str_len = 0;
  	long max_length;
  	zval *zstream;
  	char *buf;
  	size_t buf_size;
  	php_stream *stream;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl|s", &zstream, &max_length, &str, &str_len) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	if (max_length < 0) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "The maximum allowed length must be greater than or equal to zero");
  		RETURN_FALSE;
  	}
  	if (!max_length) {
  		max_length = PHP_SOCK_CHUNK_SIZE;
  	}
  
  	php_stream_from_zval(stream, &zstream);
  
  	if ((buf = php_stream_get_record(stream, max_length, &buf_size, str, str_len TSRMLS_CC))) {
  		RETURN_STRINGL(buf, buf_size, 0);
  	} else {
  		RETURN_FALSE;
  	}
  }
  
  /* }}} */
  
  /* {{{ proto bool stream_set_blocking(resource socket, int mode)
     Set blocking/non-blocking mode on a socket or stream */
  PHP_FUNCTION(stream_set_blocking)
  {
  	zval *arg1;
  	int block;
  	long arg2;
  	php_stream *stream;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl", &arg1, &arg2) == FAILURE) {
  		return;
  	}
  
  	php_stream_from_zval(stream, &arg1);
  
  	block = arg2;
  
  	if (php_stream_set_option(stream, PHP_STREAM_OPTION_BLOCKING, block == 0 ? 0 : 1, NULL) == -1) {
  		RETURN_FALSE;
  	}
  
  	RETURN_TRUE;
  }
  
  /* }}} */
  
  /* {{{ proto bool stream_set_timeout(resource stream, int seconds [, int microseconds])
     Set timeout on stream read to seconds + microseonds */
  #if HAVE_SYS_TIME_H || defined(PHP_WIN32)
  PHP_FUNCTION(stream_set_timeout)
  {
  	zval *socket;
  	long seconds, microseconds = 0;
  	struct timeval t;
  	php_stream *stream;
  	int argc = ZEND_NUM_ARGS();
  
  	if (zend_parse_parameters(argc TSRMLS_CC, "rl|l", &socket, &seconds, &microseconds) == FAILURE) {
  		return;
  	}
  
  	php_stream_from_zval(stream, &socket);
  
  	t.tv_sec = seconds;
  
  	if (argc == 3) {
  		t.tv_usec = microseconds % 1000000;
  		t.tv_sec += microseconds / 1000000;
  	} else {
  		t.tv_usec = 0;
  	}
  
  	if (PHP_STREAM_OPTION_RETURN_OK == php_stream_set_option(stream, PHP_STREAM_OPTION_READ_TIMEOUT, 0, &t)) {
  		RETURN_TRUE;
  	}
  
  	RETURN_FALSE;
  }
  #endif /* HAVE_SYS_TIME_H || defined(PHP_WIN32) */
  /* }}} */
  
  /* {{{ proto int stream_set_write_buffer(resource fp, int buffer)
     Set file write buffer */
  PHP_FUNCTION(stream_set_write_buffer)
  {
  	zval *arg1;
  	int ret;
  	long arg2;
  	size_t buff;
  	php_stream *stream;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl", &arg1, &arg2) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &arg1);
  
  	buff = arg2;
  
  	/* if buff is 0 then set to non-buffered */
  	if (buff == 0) {
  		ret = php_stream_set_option(stream, PHP_STREAM_OPTION_WRITE_BUFFER, PHP_STREAM_BUFFER_NONE, NULL);
  	} else {
  		ret = php_stream_set_option(stream, PHP_STREAM_OPTION_WRITE_BUFFER, PHP_STREAM_BUFFER_FULL, &buff);
  	}
  
  	RETURN_LONG(ret == 0 ? 0 : EOF);
  }
  /* }}} */
  
  /* {{{ proto int stream_set_chunk_size(resource fp, int chunk_size)
     Set the stream chunk size */
  PHP_FUNCTION(stream_set_chunk_size)
  {
  	int			ret;
  	long		csize;
  	zval		*zstream;
  	php_stream	*stream;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl", &zstream, &csize) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	if (csize <= 0) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "The chunk size must be a positive integer, given %ld", csize);
  		RETURN_FALSE;
  	}
  	/* stream.chunk_size is actually a size_t, but php_stream_set_option 
  	 * can only use an int to accept the new value and return the old one.
  	 * In any case, values larger than INT_MAX for a chunk size make no sense.
  	 */
  	if (csize > INT_MAX) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "The chunk size cannot be larger than %d", INT_MAX);
  		RETURN_FALSE;
  	}
  	
  	php_stream_from_zval(stream, &zstream);
  
  	ret = php_stream_set_option(stream, PHP_STREAM_OPTION_SET_CHUNK_SIZE, (int)csize, NULL);
  	
  	RETURN_LONG(ret > 0 ? (long)ret : (long)EOF);
  }
  /* }}} */
  
  /* {{{ proto int stream_set_read_buffer(resource fp, int buffer)
     Set file read buffer */
  PHP_FUNCTION(stream_set_read_buffer)
  {
  	zval *arg1;
  	int ret;
  	long arg2;
  	size_t buff;
  	php_stream *stream;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl", &arg1, &arg2) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &arg1);
  
  	buff = arg2;
  
  	/* if buff is 0 then set to non-buffered */
  	if (buff == 0) {
  		ret = php_stream_set_option(stream, PHP_STREAM_OPTION_READ_BUFFER, PHP_STREAM_BUFFER_NONE, NULL);
  	} else {
  		ret = php_stream_set_option(stream, PHP_STREAM_OPTION_READ_BUFFER, PHP_STREAM_BUFFER_FULL, &buff);
  	}
  
  	RETURN_LONG(ret == 0 ? 0 : EOF);
  }
  /* }}} */
  
  /* {{{ proto int stream_socket_enable_crypto(resource stream, bool enable [, int cryptokind [, resource sessionstream]])
     Enable or disable a specific kind of crypto on the stream */
  PHP_FUNCTION(stream_socket_enable_crypto)
  {
  	long cryptokind = 0;
  	zval *zstream, *zsessstream = NULL;
  	php_stream *stream, *sessstream = NULL;
  	zend_bool enable;
  	int ret;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rb|lr", &zstream, &enable, &cryptokind, &zsessstream) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zstream);
  
  	if (ZEND_NUM_ARGS() >= 3) {
  		if (zsessstream) {
  			php_stream_from_zval(sessstream, &zsessstream);
  		}
  
  		if (php_stream_xport_crypto_setup(stream, cryptokind, sessstream TSRMLS_CC) < 0) {
  			RETURN_FALSE;
  		}
  	} else if (enable) {
  		php_error_docref(NULL TSRMLS_CC, E_WARNING, "When enabling encryption you must specify the crypto type");
  		RETURN_FALSE;
  	}
  
  	ret = php_stream_xport_crypto_enable(stream, enable TSRMLS_CC);
  	switch (ret) {
  		case -1:
  			RETURN_FALSE;
  
  		case 0:
  			RETURN_LONG(0);
  
  		default:
  			RETURN_TRUE;
  	}
  }
  /* }}} */
  
  /* {{{ proto string stream_resolve_include_path(string filename)
  Determine what file will be opened by calls to fopen() with a relative path */
  PHP_FUNCTION(stream_resolve_include_path)
  {
  	char *filename, *resolved_path;
  	int filename_len;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &filename, &filename_len) == FAILURE) {
  		return;
  	}
  
  	resolved_path = zend_resolve_path(filename, filename_len TSRMLS_CC);
  
  	if (resolved_path) {
  		RETURN_STRING(resolved_path, 0);
  	}
  	RETURN_FALSE;
  }
  /* }}} */
  
  /* {{{ proto bool stream_is_local(resource stream|string url) U
  */
  PHP_FUNCTION(stream_is_local)
  {
  	zval **zstream;
  	php_stream *stream = NULL;
  	php_stream_wrapper *wrapper = NULL;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "Z", &zstream) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	if (Z_TYPE_PP(zstream) == IS_RESOURCE) {
  		php_stream_from_zval(stream, zstream);
  		if (stream == NULL) {
  			RETURN_FALSE;
  		}
  		wrapper = stream->wrapper;
  	} else {
  		convert_to_string_ex(zstream);
  
  		wrapper = php_stream_locate_url_wrapper(Z_STRVAL_PP(zstream), NULL, 0 TSRMLS_CC);
  	}
  
  	if (!wrapper) {
  		RETURN_FALSE;
  	}
  
  	RETURN_BOOL(wrapper->is_url==0);
  }
  /* }}} */
  
  /* {{{ proto bool stream_supports_lock(resource stream)
     Tells whether the stream supports locking through flock(). */
  PHP_FUNCTION(stream_supports_lock)
  {
  	php_stream *stream;
  	zval *zsrc;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zsrc) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zsrc);
  
  	if (!php_stream_supports_lock(stream)) {
  		RETURN_FALSE;
  	}
  
  	RETURN_TRUE;
  }
  
  #ifdef HAVE_SHUTDOWN
  /* {{{ proto int stream_socket_shutdown(resource stream, int how)
  	causes all or part of a full-duplex connection on the socket associated
  	with stream to be shut down.  If how is SHUT_RD,  further receptions will
  	be disallowed. If how is SHUT_WR, further transmissions will be disallowed.
  	If how is SHUT_RDWR,  further  receptions and transmissions will be
  	disallowed. */
  PHP_FUNCTION(stream_socket_shutdown)
  {
  	long how;
  	zval *zstream;
  	php_stream *stream;
  
  	if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "rl", &zstream, &how) == FAILURE) {
  		RETURN_FALSE;
  	}
  
  	if (how != STREAM_SHUT_RD &&
  	    how != STREAM_SHUT_WR &&
  	    how != STREAM_SHUT_RDWR) {
  		RETURN_FALSE;
  	}
  
  	php_stream_from_zval(stream, &zstream);
  
  	RETURN_BOOL(php_stream_xport_shutdown(stream, (stream_shutdown_t)how TSRMLS_CC) == 0);
  }
  /* }}} */
  #endif
  
  /*
   * Local variables:
   * tab-width: 4
   * c-basic-offset: 4
   * End:
   * vim600: noet sw=4 ts=4 fdm=marker
   * vim<600: noet sw=4 ts=4
   */
  
  