2 * util/log.h - logging service
4 * Copyright (c) 2007, NLnet Labs. All rights reserved.
6 * This software is open source.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * Redistributions of source code must retain the above copyright notice,
13 * this list of conditions and the following disclaimer.
15 * Redistributions in binary form must reproduce the above copyright notice,
16 * this list of conditions and the following disclaimer in the documentation
17 * and/or other materials provided with the distribution.
19 * Neither the name of the NLNET LABS nor the names of its contributors may
20 * be used to endorse or promote products derived from this software without
21 * specific prior written permission.
23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
25 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
26 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
27 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33 * POSSIBILITY OF SUCH DAMAGE.
39 * This file contains logging functions.
44 #include <ldns/buffer.h>
49 enum verbosity_value {
50 /** 0 - no verbose messages */
52 /** 1 - operational information */
54 /** 2 - detailed information */
56 /** 3 - query level information */
58 /** 4 - algorithm level information */
60 /** 5 - querier client information */
64 /** The global verbosity setting */
65 extern enum verbosity_value verbosity;
68 * log a verbose message, pass the level for this message.
69 * It has printf formatted arguments. No trailing newline is needed.
70 * @param level: verbosity level for this message, compared to global
72 * @param format: printf-style format string. Arguments follow.
74 void verbose(enum verbosity_value level,
75 const char* format, ...) ATTR_FORMAT(printf, 2, 3);
78 * call this to initialize logging services.
79 * @param filename: if NULL stderr is used.
80 * @param use_syslog: set to true to ignore filename and use syslog(3).
81 * @param chrootdir: to which directory we have been chrooted, if any.
83 void log_init(const char* filename, int use_syslog, const char* chrootdir);
86 * Set logging to go to the specified file *.
87 * This setting does not affect the use_syslog setting.
88 * @param f: to that file, or pass NULL to disable logging.
90 void log_file(FILE *f);
93 * Init a thread (will print this number for the thread log entries).
94 * Must be called from the thread itself. If not called 0 is printed.
95 * @param num: number to print for this thread. Owned by caller, must
98 void log_thread_set(int* num);
101 * Set identity to print, default is 'unbound'.
102 * @param id: string to print. Name of executable.
104 void log_ident_set(const char* id);
107 * Set the time value to print in log entries.
108 * @param t: the point is copied and used to find the time.
109 * if NULL, time(2) is used.
111 void log_set_time(uint32_t* t);
114 * Set if the time value is printed ascii or decimal in log entries.
115 * @param use_asc: if true, ascii is printed, otherwise decimal.
116 * If the conversion fails or you have no time functions,
117 * decimal is printed.
119 void log_set_time_asc(int use_asc);
122 * Log informational message.
123 * Pass printf formatted arguments. No trailing newline is needed.
124 * @param format: printf-style format string. Arguments follow.
126 void log_info(const char* format, ...) ATTR_FORMAT(printf, 1, 2);
130 * Pass printf formatted arguments. No trailing newline is needed.
131 * @param format: printf-style format string. Arguments follow.
133 void log_err(const char* format, ...) ATTR_FORMAT(printf, 1, 2);
136 * Log warning message.
137 * Pass printf formatted arguments. No trailing newline is needed.
138 * @param format: printf-style format string. Arguments follow.
140 void log_warn(const char* format, ...) ATTR_FORMAT(printf, 1, 2);
143 * Log a hex-string to the log. Can be any length.
144 * performs mallocs to do so, slow. But debug useful.
145 * @param msg: string desc to accompany the hexdump.
146 * @param data: data to dump in hex format.
147 * @param length: length of data.
149 void log_hex(const char* msg, void* data, size_t length);
152 * Easy alternative for log_hex, takes a ldns_buffer.
153 * @param level: verbosity level for this message, compared to global
155 * @param msg: string desc to print
156 * @param buf: the buffer.
158 void log_buf(enum verbosity_value level, const char* msg, ldns_buffer* buf);
161 * Log fatal error message, and exit the current process.
162 * Pass printf formatted arguments. No trailing newline is needed.
163 * @param format: printf-style format string. Arguments follow.
165 void fatal_exit(const char* format, ...) ATTR_FORMAT(printf, 1, 2);
168 * va_list argument version of log_info.
169 * @param pri: priority type, for example 5 (INFO).
170 * @param type: string to designate type of message (info, error).
171 * @param format: the printf style format to print. no newline.
172 * @param args: arguments for format string.
174 void log_vmsg(int pri, const char* type, const char* format, va_list args);
177 * an assertion that is thrown to the logfile.
180 # define log_assert(x) \
182 fatal_exit("%s:%d: %s: assertion %s failed", \
183 __FILE__, __LINE__, __func__, #x); \
186 # define log_assert(x) /*nothing*/
191 * Convert WSA error into string.
192 * @param err: from WSAGetLastError()
195 char* wsa_strerror(DWORD err);
196 #endif /* USE_WINSOCK */
198 #endif /* UTIL_LOG_H */