2003-01-09 12:36:05 +00:00
|
|
|
/* logging.h
|
2010-03-10 17:22:23 +00:00
|
|
|
* Copyright (C) 1999, 2000, 2001, 2004, 2006,
|
|
|
|
* 2010 Free Software Foundation, Inc.
|
2003-01-09 12:36:05 +00:00
|
|
|
*
|
2011-09-30 12:52:11 +02:00
|
|
|
* This file is part of JNLIB, which is a subsystem of GnuPG.
|
2003-01-09 12:36:05 +00:00
|
|
|
*
|
2006-10-02 11:54:35 +00:00
|
|
|
* JNLIB is free software; you can redistribute it and/or modify it
|
2011-09-30 12:52:11 +02:00
|
|
|
* under the terms of either
|
|
|
|
*
|
|
|
|
* - the GNU Lesser General Public License as published by the Free
|
|
|
|
* Software Foundation; either version 3 of the License, or (at
|
|
|
|
* your option) any later version.
|
|
|
|
*
|
|
|
|
* or
|
|
|
|
*
|
|
|
|
* - the GNU General Public License as published by the Free
|
|
|
|
* Software Foundation; either version 2 of the License, or (at
|
|
|
|
* your option) any later version.
|
|
|
|
*
|
|
|
|
* or both in parallel, as here.
|
2003-01-09 12:36:05 +00:00
|
|
|
*
|
2006-10-02 11:54:35 +00:00
|
|
|
* JNLIB is distributed in the hope that it will be useful, but
|
|
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
2011-09-30 12:52:11 +02:00
|
|
|
* General Public License for more details.
|
2003-01-09 12:36:05 +00:00
|
|
|
*
|
2011-09-30 12:52:11 +02:00
|
|
|
* You should have received a copies of the GNU General Public License
|
|
|
|
* and the GNU Lesser General Public License along with this program;
|
|
|
|
* if not, see <http://www.gnu.org/licenses/>.
|
2003-01-09 12:36:05 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef LIBJNLIB_LOGGING_H
|
|
|
|
#define LIBJNLIB_LOGGING_H
|
|
|
|
|
|
|
|
#include <stdio.h>
|
|
|
|
#include "mischelp.h"
|
2010-08-18 19:25:15 +00:00
|
|
|
#include "w32help.h"
|
2003-01-09 12:36:05 +00:00
|
|
|
|
2004-04-16 09:46:54 +00:00
|
|
|
/* Flag values for log_set_prefix. */
|
|
|
|
#define JNLIB_LOG_WITH_PREFIX 1
|
|
|
|
#define JNLIB_LOG_WITH_TIME 2
|
|
|
|
#define JNLIB_LOG_WITH_PID 4
|
|
|
|
#define JNLIB_LOG_RUN_DETACHED 256
|
2013-08-01 11:20:48 +02:00
|
|
|
#define JNLIB_LOG_NO_REGISTRY 512
|
2003-01-09 12:36:05 +00:00
|
|
|
|
|
|
|
int log_get_errorcount (int clear);
|
2003-06-18 19:56:13 +00:00
|
|
|
void log_inc_errorcount (void);
|
2003-01-09 12:36:05 +00:00
|
|
|
void log_set_file( const char *name );
|
|
|
|
void log_set_fd (int fd);
|
2010-06-09 16:53:51 +00:00
|
|
|
void log_set_pid_suffix_cb (int (*cb)(unsigned long *r_value));
|
2003-01-09 12:36:05 +00:00
|
|
|
void log_set_prefix (const char *text, unsigned int flags);
|
|
|
|
const char *log_get_prefix (unsigned int *flags);
|
2004-04-16 09:46:54 +00:00
|
|
|
int log_test_fd (int fd);
|
2003-01-09 12:36:05 +00:00
|
|
|
int log_get_fd(void);
|
2010-03-10 17:22:23 +00:00
|
|
|
estream_t log_get_stream (void);
|
2003-01-09 12:36:05 +00:00
|
|
|
|
|
|
|
#ifdef JNLIB_GCC_M_FUNCTION
|
|
|
|
void bug_at( const char *file, int line, const char *func ) JNLIB_GCC_A_NR;
|
|
|
|
# define BUG() bug_at( __FILE__ , __LINE__, __FUNCTION__ )
|
|
|
|
#else
|
|
|
|
void bug_at( const char *file, int line );
|
|
|
|
# define BUG() bug_at( __FILE__ , __LINE__ )
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* To avoid mandatory inclusion of stdarg and other stuff, do it only
|
|
|
|
if explicitly requested to do so. */
|
|
|
|
#ifdef JNLIB_NEED_LOG_LOGV
|
|
|
|
#include <stdarg.h>
|
|
|
|
enum jnlib_log_levels {
|
|
|
|
JNLIB_LOG_BEGIN,
|
|
|
|
JNLIB_LOG_CONT,
|
|
|
|
JNLIB_LOG_INFO,
|
|
|
|
JNLIB_LOG_WARN,
|
|
|
|
JNLIB_LOG_ERROR,
|
|
|
|
JNLIB_LOG_FATAL,
|
|
|
|
JNLIB_LOG_BUG,
|
|
|
|
JNLIB_LOG_DEBUG
|
|
|
|
};
|
2010-10-26 09:10:29 +00:00
|
|
|
void log_log (int level, const char *fmt, ...) JNLIB_GCC_A_PRINTF(2,3);
|
2003-01-09 12:36:05 +00:00
|
|
|
void log_logv (int level, const char *fmt, va_list arg_ptr);
|
2010-03-11 12:34:11 +00:00
|
|
|
void log_string (int level, const char *string);
|
2003-01-09 12:36:05 +00:00
|
|
|
#endif /*JNLIB_NEED_LOG_LOGV*/
|
|
|
|
|
|
|
|
|
|
|
|
void log_bug( const char *fmt, ... ) JNLIB_GCC_A_NR_PRINTF(1,2);
|
|
|
|
void log_fatal( const char *fmt, ... ) JNLIB_GCC_A_NR_PRINTF(1,2);
|
|
|
|
void log_error( const char *fmt, ... ) JNLIB_GCC_A_PRINTF(1,2);
|
|
|
|
void log_info( const char *fmt, ... ) JNLIB_GCC_A_PRINTF(1,2);
|
|
|
|
void log_debug( const char *fmt, ... ) JNLIB_GCC_A_PRINTF(1,2);
|
|
|
|
void log_printf( const char *fmt, ... ) JNLIB_GCC_A_PRINTF(1,2);
|
2010-03-15 11:15:45 +00:00
|
|
|
void log_flush (void);
|
2007-08-22 20:36:33 +00:00
|
|
|
|
|
|
|
/* Print a hexdump of BUFFER. With TEXT passes as NULL print just the
|
|
|
|
raw dump, with TEXT being an empty string, print a trailing
|
|
|
|
linefeed, otherwise print an entire debug line with TEXT followed
|
|
|
|
by the hexdump and a final LF. */
|
2003-01-09 12:36:05 +00:00
|
|
|
void log_printhex (const char *text, const void *buffer, size_t length);
|
|
|
|
|
2013-01-07 16:51:24 +01:00
|
|
|
void log_clock (const char *string);
|
|
|
|
|
2003-01-09 12:36:05 +00:00
|
|
|
|
|
|
|
#endif /*LIBJNLIB_LOGGING_H*/
|