139 lines
4.1 KiB
C
139 lines
4.1 KiB
C
/*
|
|
* FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
|
|
* Copyright (C) 2005/2006, Anthony Minessale II <anthmct@yahoo.com>
|
|
*
|
|
* Version: MPL 1.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
* the License. You may obtain a copy of the License at
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
* for the specific language governing rights and limitations under the
|
|
* License.
|
|
*
|
|
* The Original Code is FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
|
|
*
|
|
* The Initial Developer of the Original Code is
|
|
* Anthony Minessale II <anthmct@yahoo.com>
|
|
* Portions created by the Initial Developer are Copyright (C)
|
|
* the Initial Developer. All Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
*
|
|
* Anthony Minessale II <anthmct@yahoo.com>
|
|
*
|
|
*
|
|
* switch_log.h -- Logger
|
|
*
|
|
*/
|
|
/*! \file switch_log.h
|
|
\brief Simple Log
|
|
|
|
Logging Routines
|
|
*/
|
|
|
|
#ifndef SWITCH_LOG_H
|
|
#define SWITCH_LOG_H
|
|
|
|
#include <switch.h>
|
|
|
|
SWITCH_BEGIN_EXTERN_C
|
|
///\defgroup log Logger Routines
|
|
///\ingroup core1
|
|
///\{
|
|
/*! \brief Log Data
|
|
*/
|
|
typedef struct {
|
|
/*! The complete log message */
|
|
char *data;
|
|
/*! The file where the message originated */
|
|
char file[80];
|
|
/*! The line number where the message originated */
|
|
uint32_t line;
|
|
/*! The function where the message originated */
|
|
char func[80];
|
|
/*! The log level of the message */
|
|
switch_log_level_t level;
|
|
/*! The time when the log line was sent */
|
|
switch_time_t timestamp;
|
|
/*! A pointer to where the actual content of the message starts (skipping past the preformatted portion) */
|
|
char *content;
|
|
const char *userdata;
|
|
/* To maintain abi, only add new elements to the end of this struct and do not delete any elements */
|
|
|
|
} switch_log_node_t;
|
|
|
|
typedef switch_status_t (*switch_log_function_t) (const switch_log_node_t *node, switch_log_level_t level);
|
|
|
|
|
|
/*!
|
|
\brief Initilize the logging engine
|
|
\param pool the memory pool to use
|
|
\note to be called at application startup by the core
|
|
*/
|
|
SWITCH_DECLARE(switch_status_t) switch_log_init(_In_ switch_memory_pool_t *pool);
|
|
|
|
/*!
|
|
\brief Shut down the logging engine
|
|
\note to be called at application termination by the core
|
|
*/
|
|
SWITCH_DECLARE(switch_status_t) switch_log_shutdown(void);
|
|
|
|
#ifndef SWIG
|
|
/*!
|
|
\brief Write log data to the logging engine
|
|
\param channel the log channel to write to
|
|
\param file the current file
|
|
\param func the current function
|
|
\param line the current line
|
|
\param userdata ununsed
|
|
\param level the current log level
|
|
\param fmt desired format
|
|
\param ... variable args
|
|
\note there are channel macros to supply the first 4 parameters
|
|
*/
|
|
SWITCH_DECLARE(void) switch_log_printf(_In_ switch_text_channel_t channel, _In_z_ const char *file,
|
|
_In_z_ const char *func, _In_ int line,
|
|
_In_opt_z_ const char *userdata, _In_ switch_log_level_t level,
|
|
_In_z_ _Printf_format_string_ const char *fmt, ...) PRINTF_FUNCTION(7, 8);
|
|
#endif
|
|
/*!
|
|
\brief Shut down the logging engine
|
|
\note to be called at application termination by the core
|
|
*/
|
|
SWITCH_DECLARE(switch_status_t) switch_log_bind_logger(_In_ switch_log_function_t function, _In_ switch_log_level_t level);
|
|
|
|
/*!
|
|
\brief Return the name of the specified log level
|
|
\param level the level
|
|
\return the name of the log level
|
|
*/
|
|
_Ret_z_ SWITCH_DECLARE(const char *) switch_log_level2str(_In_ switch_log_level_t level);
|
|
|
|
/*!
|
|
\brief Return the level number of the specified log level name
|
|
\param str the name of the level
|
|
\return the log level
|
|
*/
|
|
SWITCH_DECLARE(switch_log_level_t) switch_log_str2level(_In_z_ const char *str);
|
|
|
|
SWITCH_DECLARE(uint32_t) switch_log_str2mask(_In_z_ const char *str);
|
|
#define switch_log_check_mask(_mask, _level) (_mask & (1 << _level))
|
|
|
|
///\}
|
|
SWITCH_END_EXTERN_C
|
|
#endif
|
|
/* For Emacs:
|
|
* Local Variables:
|
|
* mode:c
|
|
* indent-tabs-mode:t
|
|
* tab-width:4
|
|
* c-basic-offset:4
|
|
* End:
|
|
* For VIM:
|
|
* vim:set softtabstop=4 shiftwidth=4 tabstop=4 expandtab:
|
|
*/
|