logging.c File Reference

#include <limits.h>
#include <stdio.h>
#include <stdarg.h>
#include <fcntl.h>
#include <stdlib.h>
#include <inttypes.h>
#include <string.h>
#include <errno.h>
#include <signal.h>
#include <sys/time.h>
#include "spandsp/telephony.h"
#include "spandsp/logging.h"

Functions
int	span_log_test (logging_state_t *s, int level)
	Test if logging of a specified severity level is enabled.
int	span_log (logging_state_t *s, int level, const char *format,...)
	Generate a log entry.
int	span_log_buf (logging_state_t *s, int level, const char *tag, const uint8_t *buf, int len)
	Generate a log entry displaying the contents of a buffer.
int	span_log_init (logging_state_t *s, int level, const char *tag)
int	span_log_set_level (logging_state_t *s, int level)
int	span_log_set_tag (logging_state_t *s, const char *tag)
int	span_log_set_protocol (logging_state_t *s, const char *protocol)
int	span_log_set_sample_rate (logging_state_t *s, int samples_per_second)
int	span_log_bump_samples (logging_state_t *s, int samples)
void	span_log_set_message_handler (logging_state_t *s, message_handler_func_t func)
void	span_log_set_error_handler (logging_state_t *s, error_handler_func_t func)
void	span_set_message_handler (message_handler_func_t func)
void	span_set_error_handler (error_handler_func_t func)

---

Detailed Description

---

Function Documentation

int span_log	(	logging_state_t *	s,
		int	level,
		const char *	format,
			...
	)

Generate a log entry.

Generate a log entry.

Parameters:

	s	The logging context.
	level	The severity level of the entry.
	format	???

Returns:

0 if no output generated, else 1.

References logging_state_t::elapsed_samples, logging_state_t::level, logging_state_t::protocol, logging_state_t::samples_per_second, logging_state_t::span_error, span_log_test(), logging_state_t::span_message, and logging_state_t::tag.

Referenced by lapm_dump(), lapm_receive(), lapm_tx_iframe(), span_log_buf(), t30_decode_dis_dtc_dcs(), t30_front_end_status(), t30_hdlc_accept(), t30_non_ecm_get_bit(), t30_non_ecm_get_byte(), t30_non_ecm_get_chunk(), t38_core_rx_ifp_packet(), t38_core_send_data(), t38_core_send_data_multi_field(), t38_core_send_indicator(), t38_non_ecm_buffer_report_input_status(), t38_non_ecm_buffer_report_output_status(), t4_rx_end_page(), t4_rx_init(), t4_rx_start_page(), t4_tx_init(), t4_tx_more_pages(), t4_tx_start_page(), v17_rx_restart(), v27ter_rx_restart(), v29_tx_restart(), v32bis_restart(), and v8_log_supported_modulations().

int span_log_buf	(	logging_state_t *	s,
		int	level,
		const char *	tag,
		const uint8_t *	buf,
		int	len
	)

Generate a log entry displaying the contents of a buffer.

Generate a log entry displaying the contents of a buffer.

Parameters:

	s	The logging context.
	level	The severity level of the entry.
	tag	A label for the log entry.
	buf	The buffer to be dumped to the log.
	len	The length of buf.

Returns:

0 if no output generated, else 1.

References span_log(), and span_log_test().

Referenced by lapm_dump(), and t38_core_rx_ifp_packet().

int span_log_test	(	logging_state_t *	s,
		int	level
	)

Test if logging of a specified severity level is enabled.

Test if logging of a specified severity level is enabled.

Parameters:

	s	The logging context.
	level	The severity level to be tested.

Returns:

TRUE if logging is enable, else FALSE.

References logging_state_t::level.

Referenced by span_log(), span_log_buf(), t30_decode_dis_dtc_dcs(), and t38_core_rx_ifp_packet().