Man page - wslay_event_recv(3)
Packages contains this manual
- wslay_event_recv(3)
- wslay_event_context_free(3)
- wslay_event_set_error(3)
- wslay_event_queue_msg_ex(3)
- wslay_event_shutdown_write(3)
- wslay_event_queue_fragmented_msg_ex(3)
- wslay_event_get_status_code_received(3)
- wslay_event_shutdown_read(3)
- wslay_event_get_status_code_sent(3)
- wslay_event_queue_fragmented_msg(3)
- wslay_event_queue_msg(3)
- wslay_event_queue_close(3)
- wslay_event_get_read_enabled(3)
- wslay_event_get_close_sent(3)
- wslay_event_config_set_max_recv_msg_length(3)
- wslay_event_get_close_received(3)
- wslay_event_context_client_init(3)
- wslay_event_get_queued_msg_count(3)
- wslay_event_context_server_init(3)
- wslay_event_config_set_no_buffering(3)
- wslay_event_want_write(3)
- wslay_event_get_queued_msg_length(3)
- wslay_event_want_read(3)
- wslay_event_config_set_callbacks(3)
- wslay_event_get_write_enabled(3)
- wslay_event_config_set_allowed_rsv_bits(3)
- wslay_event_send(3)
apt-get install libwslay-doc
Manual
WSLAY_EVENT_RECV
NAMESYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
AUTHOR
COPYRIGHT
NAME
wslay_event_recv - Receive messages
SYNOPSIS
#include
<wslay/wslay.h>
int wslay_event_recv(wslay_event_context_ptr ctx)
DESCRIPTION
wslay_event_recv() receives messages from peer. When receiving messages, it uses wslay_event_recv_callback function. Single call of this function receives multiple messages until wslay_event_recv_callback function sets error code WSLAY_ERR_WOULDBLOCK .
wslay_event_recv()
calls following callback functions for their own event (See
wslay_event_context_server_init()
or
wslay_event_context_client_init()
for the details of
each callbacks).
wslay_event_on_frame_recv_start_callback
Called when a new frame starts to be received.
wslay_event_on_frame_recv_start_callback
Called when a new frame starts to be received.
wslay_event_on_frame_recv_chunk_callback
Called when a chunk of frame payload is received.
wslay_event_on_frame_recv_end_callback
Called when a frame is completely received.
wslay_event_on_msg_recv_callback
Called when a message is completely received.
When close control frame is received, this function automatically queues close control frame. Also this function calls wslay_event_set_read_enabled() with second argument 0 to disable further read from peer.
When ping control frame is received, this function automatically queues pong control frame.
In case of a fatal error which leads to negative return code, this function calls wslay_event_set_read_enabled() with second argument 0 to disable further read from peer.
RETURN VALUE
wslay_event_recv()
returns 0 if it succeeds, or one of the following negative
error codes:
WSLAY_ERR_CALLBACK_FAILURE
User defined callback function is failed.
WSLAY_ERR_NOMEM
Out of memory.
When negative error code is returned, application must not make any further call of wslay_event_recv() and must close WebSocket connection.
SEE ALSO
wslay_event_set_read_enabled()
AUTHOR
Tatsuhiro Tsujikawa
COPYRIGHT
2023, 2015, Tatsuhiro Tsujikawa