Skip to content

async: report the ABI version the header defines, and state the awaited writev's contract #26

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
EdmondDantes merged 2 commits into from
Aug 21, 2026
Merged

async: report the ABI version the header defines, and state the awaited writev's contract #26

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bbaa03a
fix(async): the ABI banner still said v0.24.0 after the 0.25 bump
EdmondDantes Aug 20, 2026
f421d68
docs(async): the writev slot limit, the nbufs == 0 return, and what d…
EdmondDantes Aug 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions Zend/zend_async_API.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
#include "zend_globals.h"
#include "zend_stream.h"

#define ZEND_ASYNC_API "TrueAsync ABI v0.24.0"
#define ZEND_ASYNC_API "TrueAsync ABI v0.25.0"
#define ZEND_ASYNC_API_VERSION_MAJOR 0
#define ZEND_ASYNC_API_VERSION_MINOR 25
#define ZEND_ASYNC_API_VERSION_PATCH 0
Expand Down Expand Up @@ -595,7 +595,7 @@ typedef zend_async_io_req_t *(*zend_async_io_write_t)(zend_async_io_t *io, const
* `bufs` is `zend_string * const *`. Each entry is an OWNED ref; the
* reactor calls zend_string_release() on each on completion. free_cb /
* user_data are ignored. Caller bumps refcount before passing if it
* needs to keep its own reference.
* needs to keep its own reference. At most 65535 entries per call.
*
* ZEND_ASYNC_IO_WRITEV_IOV:
* `bufs` is `const zend_async_buf_t *` — array of (base, len) descriptors
Expand All @@ -606,7 +606,8 @@ typedef zend_async_io_req_t *(*zend_async_io_write_t)(zend_async_io_t *io, const
*
* Buffer ordering on the wire matches array order. Returns NULL on submit
* failure (in which case the reactor has already released / freed every
* entry per the mode's contract). */
* entry per the mode's contract). nbufs == 0 is the one NULL without an
* exception: nothing submitted, nothing consumed, free_cb run once in IOV. */
#define ZEND_ASYNC_IO_WRITEV_ZSTR 0u
#define ZEND_ASYNC_IO_WRITEV_IOV 1u
/* The mode is the low bit of the flag word; the bits above it carry behaviour. */
Expand All @@ -618,7 +619,10 @@ typedef zend_async_io_req_t *(*zend_async_io_write_t)(zend_async_io_t *io, const
*
* An awaiter must treat a handle-level notification (result NULL, exception
* set) as its wake too: a closing handle broadcasts one and the request is
* never completed in that case. Available from API version 0.25. */
* never completed in that case.
*
* Disposal is safe after the handle is gone: the completion drops the request's
* link to it before handing it over. Available from API version 0.25. */
#define ZEND_ASYNC_IO_WRITEV_AWAIT (1u << 1)
typedef zend_async_io_req_t *(*zend_async_io_writev_t)(zend_async_io_t *io,
const void *bufs, unsigned nbufs, uint32_t flags,
Expand Down
Loading