-/*
- * Copyright (c) 1995-2000, Index Data.
- *
- * Permission to use, copy, modify, distribute, and sell this software and
- * its documentation, in whole or in part, for any purpose, is hereby granted,
- * provided that:
- *
- * 1. This copyright and permission notice appear in all copies of the
- * software and its documentation. Notices of copyright or attribution
- * which appear at the beginning of any file must remain unchanged.
- *
- * 2. The name of Index Data or the individual authors may not be used to
- * endorse or promote products derived from this software without specific
- * prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND,
- * EXPRESS, IMPLIED, OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
- * WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
- * IN NO EVENT SHALL INDEX DATA BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
- * INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES
- * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR
- * NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF
- * LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE
- * OF THIS SOFTWARE.
- *
- * $Log: log.h,v $
- * Revision 1.3 2000-06-09 13:51:01 ian
- * Added LOG_APP for logging application (Rather than code) events that might
- * be useful when creating usage reports.
- *
- * Revision 1.2 2000/02/28 11:20:06 adam
- * Using autoconf. New definitions: YAZ_BEGIN_CDECL/YAZ_END_CDECL.
- *
- * Revision 1.1 1999/11/30 13:47:11 adam
- * Improved installation. Moved header files to include/yaz.
- *
- * Revision 1.15 1999/08/27 09:40:32 adam
- * Renamed logf function to yaz_log. Removed VC++ project files.
- *
- * Revision 1.14 1998/10/28 10:26:59 adam
- * New functions log_init_file, log_init_level, log_init_prefix.
- *
- * Revision 1.13 1998/10/13 16:11:11 adam
- * Added printf-format check for logf when using GNUC.
- *
- * Revision 1.12 1997/09/04 07:59:02 adam
- * Added include of xmalloc.h.
- *
- * Revision 1.11 1997/09/01 08:49:48 adam
- * New windows NT/95 port using MSV5.0. To export DLL functions the
- * YAZ_EXPORT modifier was added. Defined in yconfig.h.
- *
- * Revision 1.10 1997/05/14 06:53:40 adam
- * C++ support.
- *
- * Revision 1.9 1997/05/01 15:06:42 adam
- * Added log_mask_str_x routine.
- *
- * Revision 1.8 1996/05/01 12:45:00 quinn
- * *** empty log message ***
- *
- * Revision 1.7 1996/02/05 12:24:26 adam
- * Implemented log_event_{start,end}-functions.
- *
- * Revision 1.6 1995/10/10 16:27:06 quinn
- * *** empty log message ***
- *
- * Revision 1.5 1995/09/29 17:12:03 quinn
- * Smallish
- *
- * Revision 1.4 1995/09/27 15:02:47 quinn
- * Modified function heads & prototypes.
- *
- * Revision 1.3 1995/06/19 12:38:25 quinn
- * Reorganized include-files. Added small features.
- *
- * Revision 1.2 1995/05/16 08:50:31 quinn
- * License, documentation, and memory fixes
- *
- * Revision 1.1 1995/03/30 09:39:41 quinn
- * Moved .h files to include directory
- *
- * Revision 1.4 1994/09/28 13:07:22 adam
- * Added log_mask_str.
- *
- * Revision 1.3 1994/08/18 08:18:45 quinn
- * Added prefix to log_init.
- *
- * Revision 1.2 1994/08/17 14:27:46 quinn
- * added LOG_ERRNO
- *
- * Revision 1.1 1994/08/17 13:22:52 quinn
- * First version
- *
+/* This file is part of the YAZ toolkit.
+ * Copyright (C) 1995-2010 Index Data.
+ * All rights reserved.
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * * Neither the name of Index Data nor the names of its contributors
+ * may be used to endorse or promote products derived from this
+ * software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND ANY
+ * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE REGENTS AND CONTRIBUTORS BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+/**
+ * \file log.h
+ * \brief Logging utility
*/
-#ifndef LOG_H
-#define LOG_H
+#ifndef YAZ_LOG_H
+#define YAZ_LOG_H
#include <stdio.h>
#include <yaz/yconfig.h>
-#include <yaz/xmalloc.h>
YAZ_BEGIN_CDECL
-#define LOG_FATAL 0x0001
-#define LOG_DEBUG 0x0002
-#define LOG_WARN 0x0004
-#define LOG_LOG 0x0008
-#define LOG_ERRNO 0x0010 /* append strerror to message */
-#define LOG_FILE 0x0020
-#define LOG_APP 0x0040 /* For application level events such as new-connection */
+/** \brief log level: fatal */
+#define YLOG_FATAL 0x00000001
+/** \brief log level: debugging */
+#define YLOG_DEBUG 0x00000002
+/** \brief log level: warning */
+#define YLOG_WARN 0x00000004
+/** \brief log level: log (regular) */
+#define YLOG_LOG 0x00000008
+/** \brief log level: append system error message */
+#define YLOG_ERRNO 0x00000010
+/** \brief log level: append thread Id */
+#define YLOG_TID 0x00000020
+/** \brief log level: application */
+#define YLOG_APP 0x00000040
+/** \brief log level: malloc debug */
+#define YLOG_MALLOC 0x00000080
+/** \brief log level: do not output date and time */
+#define YLOG_NOTIME 0x00000100
+/** \brief log level: application 2 */
+#define YLOG_APP2 0x00000200
+/** \brief log level: application 3 */
+#define YLOG_APP3 0x00000400
+/** \brief log level: flush */
+#define YLOG_FLUSH 0x00000800
+/** \brief dynamic log level start */
+#define YLOG_LOGLVL 0x00001000 /* log when modules query log levels */
+ /* this has to be a hard-coded bit, not to loop*/
+
+#define YLOG_ALL (0xffff&~YLOG_MALLOC&~YLOG_NOTIME)
+
+/** \brief default log level */
+#define YLOG_DEFAULT_LEVEL \
+ (YLOG_FATAL | YLOG_ERRNO | YLOG_LOG | YLOG_WARN | YLOG_FLUSH)
+/* not having flush here confuses Solaris users, who won't see any logs until
+ * (and if) the program exits normally */
+
+/** \brief last bit for regular log bits . Rest are dynamic */
+#define YLOG_LAST_BIT YLOG_LOGLVL
+
+/** \brief sets level, prefix and filename for logging
+ \param level log level
+ \param prefix log message prefix
+ \param fname filename
+
+ If fname is NULL, the filename logging is not changed.
+*/
+YAZ_EXPORT void yaz_log_init(int level, const char *prefix, const char *fname);
+
+/** \brief sets log file
+ \param fname filename
+
+ A filename of NULL makes the log to be completely disabled.
+ A filename which is the empty string ("") makes the system
+ log to stderr (which is also the default). Otherwise the
+ filename given is used.
+*/
+YAZ_EXPORT void yaz_log_init_file(const char *fname);
-#define LOG_ALL 0xffff
+/** \brief sets log level
+ \param level (combination of YLOG_..)
+*/
+YAZ_EXPORT void yaz_log_init_level(int level);
-#define LOG_DEFAULT_LEVEL (LOG_FATAL | LOG_ERRNO | LOG_LOG | LOG_WARN)
+/** \brief sets log message prefix
+ \param prefix log message prefix
+*/
+YAZ_EXPORT void yaz_log_init_prefix(const char *prefix);
-#define logf yaz_log
+/** \brief sets second log message prefix
+ \param prefix log message prefix
+*/
+YAZ_EXPORT void yaz_log_init_prefix2(const char *prefix);
-YAZ_EXPORT void log_init(int level, const char *prefix, const char *name);
-YAZ_EXPORT void log_init_file (const char *fname);
-YAZ_EXPORT void log_init_level (int level);
-YAZ_EXPORT void log_init_prefix (const char *prefix);
+/** \brief sets time format for log mesages
+ \param fmt format (strftime)
+ Sets the format of the timestamp. See man 3 strftime.
+ Calling with "old" sets to the old format "11:55:06-02/11"
+ Calling with NULL or "" sets to the new format "20041102-115719"
+ If not called at all, the old format is used, for backward compatibility
+*/
+YAZ_EXPORT void yaz_log_time_format(const char *fmt);
+
+/** \brief sets limit in bytes for size for log file
+ \param mx size in bytes
+
+ Sets the max size for a log file. Zero means no limit.
+ Negative means built-in limit (1GB)
+*/
+YAZ_EXPORT void yaz_log_init_max_size(int mx);
+
+/** \brief Writes log message
+ \param level log level mask
+ \param fmt format string ala printf
+
+ Writes an entry in the log. Defaults to stderr if not initialized or
+ to a file with yaz_log_init_file(). The level must match the level set
+ via yaz_log_init_level(), optionally defined via yaz_log_mask_str().
+*/
YAZ_EXPORT void yaz_log(int level, const char *fmt, ...)
#ifdef __GNUC__
- __attribute__ ((format (printf, 2, 3)))
+ __attribute__ ((format (printf, 2, 3)))
#endif
- ;
-YAZ_EXPORT int log_mask_str (const char *str);
-YAZ_EXPORT int log_mask_str_x (const char *str, int level);
-YAZ_EXPORT FILE *log_file(void);
+ ;
+
+/** \brief converts log level string to log level (integer)
+ \param str log level string
+ \return log level mask
+
+ yaz_log_mask_str() converts a comma-separated list of log levels to a
+ bit mask. Starts from default level, and adds bits as specified,
+ unless 'none' is specified, which clears the list. If a name matches
+ the name of a YLOG_BIT above, that one is set. Otherwise a new value is
+ picked, and given to that name, to be found with yaz_log_module_level()
+*/
+YAZ_EXPORT int yaz_log_mask_str(const char *str);
-YAZ_EXPORT void log_event_start (void (*func)(int level, const char *msg, void *info),
- void *info);
-YAZ_EXPORT void log_event_end (void (*func)(int level, const char *msg, void *info),
- void *info);
+/** \brief converts log level string to log level with "start" level
+ \param str log level string
+ \param level initialing log level
+ \return log level mask
+
+ yaz_log_mask_str_x() is like yaz_log_mask_str(), but with a given start
+ value.
+*/
+YAZ_EXPORT int yaz_log_mask_str_x(const char *str, int level);
+
+/** \brief returns level for module
+ \param name module name
+ \returns log level for module
+
+ yaz_log_module_level() returns a log level mask corresponding to the
+ module name. If that had been specified on the -v arguments (that is
+ passed to yaz_log_mask_str()), then a non-zero mask is returned. If
+ not, we get a zero. This can later be used in yaz_log for the level
+ argument
+ */
+YAZ_EXPORT int yaz_log_module_level(const char *name);
+
+/** \brief returns FILE handle for log or NULL if no file is in use
+ \retval FILE FILE handle in use (possibly stderr)
+ \retval NULL log is currently not written to a file
+*/
+YAZ_EXPORT FILE *yaz_log_file(void);
+
+/** \brief sets custom log handler
+ \param func custom log handler
+ \param info custom pointer to be passed to func handler
+
+ Allows log output to be captured to something else.. The
+ func parameter takes a log level, a message + custom pointer
+*/
+YAZ_EXPORT void yaz_log_set_handler(void (*func)(int, const char *,
+ void *), void *info);
+
+/** \brief reopen current log file (unless disabled or stderr)
+ */
+YAZ_EXPORT void yaz_log_reopen(void);
+
+/** \brief Truncate the log file */
+YAZ_EXPORT void yaz_log_trunc(void);
+
+/** \brief installs hook to be called before each log msg
+ \param func function to be called
+ \param info user data to be passed to function
+ */
+YAZ_EXPORT void log_event_start(void (*func)(int level, const char *msg,
+ void *info), void *info);
+
+/** \brief installs hook to be called after each log msg
+ \param func function to be called
+ \param info user data to be passed to function
+ */
+YAZ_EXPORT void log_event_end(void (*func)(int level, const char *msg,
+ void *info), void *info);
+
+/** \brief Makes Libxml2 and Libxslt log errors through yaz_log
+ \param prefix prefix to use for log messages (may be 0)
+ \param log_level log level to use for Libxml2/Libxslt messages
+*/
+YAZ_EXPORT void yaz_log_xml_errors(const char *prefix, int log_level);
YAZ_END_CDECL
#endif
+/*
+ * Local variables:
+ * c-basic-offset: 4
+ * c-file-style: "Stroustrup"
+ * indent-tabs-mode: nil
+ * End:
+ * vim: shiftwidth=4 tabstop=8 expandtab
+ */
+