Index: include/asterisk/logger.h =================================================================== RCS file: /usr/cvsroot/asterisk/include/asterisk/logger.h,v retrieving revision 1.12 diff -u -r1.12 logger.h --- include/asterisk/logger.h 22 Aug 2005 21:19:59 -0000 1.12 +++ include/asterisk/logger.h 25 Aug 2005 13:25:12 -0000 @@ -1,15 +1,21 @@ /* - * Cheops Next Generation + * Asterisk * - * Mark Spencer + * Mark Spencer * - * Copyright(C) Mark Spencer + * Copyright(C) 2005, Digium, inc. * * Distributed under the terms of the GNU General Public License (GPL) Version * * Logging routines * + * $Revision$ */ +/*! + \file logger.h + \brief Support for logging to various files, console and syslog + Configuration in file logger.conf +*/ #ifndef _LOGGER_H #define _LOGGER_H @@ -30,14 +36,17 @@ /*! Used for sending a log message */ /*! - * \param level don't need to worry about it - * \param file ditto - * \param line ditto - * \param function ditto - * \param fmt this is what is important. The format is the same as your favorite breed of printf. You know how that works, right? :-) - * This is the standard logger function. Probably the only way you will invoke it would be something like this: - * ast_log(LOG_WHATEVER, "Problem with the %s Captain. We should get some more. Will %d be enough?", "flux capacitor", 10); - * where WHATEVER is one of ERROR, DEBUG, EVENT, NOTICE, or WARNING depending on which log you wish to output to. + \brief This is the standard logger function. Probably the only way you will invoke it would be something like this: + ast_log(LOG_WHATEVER, "Problem with the %s Captain. We should get some more. Will %d be enough?", "flux capacitor", 10); + where WHATEVER is one of ERROR, DEBUG, EVENT, NOTICE, or WARNING depending + on which log you wish to output to. These are implemented as macros, that + will provide the function with the needed arguments. + + \param level Type of log event + \param file Will be provided by the LOG_* macro + \param line Will be provided by the LOG_* macro + \param function Will be provided by the LOG_* macro + \param fmt This is what is important. The format is the same as your favorite breed of printf. You know how that works, right? :-) */ extern void ast_log(int level, const char *file, int line, const char *function, const char *fmt, ...) __attribute__ ((format (printf, 5, 6))); @@ -45,13 +54,12 @@ extern void ast_queue_log(const char *queuename, const char *callid, const char *agent, const char *event, const char *fmt, ...) __attribute__ ((format (printf, 5, 6))); -/*! Send a verbose message (based on verbose level) */ -/*! - * This works like ast_log, but prints verbose messages to the console depending on verbosity level set. - * ast_verbose(VERBOSE_PREFIX_3 "Whatever %s is happening\n", "nothing"); - * This will print the message to the console if the verbose level is set to a level >= 3 - * Note the abscence of a comma after the VERBOSE_PREFIX_3. This is important. - * VERBOSE_PREFIX_1 through VERBOSE_PREFIX_3 are defined. +/*! Send a verbose message (based on verbose level) + \brief This works like ast_log, but prints verbose messages to the console depending on verbosity level set. + ast_verbose(VERBOSE_PREFIX_3 "Whatever %s is happening\n", "nothing"); + This will print the message to the console if the verbose level is set to a level >= 3 + Note the abscence of a comma after the VERBOSE_PREFIX_3. This is important. + VERBOSE_PREFIX_1 through VERBOSE_PREFIX_3 are defined. */ extern void ast_verbose(const char *fmt, ...) __attribute__ ((format (printf, 1, 2)));