@CHIP-RTOS C Library - TCP/IP API

listen_bsd

Listen for incoming connections.

int far listen_bsd ( int sd,
                     int backlog ) ;

Parameters

sd

Socket descriptor

backlog

The maximum number (limited to 5) of allowed outstanding connections.

Return Value

0 on success
-1: Failure, error code is available using get_socketerror.

Comments

This API function places the socket in passive mode and sets the number of incoming TCP connections that the system will queue (backlog ).

This call is used by a TCP server.

If the compilation switch

     #define BSD44_SOCKET_API_STYLE

is set as a global define in the user application prior to including the Beck C-library header files, the listen() call can be used in BSD 4.4 compatible style with the parameters specified above.   Using this switch the CLIB TCPIP_Socket.H redefines listen() to listen_bsd() .

See Also

accept_bsd        opensocket        opensocket_ext
listen        get_socketerror        

RTOS API

On the first call, this library function invokes a software interrupt which modifies the code at the calling site inside your application program.   A direct FAR JMP into the @CHIP-RTOS-x86 implementation for this function is installed so that on return and on any subsequent calls to this API this dynamic link reaches the function's implementation directly.

Supported since or modified in @CHIP-RTOS version

SC12	SC13	SC11	SC1x3	SC2x
n/a	n/a	n/a	V1.36	V1.36

Supported by @CHIP-RTOS C Library since version

CLIB
V2.20