diff options
author | kpfleming <kpfleming@f38db490-d61c-443f-a65b-d21fe96a405b> | 2005-08-25 23:21:01 +0000 |
---|---|---|
committer | kpfleming <kpfleming@f38db490-d61c-443f-a65b-d21fe96a405b> | 2005-08-25 23:21:01 +0000 |
commit | b7a008677cea9ca1f0ea940b043cc4ddd3f12c43 (patch) | |
tree | 8aad7dd120e391dbbe2a267a196c4b26bbd27708 /include | |
parent | 3c8955b668c51dce5c07edde28e1c3b3a736a4f5 (diff) |
doc updates and copyright header cleanup (issue #5027)
git-svn-id: http://svn.digium.com/svn/asterisk/trunk@6410 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'include')
-rwxr-xr-x | include/asterisk/logger.h | 46 |
1 files changed, 27 insertions, 19 deletions
diff --git a/include/asterisk/logger.h b/include/asterisk/logger.h index c94fd96d2..f0530d03c 100755 --- a/include/asterisk/logger.h +++ b/include/asterisk/logger.h @@ -1,15 +1,21 @@ /* - * Cheops Next Generation + * Asterisk * - * Mark Spencer <markster@marko.net> + * Mark Spencer <markster@digium.com> * - * Copyright(C) Mark Spencer + * Copyright(C) 1999-2005, Digium, Inc. * - * Distributed under the terms of the GNU General Public License (GPL) Version + * Distributed under the terms of the GNU General Public License (GPL) Version 2 * * 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 @@ extern "C" { /*! 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_log(int level, const char *file, int line, const char *function, 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))); |