zrtp_callback_event_t Struct Reference
[ZRTP Protocol Feedback]

Callbacks definitions. More...

#include <zrtp_iface.h>

Data Fields
void(*	on_zrtp_protocol_event )(zrtp_stream_t *stream, zrtp_protocol_event_t event)
	ZRTP Protocol events notification.
void(*	on_zrtp_security_event )(zrtp_stream_t *stream, zrtp_security_event_t event)
	ZRTP Security events notification.
void(*	on_zrtp_secure )(zrtp_stream_t *stream)
	Indicates switching to SECURE state.
void(*	on_zrtp_not_secure )(zrtp_stream_t *stream)
	Indicates switching to NOT SECURE state.

---

Detailed Description

Callbacks definitions.

This section lists callback functions informing the user about the protocol status. These callbacks must be defined in the user application.

---

Field Documentation

void(* on_zrtp_not_secure)(zrtp_stream_t *stream)

Indicates switching to NOT SECURE state.

This event duplicates some protocol and security events to simplify libzrtp usage. It may be used in applications which don't require detail information about ZRTP protocol.

If Error appeared - the exact error code can be found at zrtp_stream_info_t::last_error. Use zrtp_log_error2str() to get error description in text mode.

Parameters:

stream

- ZRTP stream context.

void(* on_zrtp_protocol_event)(zrtp_stream_t *stream, zrtp_protocol_event_t event)

ZRTP Protocol events notification.

Informs about switching between the protocol states and other events. Provides more flexible control over the protocol then on_zrtp_secure and on_zrtp_not_secure.

Parameters:

	event	- type of event;
	stream	- ZRTP stream context.

void(* on_zrtp_secure)(zrtp_stream_t *stream)

Indicates switching to SECURE state.

Pair of events: on_zrtp_secure and on_zrtp_not_secure represent simplified event handling mechanism comparing to on_zrtp_protocol_event. libzrtp calls this event when the call is SECURE and media is encrypted.

SAS Verification is required on this event.

Parameters:

stream

- ZRTP stream context.

void(* on_zrtp_security_event)(zrtp_stream_t *stream, zrtp_security_event_t event)

ZRTP Security events notification.

Informs about ZRTP security events: MiTM attacks, cache desynchronization and others.

Warning:

MUST be handled in the target application to provide high security level.

Parameters:

	event	- type of event;
	stream	- ZRTP stream context.

---

The documentation for this struct was generated from the following file:

• /home/chaser/Zfone/Work/build/zfone-full-0.90.438/zfone3/lib/libzrtp/include/zrtp_iface.h