5.2.8 Socket management

The functions described in this section deal with the creation, destruction and other simple operations on socket structures called svz_socket_t. See the description of each function for details on which kind of socket it can handle and what they are for.

Function: int svz_sock_nconnections (void)

Return the number of currently connected sockets.

Function: int svz_sock_write (svz_socket_t *sock, char *buf, int len)

Write len bytes from the memory location pointed to by buf to the output buffer of the socket sock. Also try to flush the buffer to the socket of sock if possible. Return a non-zero value on error, which normally means a buffer overflow.

Function: int svz_sock_printf (svz_socket_t *sock, const char *fmt, …)

Print a formatted string on the socket sock. fmt is the printf-style format string, which describes how to format the optional arguments.

Function: int svz_sock_resize_buffers (svz_socket_t *sock, int send_buf_size, int recv_buf_size)

Resize the send and receive buffers for the socket sock. send_buf_size is the new size for the send buffer, recv_buf_size for the receive buffer. Note that data may be lost when the buffers shrink. For a new buffer size of 0 the buffer is freed and the pointer set to NULL.

Function: int svz_sock_check_request (svz_socket_t *sock)

Check for the kind of packet delimiter within sock and and assign one of the default check_request routines (one or more byte delimiters or a fixed size).

Afterwards this function will never ever be called again because the callback gets overwritten here.

Function: void svz_sock_reduce_recv (svz_socket_t *sock, int len)

Shorten the receive buffer of sock by len bytes.

Function: void svz_sock_reduce_send (svz_socket_t *sock, int len)

Reduce the send buffer of sock by len bytes.