1/*
2 * Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
3 * Copyright (c) 1996-1999 by Internet Software Consortium.
4 *
5 * Permission to use, copy, modify, and distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
8 *
9 * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 * MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR
12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
15 * OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16 */
17
18#ifndef LOGGING_H
19#define LOGGING_H
20
21#include <sys/types.h>
22#include <stdio.h>
23#include <stdarg.h>
24#include <unistd.h>
25
26#define log_critical		(-5)
27#define log_error   		(-4)
28#define log_warning 		(-3)
29#define log_notice  		(-2)
30#define log_info  		(-1)
31#define log_debug(level)	(level)
32
33typedef enum { log_syslog, log_file, log_null } log_channel_type;
34
35#define LOG_MAX_VERSIONS 99
36
37#define LOG_CLOSE_STREAM		0x0001
38#define LOG_TIMESTAMP			0x0002
39#define LOG_TRUNCATE			0x0004
40#define LOG_USE_CONTEXT_LEVEL		0x0008
41#define LOG_PRINT_LEVEL			0x0010
42#define LOG_REQUIRE_DEBUG		0x0020
43#define LOG_CHANNEL_BROKEN		0x0040
44#define LOG_PRINT_CATEGORY		0x0080
45#define LOG_CHANNEL_OFF			0x0100
46
47typedef struct log_context *log_context;
48typedef struct log_channel *log_channel;
49
50#define LOG_OPTION_DEBUG		0x01
51#define LOG_OPTION_LEVEL		0x02
52
53#define log_open_stream		__log_open_stream
54#define log_close_stream	__log_close_stream
55#define log_get_stream		__log_get_stream
56#define log_get_filename	__log_get_filename
57#define log_check_channel	__log_check_channel
58#define log_check		__log_check
59#define log_vwrite		__log_vwrite
60#define log_write		__log_write
61#define log_new_context		__log_new_context
62#define log_free_context	__log_free_context
63#define log_add_channel		__log_add_channel
64#define log_remove_channel	__log_remove_channel
65#define log_option		__log_option
66#define log_category_is_active	__log_category_is_active
67#define log_new_syslog_channel	__log_new_syslog_channel
68#define log_new_file_channel	__log_new_file_channel
69#define log_set_file_owner	__log_set_file_owner
70#define log_new_null_channel	__log_new_null_channel
71#define log_inc_references	__log_inc_references
72#define log_dec_references	__log_dec_references
73#define log_get_channel_type	__log_get_channel_type
74#define log_free_channel	__log_free_channel
75#define log_close_debug_channels	__log_close_debug_channels
76
77FILE *			log_open_stream(log_channel);
78int			log_close_stream(log_channel);
79FILE *			log_get_stream(log_channel);
80char *			log_get_filename(log_channel);
81int			log_check_channel(log_context, int, log_channel);
82int			log_check(log_context, int, int);
83#ifdef __GNUC__
84void			log_vwrite(log_context, int, int, const char *,
85				   va_list args)
86				__attribute__((__format__(__printf__, 4, 0)));
87void			log_write(log_context, int, int, const char *, ...)
88				__attribute__((__format__(__printf__, 4, 5)));
89#else
90void			log_vwrite(log_context, int, int, const char *,
91				   va_list args);
92void			log_write(log_context, int, int, const char *, ...);
93#endif
94int			log_new_context(int, char **, log_context *);
95void			log_free_context(log_context);
96int			log_add_channel(log_context, int, log_channel);
97int			log_remove_channel(log_context, int, log_channel);
98int			log_option(log_context, int, int);
99int			log_category_is_active(log_context, int);
100log_channel		log_new_syslog_channel(unsigned int, int, int);
101log_channel		log_new_file_channel(unsigned int, int, const char *,
102					     FILE *, unsigned int,
103					     unsigned long);
104int			log_set_file_owner(log_channel, uid_t, gid_t);
105log_channel		log_new_null_channel(void);
106int			log_inc_references(log_channel);
107int			log_dec_references(log_channel);
108log_channel_type	log_get_channel_type(log_channel);
109int			log_free_channel(log_channel);
110void			log_close_debug_channels(log_context);
111
112#endif /* !LOGGING_H */
113/*! \file */
114