2 Unix SMB/CIFS implementation.
4 Copyright (C) Andrew Tridgell 2003
5 Copyright (C) James J Myers 2003
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>.
22 #include "system/filesys.h"
23 #include "system/time.h"
24 #include "dynconfig.h"
28 * @brief Debug logging
32 * this global variable determines what messages are printed
34 _PUBLIC_ int DEBUGLEVEL;
36 /* the registered mutex handlers */
42 /* state variables for the debug system */
45 enum debug_logtype logtype;
46 const char *prog_name;
49 static BOOL reopen_logs_scheduled;
50 static BOOL check_reopen_logs(void)
52 if (state.fd == 0 || reopen_logs_scheduled) {
53 reopen_logs_scheduled = False;
57 if (state.fd <= 0) return False;
62 _PUBLIC_ void debug_schedule_reopen_logs(void)
64 reopen_logs_scheduled = True;
67 static void log_timestring(int level, const char *location, const char *func)
72 if (!check_reopen_logs()) return;
74 if (state.logtype != DEBUG_FILE) return;
76 t = timestring(NULL, time(NULL));
79 asprintf(&s, "[%s, %d %s:%s()]\n", t, level, location, func);
83 write(state.fd, s, strlen(s));
88 the backend for debug messages. Note that the DEBUG() macro has already
89 ensured that the log level has been met before this is called
91 _PUBLIC_ void do_debug_header(int level, const char *location, const char *func)
93 log_timestring(level, location, func);
98 the backend for debug messages. Note that the DEBUG() macro has already
99 ensured that the log level has been met before this is called
101 @note You should never have to call this function directly. Call the DEBUG()
104 _PUBLIC_ void do_debug(const char *format, ...) _PRINTF_ATTRIBUTE(1,2)
109 if (!check_reopen_logs()) return;
111 va_start(ap, format);
112 vasprintf(&s, format, ap);
115 write(state.fd, s, strlen(s));
119 _PUBLIC_ const char *logfile = NULL;
122 reopen the log file (usually called because the log file name might have changed)
124 _PUBLIC_ void reopen_logs(void)
127 int old_fd = state.fd;
129 switch (state.logtype) {
139 if ((*logfile) == '/') {
140 fname = strdup(logfile);
142 asprintf(&fname, "%s/%s.log", dyn_LOGFILEBASE, state.prog_name);
145 int newfd = open(fname, O_CREAT|O_APPEND|O_WRONLY, 0600);
147 DEBUG(1, ("Failed to open new logfile: %s\n", fname));
154 DEBUG(1, ("Failed to find name for file-based logfile!\n"));
166 control the name of the logfile and whether logging will be to stdout, stderr
169 _PUBLIC_ void setup_logging(const char *prog_name, enum debug_logtype new_logtype)
171 if (state.logtype < new_logtype) {
172 state.logtype = new_logtype;
175 state.prog_name = prog_name;
181 return a string constant containing n tabs
182 no more than 10 tabs are returned
184 _PUBLIC_ const char *do_debug_tab(int n)
186 const char *tabs[] = {"", "\t", "\t\t", "\t\t\t", "\t\t\t\t", "\t\t\t\t\t",
187 "\t\t\t\t\t\t", "\t\t\t\t\t\t\t", "\t\t\t\t\t\t\t\t",
188 "\t\t\t\t\t\t\t\t\t", "\t\t\t\t\t\t\t\t\t\t"};
189 return tabs[MIN(n, 10)];
194 log suspicious usage - print comments and backtrace
196 _PUBLIC_ void log_suspicious_usage(const char *from, const char *info)
198 if (!debug_handlers.ops.log_suspicious_usage) return;
200 debug_handlers.ops.log_suspicious_usage(from, info);
205 print suspicious usage - print comments and backtrace
207 _PUBLIC_ void print_suspicious_usage(const char* from, const char* info)
209 if (!debug_handlers.ops.print_suspicious_usage) return;
211 debug_handlers.ops.print_suspicious_usage(from, info);
214 _PUBLIC_ uint32_t get_task_id(void)
216 if (debug_handlers.ops.get_task_id) {
217 return debug_handlers.ops.get_task_id();
222 _PUBLIC_ void log_task_id(void)
224 if (!debug_handlers.ops.log_task_id) return;
226 if (!check_reopen_logs()) return;
228 debug_handlers.ops.log_task_id(state.fd);
232 register a set of debug handlers.
234 _PUBLIC_ void register_debug_handlers(const char *name, struct debug_ops *ops)
236 debug_handlers.name = name;
237 debug_handlers.ops = *ops;