net_sockets.c File Reference

#include "mbedtls/config.h"
#include "mbedtls/platform.h"
#include "mbedtls/net_sockets.h"
#include <string.h>
#include <sys/types.h>
#include <sys/socket.h>
#include <netinet/in.h>
#include <arpa/inet.h>
#include <sys/time.h>
#include <unistd.h>
#include <signal.h>
#include <fcntl.h>
#include <netdb.h>
#include <errno.h>
#include <stdio.h>
#include <time.h>
#include <stdint.h>

Include dependency graph for net_sockets.c:

Macros
#define	MSVC_INT_CAST

Functions
static int	net_prepare (void)
void	mbedtls_net_init (mbedtls_net_context *ctx)
	Initialize a context Just makes the context ready to be used or freed safely. More...
int	mbedtls_net_connect (mbedtls_net_context *ctx, const char *host, const char *port, int proto)
	Initiate a connection with host:port in the given protocol. More...
int	mbedtls_net_bind (mbedtls_net_context *ctx, const char *bind_ip, const char *port, int proto)
	Create a receiving socket on bind_ip:port in the chosen protocol. If bind_ip == NULL, all interfaces are bound. More...
static int	net_would_block (const mbedtls_net_context *ctx)
int	mbedtls_net_accept (mbedtls_net_context *bind_ctx, mbedtls_net_context *client_ctx, void *client_ip, size_t buf_size, size_t *ip_len)
	Accept a connection from a remote client. More...
int	mbedtls_net_set_block (mbedtls_net_context *ctx)
	Set the socket blocking. More...
int	mbedtls_net_set_nonblock (mbedtls_net_context *ctx)
	Set the socket non-blocking. More...
void	mbedtls_net_usleep (unsigned long usec)
	Portable usleep helper. More...
int	mbedtls_net_recv (void *ctx, unsigned char *buf, size_t len)
	Read at most 'len' characters. If no error occurs, the actual amount read is returned. More...
int	mbedtls_net_recv_timeout (void *ctx, unsigned char *buf, size_t len, uint32_t timeout)
	Read at most 'len' characters, blocking for at most 'timeout' seconds. If no error occurs, the actual amount read is returned. More...
int	mbedtls_net_send (void *ctx, const unsigned char *buf, size_t len)
	Write at most 'len' characters. If no error occurs, the actual amount read is returned. More...
void	mbedtls_net_free (mbedtls_net_context *ctx)
	Gracefully shutdown the connection and free associated data. More...

Macro Definition Documentation

MSVC_INT_CAST

#define MSVC_INT_CAST

Function Documentation

mbedtls_net_accept()

int mbedtls_net_accept	(	mbedtls_net_context *	bind_ctx,
		mbedtls_net_context *	client_ctx,
		void *	client_ip,
		size_t	buf_size,
		size_t *	ip_len
	)

Accept a connection from a remote client.

Parameters

bind_ctx	Relevant socket
client_ctx	Will contain the connected client socket
client_ip	Will contain the client IP address
buf_size	Size of the client_ip buffer
ip_len	Will receive the size of the client IP written

Returns

0 if successful, or MBEDTLS_ERR_NET_ACCEPT_FAILED, or MBEDTLS_ERR_NET_BUFFER_TOO_SMALL if buf_size is too small, MBEDTLS_ERR_SSL_WANT_READ if bind_fd was set to non-blocking and accept() would block.

Here is the call graph for this function:

mbedtls_net_bind()

int mbedtls_net_bind	(	mbedtls_net_context *	ctx,
		const char *	bind_ip,
		const char *	port,
		int	proto
	)

Create a receiving socket on bind_ip:port in the chosen protocol. If bind_ip == NULL, all interfaces are bound.

Parameters

ctx	Socket to use
bind_ip	IP to bind to, can be NULL
port	Port number to use
proto	Protocol: MBEDTLS_NET_PROTO_TCP or MBEDTLS_NET_PROTO_UDP

Returns

0 if successful, or one of: MBEDTLS_ERR_NET_SOCKET_FAILED, MBEDTLS_ERR_NET_BIND_FAILED, MBEDTLS_ERR_NET_LISTEN_FAILED

Note

Regardless of the protocol, opens the sockets and binds it. In addition, make the socket listening if protocol is TCP.

Here is the call graph for this function:

mbedtls_net_connect()

int mbedtls_net_connect	(	mbedtls_net_context *	ctx,
		const char *	host,
		const char *	port,
		int	proto
	)

Initiate a connection with host:port in the given protocol.

Parameters

ctx	Socket to use
host	Host to connect to
port	Port to connect to
proto	Protocol: MBEDTLS_NET_PROTO_TCP or MBEDTLS_NET_PROTO_UDP

Returns

0 if successful, or one of: MBEDTLS_ERR_NET_SOCKET_FAILED, MBEDTLS_ERR_NET_UNKNOWN_HOST, MBEDTLS_ERR_NET_CONNECT_FAILED

Note

Sets the socket in connected mode even with UDP.

Here is the call graph for this function:

mbedtls_net_free()

void mbedtls_net_free

(

mbedtls_net_context *

ctx

)

Gracefully shutdown the connection and free associated data.

Parameters

ctx	The context to free

Here is the call graph for this function:

mbedtls_net_init()

void mbedtls_net_init

(

mbedtls_net_context *

ctx

)

Initialize a context Just makes the context ready to be used or freed safely.

Parameters

ctx	Context to initialize

Here is the caller graph for this function:

mbedtls_net_recv()

int mbedtls_net_recv	(	void *	ctx,
		unsigned char *	buf,
		size_t	len
	)

Read at most 'len' characters. If no error occurs, the actual amount read is returned.

Parameters

ctx	Socket
buf	The buffer to write to
len	Maximum length of the buffer

Returns

the number of bytes received, or a non-zero error code; with a non-blocking socket, MBEDTLS_ERR_SSL_WANT_READ indicates read() would block.

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_net_recv_timeout()

int mbedtls_net_recv_timeout	(	void *	ctx,
		unsigned char *	buf,
		size_t	len,
		uint32_t	timeout
	)

Read at most 'len' characters, blocking for at most 'timeout' seconds. If no error occurs, the actual amount read is returned.

Parameters

ctx	Socket
buf	The buffer to write to
len	Maximum length of the buffer
timeout	Maximum number of milliseconds to wait for data 0 means no timeout (wait forever)

Returns

the number of bytes received, or a non-zero error code: MBEDTLS_ERR_SSL_TIMEOUT if the operation timed out, MBEDTLS_ERR_SSL_WANT_READ if interrupted by a signal.

Note

This function will block (until data becomes available or timeout is reached) even if the socket is set to non-blocking. Handling timeouts with non-blocking reads requires a different strategy.

Here is the call graph for this function:

mbedtls_net_send()

int mbedtls_net_send	(	void *	ctx,
		const unsigned char *	buf,
		size_t	len
	)

Write at most 'len' characters. If no error occurs, the actual amount read is returned.

Parameters

ctx	Socket
buf	The buffer to read from
len	The length of the buffer

Returns

the number of bytes sent, or a non-zero error code; with a non-blocking socket, MBEDTLS_ERR_SSL_WANT_WRITE indicates write() would block.

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_net_set_block()

int mbedtls_net_set_block

(

mbedtls_net_context *

ctx

)

Set the socket blocking.

Parameters

ctx	Socket to set

Returns

0 if successful, or a non-zero error code

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_net_set_nonblock()

int mbedtls_net_set_nonblock

(

mbedtls_net_context *

ctx

)

Set the socket non-blocking.

Parameters

ctx	Socket to set

Returns

0 if successful, or a non-zero error code

Here is the call graph for this function:

Here is the caller graph for this function:

mbedtls_net_usleep()

void mbedtls_net_usleep

(

unsigned long

usec

)

Portable usleep helper.

Parameters

usec	Amount of microseconds to sleep

Note

Real amount of time slept will not be less than select()'s timeout granularity (typically, 10ms).

Here is the call graph for this function:

net_prepare()

static int net_prepare ( void  )

static

Here is the caller graph for this function:

net_would_block()

static int net_would_block ( const mbedtls_net_context *  ctx )

static

Here is the caller graph for this function: