package.xml

<?xml version="1.0" encoding="UTF-8"?>
<package xmlns="http://pear.php.net/dtd/package-2.0" xmlns:tasks="http://pear.php.net/dtd/tasks-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0" xsi:schemaLocation="http://pear.php.net/dtd/tasks-1.0 http://pear.php.net/dtd/tasks-1.0.xsd http://pear.php.net/dtd/package-2.0 http://pear.php.net/dtd/package-2.0.xsd">
  <name>eio</name>
  <channel>pecl.php.net</channel>
  <summary>Provides interface to the libeio library</summary>
  <description>
    This extension provides interface to the libeio library written by Marc Lehmann
    &lt;libeio at schmorp dot de&gt;(see http://software.schmorp.de/pkg/libeio.html).

    Libeio is a an asynchronous I/O library. Features basically include
    asynchronous versions of POSIX API(read, write, open, close, stat, unlink,
    fdatasync, mknod, readdir etc.); sendfile (native on Solaris, Linux, HP-UX,
    FreeBSD); readahead. libeio itself emulates the system calls, if they are not
    available on specific(UNIX-like) platform.

    Currently this extension supports GNU/Linux and BSD platforms only. But you can
    try it on any UNIX OS.
  </description>
  <lead>
    <name>Ruslan Osmanov</name>
    <user>osmanov</user>
    <email>osmanov@php.net</email>
    <active>yes</active>
  </lead>
  <date>2024-03-02</date>
  <!--{{{ Current version -->
  <version>
    <release>3.1.3</release>
    <api>3.1.0</api>
  </version>
  <stability>
    <release>stable</release>
    <api>stable</api>
  </stability>
  <license uri="http://www.php.net/license">php</license>
  <notes>
    - Fixed #23: Replace struct stat symbols (thanks to Peter Kokot).
  </notes>
  <!--}}}-->
  <!--{{{ contents -->
  <contents>
    <dir name="/">
      <file role="doc" name="CREDITS"/>
      <file role="doc" name="INSTALL.md"/>
      <file role="doc" name="LICENSE"/>
      <file role="doc" name="README.md"/>
      <file role="src" name="config.m4"/>
      <dir name="libeio">
        <file role="doc" name="LICENSE"/>
        <file role="doc" name="Changes"/>
        <file role="src" name="ecb.h"/>
        <file role="src" name="eio.c"/>
        <file role="src" name="eio.h"/>
        <file role="src" name="etp.c"/>
        <file role="src" name="xthread.h"/>
        <file role="src" name="libeio.m4"/>
      </dir>
      <dir name="tests">
        <file role="test" name="bug65293.phpt"/>
        <file role="test" name="eio001.phpt"/>
        <file role="test" name="eio_cancel_basic.phpt"/>
        <file role="test" name="eio_chmod_basic.phpt"/>
        <file role="test" name="eio_chown_variation.phpt"/>
        <file role="test" name="eio_custom_basic.phpt"/>
        <file role="test" name="eio_fallocate_basic.phpt"/>
        <file role="test" name="eio_grp_add.phpt"/>
        <file role="test" name="eio_link.phpt"/>
        <file role="test" name="eio_mkdir_basic.phpt"/>
        <file role="test" name="eio_mknod_basic.phpt"/>
        <file role="test" name="eio_open_basic.phpt"/>
        <file role="test" name="eio_open_error.phpt"/>
        <file role="test" name="eio_read_basic.phpt"/>
        <file role="test" name="eio_readdir.phpt"/>
        <file role="test" name="eio_rename_basic.phpt"/>
        <file role="test" name="eio_rmdir_basic.phpt"/>
        <file role="test" name="eio_seek.phpt"/>
        <file role="test" name="eio_sendfile_basic.phpt"/>
        <file role="test" name="eio_sendfile_sockets.phpt"/>
        <file role="test" name="eio_sendfile_sockets_php8.phpt"/>
        <file role="test" name="eio_stat_basic.phpt"/>
        <file role="test" name="eio_stat_error.phpt"/>
        <file role="test" name="eio_sync.phpt"/>
        <file role="test" name="eio_truncate_basic.phpt"/>
        <file role="test" name="eio_write_variation.phpt"/>
        <file role="test" name="eio_unlink_basic.phpt"/>
        <file role="test" name="eio_utime_basic.phpt"/>
        <file role="test" name="fork.phpt"/>
      </dir>
      <dir name="php5">
        <file role="src" name="php_eio.c"/>
        <file role="src" name="eio_fe.c"/>
        <file role="src" name="eio_fe.h"/>
        <file role="src" name="eio_priv.h"/>
        <file role="src" name="php_eio.h"/>
      </dir>
      <dir name="php7">
        <file role="src" name="php_eio.c"/>
        <file role="src" name="eio_fe.c"/>
        <file role="src" name="eio_fe.h"/>
        <file role="src" name="eio_priv.h"/>
        <file role="src" name="php_eio.h"/>
      </dir>
      <dir name="php8">
        <file role="src" name="eio_priv.h"/>
        <file role="src" name="php_eio.c"/>
        <file role="src" name="php_eio.h"/>
        <file role="src" name="php_eio.stub.php"/>
        <file role="src" name="php_eio_arginfo.h"/>
      </dir>
    </dir>
  </contents>
  <!--}}}-->
  <dependencies>
    <required>
      <php>
        <min>5.3.0</min>
      </php>
      <pearinstaller>
        <min>1.4.0b1</min>
      </pearinstaller>
      <os>
        <name>unix</name>
      </os>
    </required>
  </dependencies>
  <providesextension>eio</providesextension>
  <extsrcrelease>
    <configureoption default="no" name="enable-eio-debug" prompt="Enable internal debugging in Eio"/>
  </extsrcrelease>
  <!--{{{ Changelog-->
  <changelog>
    <!--{{{ 3.1.3 -->
    <release>
      <version>
        <release>3.1.3</release>
        <api>3.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    - Fixed #23: Replace struct stat symbols (thanks to Peter Kokot).
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.1.2 -->
    <release>
      <version>
        <release>3.1.2</release>
        <api>3.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    - Restored libeio/xthread.h in package.xml
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.1.1-->
    <release>
      <version>
        <release>3.1.1</release>
        <api>3.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    - Fixed issue #21: eio_fallocate() tests failed on Fedora 40
    - Updated the embedded libeio.
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.1.0 -->
    <release>
      <version>
        <release>3.1.0</release>
        <api>3.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed issue #19: Initialized new stack pointers introduced in PHP 8.3.0RC1+
    Fixed issue #20: PECL package version
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.1.0 -->
    <release>
      <version>
        <release>3.1.0</release>
        <api>3.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed issue #19: Initialized new stack pointers introduced in PHP 8.3.0RC1+
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.0.0RC5 -->
    <release>
      <version>
        <release>3.0.0RC5</release>
        <api>3.0.0RC1</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed -Wformat-overflow compiliation errors
    Fixed build on s390x arch (thanks to Andy Postnikov).
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.0.0RC4 -->
    <release>
      <version>
        <release>3.0.0RC4</release>
        <api>3.0.0RC1</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed deprecated calls on PHP 8.1 (thanks to Remi Collet).
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.0.0RC3 -->
    <release>
      <version>
        <release>3.0.0RC3</release>
        <api>3.0.0RC1</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed issue #13: libeio sometimes didn't auto-initialize.
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.0.0RC2 -->
    <release>
      <version>
        <release>3.0.0RC2</release>
        <api>3.0.0RC1</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed: the PECL package was broken for PHP 8
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 3.0.0RC1 -->
    <release>
      <version>
        <release>3.0.0RC1</release>
        <api>3.0.0RC1</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
        Ported to PHP 8
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 2.0.3 -->
    <release>
      <version>
        <release>2.0.3</release>
        <api>2.0.1</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed build error in PHP 7.3.
    Removed ASAN from debug configuration.
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 2.0.2 -->
    <release>
      <version>
        <release>2.0.2</release>
        <api>2.0.1</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed build error due to undefined O_FSYNC in musl libc
  </notes>
      <!--}}}-->
    </release>
    <!--{{{ 2.0.1 -->
    <release>
      <version>
        <release>2.0.1</release>
        <api>2.0.1</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed #7: [PHP7] Segfault after shutdown
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 2.0.0 -->
    <release>
      <version>
        <release>2.0.0</release>
        <api>2.0.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed #6: PHP 7.1 build failed due to removed zend_fcall_info.symbol_table
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 2.0.0RC3 -->
    <release>
      <version>
        <release>2.0.0RC3</release>
        <api>2.0.0</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fixed #4: linker issue on aarch64
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 2.0.0RC2 -->
    <release>
      <version>
        <release>2.0.0RC2</release>
        <api>2.0.0</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    - Fix: removed extra memory allocations
    - PHP7: eio_custom now throws Exception in ZTS builds, because Zend API is inaccessible from a custom thread in ZTS PHP7 builds
    (there is a lack of Zend API to access TSRM thread-local data from a user thread). Some extensions(particularly, pthreads)
    invent their own(rather hacky) ways to overcome the problem. However, IMHO, this should be implemented within Zend API itself.
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 2.0.0RC1 -->
    <release>
      <version>
        <release>2.0.0RC1</release>
        <api>1.1.0</api>
      </version>
      <stability>
        <release>beta</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    PHP 7 support
    Fix: uid/gid validation in eio_fchown
    Fix: compilation issue on OS X 10.11
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 1.2.6 -->
    <release>
      <version>
        <release>1.2.6</release>
        <api>1.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fix: uid/gid validation in eio_fchown
    Fix: compilation issue on OS X 10.11
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 1.2.5 -->
    <release>
      <version>
        <release>1.2.5</release>
        <api>1.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fix: Bitbucket issue #2: Static build fails
    Fix: build failed when EVENTFD was not available
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 1.2.4 -->
    <release>
      <version>
        <release>1.2.4</release>
        <api>1.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
    Fix: Bitbucket issue #1: eio_open fails when file is owned by root
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 1.2.3 -->
    <release>
      <version>
        <release>1.2.3</release>
        <api>1.1.0</api>
      </version>
      <stability>
        <release>stable</release>
        <api>stable</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
  Fix: bug #65293 where eio functions failed to process file descriptor equal to 0
  </notes>
    </release>
    <!--}}}-->
    <!--{{{ 1.2.2 -->
    <version>
      <release>1.2.2</release>
      <api>1.1.0</api>
    </version>
    <stability>
      <release>stable</release>
      <api>stable</api>
    </stability>
    <license uri="http://www.php.net/license">php</license>
    <notes>
  Fix: 3rd argument of eio_custom callback assigned as a resource instead of mixed
  Fix: eio_custom used incorrect way of zval-to-zval copying
  </notes>
    <!--}}}-->
    <!--{{{ 1.2.1 -->
    <version>
      <release>1.2.1</release>
      <api>1.1.0</api>
    </version>
    <stability>
      <release>stable</release>
      <api>stable</api>
    </stability>
    <license uri="http://www.php.net/license">php</license>
    <notes>
    Fix: build failed without sockets extension
    Fix: eio_write failed when buffer length was lesser than size + offset
  </notes>
    <!--}}}-->
    <!--{{{ 1.2.0 -->
    <version>
      <release>1.2.0</release>
      <api>1.1.0</api>
    </version>
    <stability>
      <release>stable</release>
      <api>stable</api>
    </stability>
    <license uri="http://www.php.net/license">php</license>
    <notes>
    Add: BSD support
    Change: internal event notification uses pipe() when eventfd() is not available.
    Del: some redundant code
    Fix: use libeio's EIO_FALLOC_FL_KEEP_SIZE instead of the system constant
  </notes>
    <!--}}}-->
    <!--{{{ 1.1.0 -->
    <version>
      <release>1.1.0</release>
      <api>1.1.0</api>
    </version>
    <stability>
      <release>stable</release>
      <api>stable</api>
    </stability>
    <license uri="http://www.php.net/license">php</license>
    <notes>
    Change: eio_init() deprecated. Will be removed in future. We use pthread_atfork() to re-init eio after a fork
    Add: phpt test for the fork support
    Fix: tsrm_ls is not initialized in php_eio_init()
    Fix: EFD_NONBLOCK and EFD_CLOEXEC used despite the flags were not available until kernel 2.6.7. For the old kernels we call fcntl.
    Refact: set FD_CLOEXEC flag for file descriptor opened with eio_open()
    Refact: no need to copy zval when passing request resource to eio_grp_*()
    Fix: eio_grp_*() didn't initialize eio automatically
  </notes>
    <!--}}}-->
    <!--{{{ 1.0.0 -->
    <version>
      <release>1.0.0</release>
      <api>1.0.0</api>
    </version>
    <stability>
      <release>stable</release>
      <api>stable</api>
    </stability>
    <license uri="http://www.php.net/license">php</license>
    <notes>
      Fix: eio_write() wrote garbage when 'str' arg passed by ref in a nested call with 'use' keyword
      Fix: eio_write() wrote garbage when 'str' arg passed by value
      Add: eio_init(). You must call eio_init() before using Eio in a forked child process.
      Change: Cut 'st_' prefix in result of eio_*stat for the sake of simplicity and better 'compatability' with stat()
      Change: Cut 'f_' prefix in result of eio_*statvfs
      Add: eio_get_last_error()
      Add: eio_req resource argument as the third optional callback argument
      Add: phpt tests for the changes since 0.5.0b
      Removed: warnings having no much sense even in debug mode
      Refact: no separation for callbacks
    </notes>
    <!--}}}-->
    <!--{{{ 0.5.0 (beta) -->
    <version>
      <release>0.5.0</release>
      <api>0.5.0</api>
    </version>
    <stability>
      <release>beta</release>
      <api>stable</api>
    </stability>
    <license uri="http://www.php.net/license">php</license>
    <notes>
      Refact: libeio upgraded
      Fix: bug #62392 where eio_*stat functions didn't return st_size
      Fix: package.xml referenced to some nonexistent files
      Fix: garbage in result arg of the callbacks in case of error
      Change: warn about failed op in cb only when compiled with debug support
      Add: test for stat on nonexistent files
      Add: sockets support(eio_sendfile, eio_readahead etc.), enabled by default
      Add: eio_seek function
      Change: numeric fd arguments are now mixed(stream, Socket, or number)
    </notes>
    <!--}}}-->
    <!--{{{ 0.4.0 (beta) -->
    <release>
      <version>
        <release>0.4.0</release>
        <api>0.4.0</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
        Change: libeio is now embedded, no need to install it separately
        Change: functions call info and call info cache used instead of zvals
        Fix: segmentation fault on 32-bit platforms with the default 4-bit LFS
      </notes>
    </release>
    <!--}}}-->
    <!--{{{ 0.3.1 (beta) -->
    <release>
      <version>
        <release>0.3.1</release>
        <api>0.3.1</api>
      </version>
      <stability>
        <release>beta</release>
        <api>beta</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
        Change: eio_get_event_stream returns stream resource
        Fix: package dependencies didn't allow pecl install eio-alpha
        Fix: redundant MS/NETWARE platform checks
      </notes>
    </release>
    <!--}}}-->
    <!-- {{{ 0.3.0 (alpha) -->
    <release>
      <version>
        <release>0.3.0</release>
        <api>0.3.0</api>
      </version>
      <stability>
        <release>alpha</release>
        <api>alpha</api>
      </stability>
      <license uri="http://www.php.net/license">php</license>
      <notes>
        Change: mutex switch that used in communications with libeio replaced with
        eventfd; the same descriptor exported to userspace to bind with existing
        event loops
        Add: eio_get_eventfd function to get eventfd descriptor
        Add: header checks in configuration
        Change: libeio initialization moved to the MINIT phase, but unfinished
        requests are still handled in the RSHUTDOWN phase
        Change: simplified libeio callbacks
      </notes>
    </release>
    <!--}}}-->
    <!--{{{ 0.2.0 (alpha) -->
    <release>
      <version>
        <release>0.2.0</release>
        <api>0.2.0</api>
      </version>
      <stability>
        <release>alpha</release>
        <api>alpha</api>
      </stability>
      <license uri="http://www.php.net/license">PHP</license>
      <notes>
        Fix: heavy bulk requests damaged event loop causing much CPU consumption
        Fix: in a threaded SAPI libeio in a single process might initialize mutex multiple times
        Change: switch from semaphore to mutex
        Change: dropped --with-eio-shm* configuration options
      </notes>
    </release>
    <!--}}}-->
    <!--{{{ 0.1.1 (alpha) -->
    <release>
      <version>
        <release>0.1.1</release>
        <api>0.1.1</api>
      </version>
      <stability>
        <release>alpha</release>
        <api>alpha</api>
      </stability>
      <license uri="http://www.php.net/license">PHP</license>
      <notes>
        Fix: eio_poll had been out of sync with the IPC
        Fix: pathnames in tests
        Change: dropped preprocessor checks on non-UNIX platforms, i.e. no plans to
        support non-UNIX
      </notes>
    </release>
    <!--}}}-->
    <!--{{{ 0.1.0 (alpha) -->
    <release>
      <version>
        <release>0.1.0</release>
        <api>0.1.0</api>
      </version>
      <stability>
        <release>alpha</release>
        <api>alpha</api>
      </stability>
      <license uri="http://www.php.net/license">PHP</license>
      <notes>
        Change: refactored some tests
        Add: request types have readable values in error messages
        Add: errno replaced with the meaningful string in error messages
        Fix: eio_chown denied uid -1 value
        Fix: message about required libeio
      </notes>
    </release>
    <!--}}}-->
    <!--{{{ 0.0.1 (alpha) -->
    <release>
      <version>
        <release>0.0.1</release>
        <api>0.0.1</api>
      </version>
      <stability>
        <release>alpha</release>
        <api>alpha</api>
      </stability>
      <license uri="http://www.php.net/license">PHP</license>
      <notes>
        Change: Shared memory permissions are set to 0660 by default
        Change: Removed redundant code and comments
        Add: Tests: eio_read_basic.phpt, eio_stat_basic.phpt
        Fix: the package XML
        Fix: docs
      </notes>
    </release>
    <!--}}}-->
    <!--{{{ 0.0.1dev -->
    <release>
      <version>
        <release>0.0.1dev</release>
        <api>0.0.1dev</api>
      </version>
      <stability>
        <release>devel</release>
        <api>devel</api>
      </stability>
      <license uri="http://www.php.net/license">PHP</license>
      <notes>
        Initial development release.
      </notes>
    </release>
    <!--}}}-->
  </changelog>
  <!--}}}-->
</package>
<!--
vim: et sts=2 ts=2 sw=2 fdm=marker
-->