debug.h File Reference

Functions for controlling and providing debug output from the library. More...

#include "mbedtls/build_info.h"
#include "mbedtls/ssl.h"
#include <inttypes.h>

Include dependency graph for debug.h:

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

Go to the source code of this file.

Macros
#define	MBEDTLS_SSL_DEBUG_MSG(level, args)   do { } while (0)
#define	MBEDTLS_SSL_DEBUG_RET(level, text, ret)   do { } while (0)
#define	MBEDTLS_SSL_DEBUG_BUF(level, text, buf, len)   do { } while (0)
#define	MBEDTLS_SSL_DEBUG_MPI(level, text, X)   do { } while (0)
#define	MBEDTLS_SSL_DEBUG_ECP(level, text, X)   do { } while (0)
#define	MBEDTLS_SSL_DEBUG_CRT(level, text, crt)   do { } while (0)
#define	MBEDTLS_SSL_DEBUG_ECDH(level, ecdh, attr)   do { } while (0)
#define	MBEDTLS_PRINTF_ATTRIBUTE(string_index, first_to_check)
#define	MBEDTLS_PRINTF_SIZET   "zu"
#define	MBEDTLS_PRINTF_LONGLONG   "lld"
#define	MBEDTLS_PRINTF_MS_TIME   MBEDTLS_PRINTF_LONGLONG

Functions
void	mbedtls_debug_set_threshold (int threshold)
	Set the threshold error level to handle globally all debug output. Debug messages that have a level over the threshold value are discarded. (Default value: 0 = No debug )

Detailed Description

Functions for controlling and providing debug output from the library.

Macro Definition Documentation

MBEDTLS_PRINTF_ATTRIBUTE

#define MBEDTLS_PRINTF_ATTRIBUTE	(		string_index,
			first_to_check
	)

Mark a function as having printf attributes, and thus enable checking via -wFormat and other flags. This does nothing on builds with compilers that do not support the format attribute

Module: library/debug.c Caller:

This module provides debugging functions.

MBEDTLS_PRINTF_LONGLONG

#define MBEDTLS_PRINTF_LONGLONG   "lld"

MBEDTLS_PRINTF_MS_TIME

#define MBEDTLS_PRINTF_MS_TIME   MBEDTLS_PRINTF_LONGLONG

MBEDTLS_PRINTF_SIZET

#define MBEDTLS_PRINTF_SIZET   "zu"

MBEDTLS_PRINTF_xxx: Due to issues with older window compilers and MinGW we need to define the printf specifier for size_t and long long per platform.

Module: library/debug.c Caller:

This module provides debugging functions.

MBEDTLS_SSL_DEBUG_BUF

#define MBEDTLS_SSL_DEBUG_BUF	(		level,
			text,
			buf,
			len
	)		do { } while (0)

MBEDTLS_SSL_DEBUG_CRT

#define MBEDTLS_SSL_DEBUG_CRT	(		level,
			text,
			crt
	)		do { } while (0)

MBEDTLS_SSL_DEBUG_ECDH

#define MBEDTLS_SSL_DEBUG_ECDH	(		level,
			ecdh,
			attr
	)		do { } while (0)

MBEDTLS_SSL_DEBUG_ECP

#define MBEDTLS_SSL_DEBUG_ECP	(		level,
			text,
			X
	)		do { } while (0)

MBEDTLS_SSL_DEBUG_MPI

#define MBEDTLS_SSL_DEBUG_MPI	(		level,
			text,
			X
	)		do { } while (0)

MBEDTLS_SSL_DEBUG_MSG

#define MBEDTLS_SSL_DEBUG_MSG	(		level,
			args
	)		do { } while (0)

MBEDTLS_SSL_DEBUG_RET

#define MBEDTLS_SSL_DEBUG_RET	(		level,
			text,
			ret
	)		do { } while (0)

Function Documentation

mbedtls_debug_set_threshold()

void mbedtls_debug_set_threshold

(

int

threshold

)

Set the threshold error level to handle globally all debug output. Debug messages that have a level over the threshold value are discarded. (Default value: 0 = No debug )

Parameters

threshold

threshold level of messages to filter on. Messages at a higher level will be discarded. Debug levels 0 No debug 1 Error 2 State change 3 Informational 4 Verbose