edhoc-trace.c File Reference

EDHOC tracing and logging module. More...

#include "edhoc-trace.h"
#include "edhoc-config.h"
#include "ecc-common.h"
#include "sys/log.h"

Go to the source code of this file.

Functions
void	edhoc_trace_message (uint8_t msg_num, const uint8_t *msg_data, size_t msg_len, bool is_tx)
	Print EDHOC message in RFC 9529 trace format.
void	edhoc_trace_ephemeral_key (const char *role_label, const uint8_t *pub_x, const uint8_t *pub_y, const uint8_t *priv)
	Print ephemeral key generation step.
void	edhoc_trace_transcript_hash (const char *th_label, const uint8_t *th_data, const uint8_t *input_data, size_t input_len)
	Print transcript hash computation.
void	edhoc_trace_prk_derivation (const char *prk_label, const uint8_t *prk_data, const uint8_t *salt_data, const uint8_t *ikm_data)
	Print PRK derivation step.
void	edhoc_trace_mac_computation (const char *mac_label, const uint8_t *mac_data, const uint8_t *context_data, size_t context_len)
	Print MAC computation step.
void	edhoc_trace_credential (const char *cred_label, const uint8_t *cred_data, size_t cred_len, const uint8_t *id_cred_data, size_t id_cred_len)
	Print credential information.
void	edhoc_trace_session_summary (const edhoc_context_t *ctx)
	Print session summary at protocol completion.

Detailed Description

EDHOC tracing and logging module.

Author

Nicolas Tsiftes nicol.nosp@m.as.t.nosp@m.sifte.nosp@m.s@ri.nosp@m..se

Definition in file edhoc-trace.c.

Function Documentation

edhoc_trace_credential()

void edhoc_trace_credential	(	const char *	cred_label,
		const uint8_t *	cred_data,
		size_t	cred_len,
		const uint8_t *	id_cred_data,
		size_t	id_cred_len )

Print credential information.

Parameters

cred_label	Credential label ("CRED_I", "CRED_R")
cred_data	Credential data
cred_len	Credential length
id_cred_data	ID_CRED data (optional)
id_cred_len	ID_CRED length

Definition at line 159 of file edhoc-trace.c.

References EDHOC_TRACE_VALUE.

edhoc_trace_ephemeral_key()

void edhoc_trace_ephemeral_key	(	const char *	role_label,
		const uint8_t *	pub_x,
		const uint8_t *	pub_y,
		const uint8_t *	priv )

Print ephemeral key generation step.

Parameters

role_label	Role label ("Initiator" or "Responder")
pub_x	Public key X coordinate
pub_y	Public key Y coordinate (optional, can be NULL)
priv	Private key (optional for security, can be NULL)

Definition at line 64 of file edhoc-trace.c.

References EDHOC_TRACE_VALUE.

edhoc_trace_mac_computation()

void edhoc_trace_mac_computation	(	const char *	mac_label,
		const uint8_t *	mac_data,
		const uint8_t *	context_data,
		size_t	context_len )

Print MAC computation step.

Parameters

mac_label	MAC label ("MAC_2", "MAC_3")
mac_data	MAC data
context_data	Context data used for MAC computation (optional)
context_len	Context data length

Definition at line 140 of file edhoc-trace.c.

References EDHOC_TRACE_VALUE.

edhoc_trace_message()

void edhoc_trace_message	(	uint8_t	msg_num,
		const uint8_t *	msg_data,
		size_t	msg_len,
		bool	is_tx )

Print EDHOC message in RFC 9529 trace format.

Parameters

msg_num	Message number (1, 2, 3, or 4)
msg_data	Message data
msg_len	Message length
is_tx	True if transmitting, false if receiving

Definition at line 48 of file edhoc-trace.c.

edhoc_trace_prk_derivation()

void edhoc_trace_prk_derivation	(	const char *	prk_label,
		const uint8_t *	prk_data,
		const uint8_t *	salt_data,
		const uint8_t *	ikm_data )

Print PRK derivation step.

Parameters

prk_label	PRK label ("PRK_2e", "PRK_3e2m", "PRK_4e3m")
prk_data	PRK data
salt_data	Salt used (optional)
ikm_data	Input keying material (optional)

Definition at line 117 of file edhoc-trace.c.

References EDHOC_TRACE_VALUE.

Referenced by edhoc_generate_prk_2e().

edhoc_trace_session_summary()

void edhoc_trace_session_summary

(

const edhoc_context_t *

ctx

)

Print session summary at protocol completion.

Parameters

ctx	EDHOC context

Definition at line 181 of file edhoc-trace.c.

References EDHOC_TRACE_VALUE.

Referenced by edhoc_print_session_info().

edhoc_trace_transcript_hash()

void edhoc_trace_transcript_hash	(	const char *	th_label,
		const uint8_t *	th_data,
		const uint8_t *	input_data,
		size_t	input_len )

Print transcript hash computation.

Parameters

th_label	TH label ("TH_2", "TH_3", "TH_4")
th_data	Transcript hash data
input_data	Input data for hash computation (optional)
input_len	Input data length

Definition at line 97 of file edhoc-trace.c.

References EDHOC_TRACE_VALUE.

Referenced by edhoc_generate_transcript_hash_2(), edhoc_generate_transcript_hash_3(), and edhoc_generate_transcript_hash_4().