TCP Networking

Collaboration diagram for TCP Networking:

Functions
NETSOCKET	net_tcp_create (NETADDR bindaddr)
int	net_tcp_listen (NETSOCKET sock, int backlog)
int	net_tcp_accept (NETSOCKET sock, NETSOCKET *new_sock, NETADDR *addr)
int	net_tcp_connect (NETSOCKET sock, const NETADDR *addr)
int	net_tcp_connect_non_blocking (NETSOCKET sock, NETADDR bindaddr)
int	net_tcp_send (NETSOCKET sock, const void *data, int size)
int	net_tcp_recv (NETSOCKET sock, void *data, int maxsize)
void	net_tcp_close (NETSOCKET sock)

Detailed Description

Function Documentation

net_tcp_accept()

int net_tcp_accept	(	NETSOCKET	sock,
		NETSOCKET *	new_sock,
		NETADDR *	addr )

Polls a listening socket for a new connection.

Parameters

sock	Listening socket to poll.
new_sock	Pointer to a socket to fill in with the new socket.
addr	Pointer to an address that will be filled in the remote address, can be nullptr.

Returns

A non-negative integer on success. Negative integer on failure.

net_tcp_close()

void net_tcp_close

(

NETSOCKET

sock

)

Closes a TCP socket.

Parameters

sock	Socket to close.

net_tcp_connect()

int net_tcp_connect	(	NETSOCKET	sock,
		const NETADDR *	addr )

Connects one socket to another.

Parameters

sock	Socket to connect.
addr	Address to connect to.

Returns

0 on success.

net_tcp_connect_non_blocking()

int net_tcp_connect_non_blocking	(	NETSOCKET	sock,
		NETADDR	bindaddr )

Connect a socket to a TCP address without blocking.

Parameters

sock	The socket to connect with.
bindaddr	The address to connect to.

Returns

0 on success.

net_tcp_create()

NETSOCKET net_tcp_create

(

NETADDR

bindaddr

)

Creates a TCP socket.

Parameters

bindaddr

Address to bind the socket to.

Returns

On success it returns an handle to the socket. On failure it returns nullptr.

net_tcp_listen()

int net_tcp_listen	(	NETSOCKET	sock,
		int	backlog )

Makes the socket start listening for new connections.

Parameters

sock	Socket to start listen to.
backlog	Size of the queue of incoming connections to keep.

Returns

0 on success.

net_tcp_recv()

int net_tcp_recv	(	NETSOCKET	sock,
		void *	data,
		int	maxsize )

Receives data from a TCP stream.

Parameters

sock	Socket to recvive data from.
data	Pointer to a buffer to write the data to.
maxsize	Maximum of data to write to the buffer.

Returns

Number of bytes recvived. Negative value on failure. When in non-blocking mode, it returns 0 when there is no more data to be fetched.

net_tcp_send()

int net_tcp_send	(	NETSOCKET	sock,
		const void *	data,
		int	size )

Sends data to a TCP stream.

Parameters

sock	Socket to send data to.
data	Pointer to the data to send.
size	Size of the data to send.

Returns

Number of bytes sent. Negative value on failure.