socket

Synchronous socket allocation function based on the specified socket type.

Created sockets are non-blocking and their possible types are either TCP or a UDP sockets. The maximum allowed number of TCP sockets is TCP_SOCK_MAX sockets while the maximum number of UDP sockets that can be created simultaneously is UDP_SOCK_MAX sockets.

Functions
NMI_API SOCKET	socket (uint16 u16Domain, uint8 u8Type, uint8 u8Config)

NMI_API SOCKET socket	(	uint16	u16Domain,
		uint8	u8Type,
		uint8	u8Config
	)

Parameters

[in]	u16Domain	Socket family. The only allowed value is AF_INET (IPv4.0) for TCP/UDP sockets.
[in]	u8Type	Socket type. Allowed values are: SOCK_STREAM SOCK_DGRAM
[in]	u8Config	Used to specify the socket configuration. The following configuration values are defined: SOCKET_CONFIG_SSL_OFF : The socket is not secured by TLS. SOCKET_CONFIG_SSL_ON : The socket is secured by TLS. This value has no effect if u8Type is SOCK_DGRAM. SOCKET_CONFIG_SSL_DELAY : The socket is not secured by TLS, but may be secured later, by calling secure. This value has no effect if u8Type is SOCK_DGRAM. All other configuration values are reserved and should not be used.

Precondition

The socketInit function must be called once at the beginning of the application to initialize the socket handler. before any call to the socket function can be made.

See Also

connect secure bind listen accept recv recvfrom send sendto close setsockopt getsockopt

Returns

On successful socket creation, a non-blocking socket type is created and a socket ID is returned In case of failure the function returns a negative value, identifying one of the socket error codes defined. For example: SOCK_ERR_INVALID for invalid argument or SOCK_ERR_MAX_TCP_SOCK if the number of TCP allocated sockets exceeds the number of available sockets.

Remarks

The socket function must be called a priori to any other related socket functions "e.g. send, recv, close ..etc"

Allocation example

This example demonstrates the use of the socket function to allocate the socket, returning the socket handler to be used for other socket operations. Socket creation is dependent on the socket type.

UDP example

SOCKET UdpServerSocket = -1;

UdpServerSocket = socket(AF_INET, SOCK_DGRAM, 0);

TCP example

static SOCKET tcp_client_socket = -1;

tcp_client_socket = socket(AF_INET, SOCK_STREAM, 0));

SSL example

static SOCKET ssl_socket = -1;

ssl_socket = socket(AF_INET, SOCK_STREAM, SOCK_FLAGS_SSL));

Synchronous socket allocation function based on the specified socket type. Created sockets are non-blocking and their possible types are either TCP or a UDP sockets.
The maximum allowed number of TCP sockets is @ref TCP_SOCK_MAX sockets while the maximum number of UDP sockets that can be created simultaneously is @ref UDP_SOCK_MAX sockets.

Parameters

[in]	u16Domain	Socket family. The only allowed value is AF_INET (IPv4.0) for TCP/UDP sockets.
[in]	u8Type	Socket type. Allowed values are: SOCK_STREAM SOCK_DGRAM SOCK_RAW
[in]	u8Config	Used to specify the socket configuration. The interpretation of this parameter depends on the setting of u8Type. When u8Type is SOCK_STREAM the following configuration values are defined: SOCKET_CONFIG_SSL_OFF: The socket is not secured by TLS. SOCKET_CONFIG_SSL_ON: The socket is secured by TLS. SOCKET_CONFIG_SSL_DELAY: The socket is not secured by TLS, but may be secured later, by calling secure. When u8Type is SOCK_RAW, the following configuration values are defined: SOCKET_CONFIG_IPPROTO_RAW: The socket is to be used for raw ICMP frames. For all values of u8Type, the following configuration values are defined: SOCKET_CONFIG_DEFAULT: The default configuration. All other configuration values are reserved and should not be used.

Precondition

The socketInit function must be called once at the beginning of the application to initialize the socket handler. before any call to the socket function can be made.

See Also

connect secure bind listen accept recv recvfrom send sendto close setsockopt getsockopt

Returns

On successful socket creation, a non-blocking socket type is created and a socket ID is returned In case of failure the function returns a negative value, identifying one of the socket error codes defined. For example: SOCK_ERR_INVALID for invalid argument or SOCK_ERR_MAX_TCP_SOCK if the number of TCP allocated sockets exceeds the number of available sockets.

Remarks

The socket function must be called before any other related socket functions "e.g. send, recv, close ..etc"

Example

This example demonstrates the use of the socket function to allocate the socket, returning the socket handler to be used for other socket operations. Socket creation is dependent on the socket type.

UDP example

SOCKET UdpServerSocket = -1;

UdpServerSocket = socket(AF_INET, SOCK_DGRAM, SOCKET_CONFIG_DEFAULT);

TCP example

static SOCKET tcp_client_socket = -1;

tcp_client_socket = socket(AF_INET, SOCK_STREAM, SOCKET_CONFIG_DEFAULT));