IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

This API function makes it possible to read options associated with a socket.
Prior to calling this function, the caller must fill in a GetSocketOption type data structure.
The user must set the protocol_level and optionName members. Also the pointer optionValue must
point to a valid buffer in the user application's memory.
The optionLength member is both an input and an output parameter. The length of the buffer must be
specified at the location referenced by optionLength and this length must be sufficient for the size of the
requested option data. On success, this API writes to the optionLength location the number of bytes output
to the optionValue buffer.
The socket options of an incoming connection (using accept) will be the same as the socket options from its
listening socket.
Related Topics
Top of list
Index page
GetSocketOption typedef with option names
API_SETSOCKOPT - Set socket options
Interrupt 0xAC service 0x18: API_SETBLOCKINGMODE, Set socket mode
Parameters
AH
AL
BX
Sets a socket in blocking or non-blocking mode
0x18 (= API_SETBLOCKINGMODE)
0: switch blocking off, 1: switch blocking on
Socket descriptor
Return Value
Comments
Top of list
Index page
DX = 0 success
DX != 0 failure, AX: contains error code
By default all sockets are in blocking mode. If a socket is set to non-blocking mode, socket calls like
CONNECT, ACCEPT, ... do not wait until full completion. They will instead return immediately.
Example usage of non-blocking mode:
The connectcall returns for a non-blocking socket with -1 in DX and error code 236 if the connection
was not completed. The user can call connect within a loop, periodically polling for connection
completion condition while performing some other activity.
Page 120 / 400