docs/syscalls/channel_create.md

# zx_channel_create

## NAME

channel_create - create a channel

## SYNOPSIS

```
#include <zircon/syscalls.h>

zx_status_t zx_channel_create(uint32_t options,
                              zx_handle_t* out0, zx_handle_t* out1);

```

## DESCRIPTION

**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 *ZX_RIGHT_TRANSFER* (allowing them to be sent
to another process via channel write), *ZX_RIGHT_WRITE* (allowing
messages to be written to them), and *ZX_RIGHT_READ* (allowing messages
to be read from them).


## RETURN VALUE

**channel_create**() returns **ZX_OK** on success. In the event
of failure, a negative error value 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_NO_MEMORY**  (Temporary) Failure due to lack of memory.

## SEE ALSO

[handle_close](handle_close.md),
[handle_duplicate](handle_duplicate.md),
[handle_replace](handle_replace.md),
[object_wait_one](object_wait_one.md),
[object_wait_many](object_wait_many.md),
[channel_call](channel_call.md),
[channel_read](channel_read.md),
[channel_write](channel_write.md).