This file contains the definitions and functions of the Mbed TLS platform abstraction layer. More...

#include "config.h"
#include <stdio.h>
#include <stdlib.h>
#include <time.h>

Include dependency graph for platform.h:

This graph shows which files directly or indirectly include this file:

Classes
struct	mbedtls_platform_context
	The platform context structure. More...

Macros
#define	MBEDTLS_ERR_PLATFORM_HW_ACCEL_FAILED -0x0070

#define	MBEDTLS_ERR_PLATFORM_FEATURE_UNSUPPORTED -0x0072

#define	mbedtls_free free

#define	mbedtls_calloc calloc

#define	mbedtls_fprintf fprintf

#define	mbedtls_printf printf

#define	mbedtls_snprintf MBEDTLS_PLATFORM_STD_SNPRINTF

#define	mbedtls_exit exit

#define	MBEDTLS_EXIT_SUCCESS MBEDTLS_PLATFORM_STD_EXIT_SUCCESS

#define	MBEDTLS_EXIT_FAILURE MBEDTLS_PLATFORM_STD_EXIT_FAILURE

SECTION: Module settings
The configuration options you can set for this module are in this section. Either change them in config.h or define them on the compiler command line.
#define	MBEDTLS_PLATFORM_STD_SNPRINTF snprintf

#define	MBEDTLS_PLATFORM_STD_PRINTF printf

#define	MBEDTLS_PLATFORM_STD_FPRINTF fprintf

#define	MBEDTLS_PLATFORM_STD_CALLOC calloc

#define	MBEDTLS_PLATFORM_STD_FREE free

#define	MBEDTLS_PLATFORM_STD_EXIT exit

#define	MBEDTLS_PLATFORM_STD_TIME time

#define	MBEDTLS_PLATFORM_STD_EXIT_SUCCESS EXIT_SUCCESS

#define	MBEDTLS_PLATFORM_STD_EXIT_FAILURE EXIT_FAILURE

Typedefs
typedef struct mbedtls_platform_context	mbedtls_platform_context
	The platform context structure. More...

Functions
int	mbedtls_platform_setup (mbedtls_platform_context *ctx)
	This function performs any platform-specific initialization operations. More...

void	mbedtls_platform_teardown (mbedtls_platform_context *ctx)
	This function performs any platform teardown operations. More...

Detailed Description

This file contains the definitions and functions of the Mbed TLS platform abstraction layer.

The platform abstraction layer removes the need for the library to directly link to standard C library functions or operating system services, making the library easier to port and embed. Application developers and users of the library can provide their own implementations of these functions, or implementations specific to their platform, which can be statically linked to the library or dynamically configured at runtime.

Macro Definition Documentation

◆ mbedtls_calloc

#define mbedtls_calloc calloc

◆ MBEDTLS_ERR_PLATFORM_FEATURE_UNSUPPORTED

#define MBEDTLS_ERR_PLATFORM_FEATURE_UNSUPPORTED -0x0072

The requested feature is not supported by the platform

◆ MBEDTLS_ERR_PLATFORM_HW_ACCEL_FAILED

#define MBEDTLS_ERR_PLATFORM_HW_ACCEL_FAILED -0x0070

Hardware accelerator failed

◆ mbedtls_exit

#define mbedtls_exit exit

◆ MBEDTLS_EXIT_FAILURE

#define MBEDTLS_EXIT_FAILURE MBEDTLS_PLATFORM_STD_EXIT_FAILURE

◆ MBEDTLS_EXIT_SUCCESS

#define MBEDTLS_EXIT_SUCCESS MBEDTLS_PLATFORM_STD_EXIT_SUCCESS

◆ mbedtls_fprintf

#define mbedtls_fprintf fprintf

◆ mbedtls_free

#define mbedtls_free free

◆ MBEDTLS_PLATFORM_STD_CALLOC

#define MBEDTLS_PLATFORM_STD_CALLOC calloc

The default calloc function to use.

◆ MBEDTLS_PLATFORM_STD_EXIT

#define MBEDTLS_PLATFORM_STD_EXIT exit

The default exit function to use.

◆ MBEDTLS_PLATFORM_STD_EXIT_FAILURE

#define MBEDTLS_PLATFORM_STD_EXIT_FAILURE EXIT_FAILURE

The default exit value to use.

◆ MBEDTLS_PLATFORM_STD_EXIT_SUCCESS

#define MBEDTLS_PLATFORM_STD_EXIT_SUCCESS EXIT_SUCCESS

The default exit value to use.

◆ MBEDTLS_PLATFORM_STD_FPRINTF

#define MBEDTLS_PLATFORM_STD_FPRINTF fprintf

The default fprintf function to use.

◆ MBEDTLS_PLATFORM_STD_FREE

#define MBEDTLS_PLATFORM_STD_FREE free

The default free function to use.

◆ MBEDTLS_PLATFORM_STD_PRINTF

#define MBEDTLS_PLATFORM_STD_PRINTF printf

The default printf function to use.

◆ MBEDTLS_PLATFORM_STD_SNPRINTF

#define MBEDTLS_PLATFORM_STD_SNPRINTF snprintf

The default snprintf function to use.

◆ MBEDTLS_PLATFORM_STD_TIME

#define MBEDTLS_PLATFORM_STD_TIME time

The default time function to use.

◆ mbedtls_printf

#define mbedtls_printf printf

◆ mbedtls_snprintf

#define mbedtls_snprintf MBEDTLS_PLATFORM_STD_SNPRINTF

Typedef Documentation

◆ mbedtls_platform_context

typedef struct mbedtls_platform_context mbedtls_platform_context

The platform context structure.

Note: This structure may be used to assist platform-specific setup or teardown operations.

Function Documentation

◆ mbedtls_platform_setup()

int mbedtls_platform_setup ( mbedtls_platform_context * ctx )

This function performs any platform-specific initialization operations.

Note

This function should be called before any other library functions.

     Its implementation is platform-specific, and unless
     platform-specific code is provided, it does nothing.

The usage and necessity of this function is dependent on the platform.

Parameters

ctx	The platform context.

Returns: 0 on success.

◆ mbedtls_platform_teardown()

void mbedtls_platform_teardown ( mbedtls_platform_context * ctx )

This function performs any platform teardown operations.

Note: This function should be called after every other Mbed TLS module has been correctly freed using the appropriate free function.

Its implementation is platform-specific, and unless platform-specific code is provided, it does nothing.

Note: The usage and necessity of this function is dependent on the platform.