#include "mbedtls/config.h"
#include "mbedtls/platform_util.h"
#include "mbedtls/platform.h"
#include "mbedtls/threading.h"
#include <stddef.h>
#include <string.h>

Include dependency graph for platform_util.c:

Macros
#define	_POSIX_C_SOURCE 200112L

Functions
void	mbedtls_platform_zeroize (void *buf, size_t len)
	Securely zeroize a buffer.

Variables
static void (constvolatile	memset_func )(void *, int, size_t) = memset

Macro Definition Documentation

◆ _POSIX_C_SOURCE

#define _POSIX_C_SOURCE 200112L

Definition at line 53 of file platform_util.c.

Function Documentation

◆ mbedtls_platform_zeroize()

void mbedtls_platform_zeroize	(	void *	buf,
		size_t	len
	)

Securely zeroize a buffer.

         The function is meant to wipe the data contained in a buffer so
         that it can no longer be recovered even if the program memory
         is later compromised. Call this function on sensitive data
         stored on the stack before returning from a function, and on
         sensitive data stored on the heap before freeing the heap
         object.

         It is extremely difficult to guarantee that calls to
         mbedtls_platform_zeroize() are not removed by aggressive
         compiler optimizations in a portable way. For this reason, Mbed
         TLS provides the configuration option
         MBEDTLS_PLATFORM_ZEROIZE_ALT, which allows users to configure
         mbedtls_platform_zeroize() to use a suitable implementation for
         their platform and needs

Parameters

buf	Buffer to be zeroized
len	Length of the buffer in bytes

Definition at line 98 of file platform_util.c.

{
    MBEDTLS_INTERNAL_VALIDATE( len == 0 || buf != NULL );
 
    if( len > 0 )
        memset_func( buf, 0, len );
}

Variable Documentation

◆ memset_func

void (constvolatile memset_func) (void *, int, size_t)	(	void *	,
		int	,
		size_t
	)		= memset

static

Definition at line 96 of file platform_util.c.

Referenced by mbedtls_platform_zeroize().

Macros