Summary
Create a fifo.
Declaration
#include <zircon/syscalls.h>
zx_status_t zx_fifo_create(size_t elem_count,
size_t elem_size,
uint32_t options,
zx_handle_t* out0,
zx_handle_t* out1);
Description
zx_fifo_create() creates a fifo, which is actually a pair of fifos
of elem_count entries of elem_size bytes. Two endpoints are
returned. Writing to one endpoint enqueues an element into the fifo
that the opposing endpoint reads from.
Fifos are intended to be the control plane for shared memory transports. Their read and write operations are more efficient than sockets or channels, but there are severe restrictions on the size of elements and buffers.
The total size of each fifo (elem_count * elem_size) may not exceed 4096 bytes.
The options argument must be 0.
Rights
Caller job policy must allow ZX_POL_NEW_FIFO.
Return value
zx_fifo_create() returns ZX_OK on success. In the event of
failure, one of the following values is returned.
Errors
ZX_ERR_INVALID_ARGS out0 or out1 is an invalid pointer or NULL or
options is any value other than 0.
ZX_ERR_OUT_OF_RANGE elem_count or elem_size is zero, or
elem_count * elem_size is greater than 4096.
ZX_ERR_NO_MEMORY Failure due to lack of memory.
There is no good way for userspace to handle this (unlikely) error.
In a future build this error will no longer occur.