NetSock_CfgBlock

Configure a socket’s blocking mode.

Files

net_sock.h/net_sock.c

Prototype

          CPU_BOOLEAN NetSock_CfgBlock(NET_SOCK_ID  sock_id,
                                       CPU_INT08U   block,
                                       NET_ERR     *p_err);

Arguments

sock_id

This is the socket ID returned by NetSock_Open()/socket() when the socket was created or by NetSock_Accept()/accept() when a connection was accepted.

block

Desired value for socket blocking mode:

NET_SOCK_BLOCK_SEL_DFLT      Socket operations will block
NET_SOCK_BLOCK_SEL_BLOCK     Socket operations will block
NET_SOCK_BLOCK_SEL_NO_BLOCK  Socket operations will not block

p_err

Pointer to variable that will receive the return error code from this function:

NET_SOCK_ERR_NONE
NET_SOCK_ERR_NOT_USED
NET_SOCK_ERR_INVALID_SOCK
NET_SOCK_ERR_INVALID_ARG
NET_INIT_ERR_NOT_COMPLETED
NET_ERR_FAULT_LOCK_ACQUIRE

Returned Value

DEF_OK,

Socket blocking mode successfully configured;

DEF_FAIL,

otherwise.

Required Configuration

None.

Notes / Warnings

None.