Create a channel.
#include <zircon/syscalls.h> zx_status_t zx_channel_create(uint32_t options, zx_handle_t* out0, zx_handle_t* out1);
zx_channel_create()
creates a channel, a bi-directional datagram-style message transport capable of sending raw data bytes as well as handles from one side to the other.
Two handles are returned on success, providing access to both sides of the channel. Messages written to one handle may be read from the opposite.
The handles will have these rights:
ZX_RIGHT_TRANSFER
: allowing them to be sent to another process via zx_channel_write()
.ZX_RIGHT_WAIT
: allowing one to wait for its signals.ZX_RIGHT_INSPECT
ZX_RIGHT_READ
: allowing messages to be read from them.ZX_RIGHT_WRITE
: allowing messages to be written to them.ZX_RIGHT_SIGNAL
ZX_RIGHT_SIGNAL_PEER
Caller job policy must allow ZX_POL_NEW_CHANNEL
.
zx_channel_create()
returns ZX_OK
on success. In the event of failure, a negative error value is returned.
ZX_ERR_INVALID_ARGS
out0 or out1 is an invalid pointer or NULL or options is any value other than 0.
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.