Import Debian changes 4.89-2+deb9u4
[hcoop/debian/exim4.git] / src / debug.c
CommitLineData
420a0d19
CE
1/*************************************************
2* Exim - an Internet mail transport agent *
3*************************************************/
4
2813c06e 5/* Copyright (c) University of Cambridge 1995 - 2015 */
420a0d19
CE
6/* See the file NOTICE for conditions of use and distribution. */
7
8
9#include "exim.h"
10
11static uschar debug_buffer[2048];
12static uschar *debug_ptr = debug_buffer;
13static int debug_prefix_length = 0;
14
15
16
17/*************************************************
18* Print tree *
19*************************************************/
20
21/* Recursive tree-printing subroutine. It uses a static vector of uschar to
22hold the line-drawing characters that need to be printed on every line as it
23moves down the page. This function is used only in debugging circumstances. The
24output is done via debug_printf(). */
25
26#define tree_printlinesize 132 /* line size for printing */
27static uschar tree_printline[tree_printlinesize];
28
29/* Internal recursive subroutine.
30
31Arguments:
32 p tree node
2813c06e 33 pos amount of indenting & vertical bars to print
420a0d19
CE
34 barswitch if TRUE print | at the pos value
35
36Returns: nothing
37*/
38
39static void
40tree_printsub(tree_node *p, int pos, int barswitch)
41{
42int i;
43if (p->right != NULL) tree_printsub(p->right, pos+2, 1);
44for (i = 0; i <= pos-1; i++) debug_printf("%c", tree_printline[i]);
45debug_printf("-->%s [%d]\n", p->name, p->balance);
46tree_printline[pos] = barswitch? '|' : ' ';
47if (p->left != NULL)
48 {
49 tree_printline[pos+2] = '|';
50 tree_printsub(p->left, pos+2, 0);
51 }
52}
53
54/* The external function, with just a tree node argument. */
55
56void
57debug_print_tree(tree_node *p)
58{
59int i;
60for (i = 0; i < tree_printlinesize; i++) tree_printline[i] = ' ';
61if (p == NULL) debug_printf("Empty Tree\n"); else tree_printsub(p, 0, 0);
62debug_printf("---- End of tree ----\n");
63}
64
65
66
67/*************************************************
68* Print an argv vector *
69*************************************************/
70
71/* Called when about to obey execv().
72
73Argument: the argv vector
74Returns: nothing
75*/
76
77void
2813c06e 78debug_print_argv(const uschar ** argv)
420a0d19
CE
79{
80debug_printf("exec");
81while (*argv != NULL) debug_printf(" %.256s", *argv++);
82debug_printf("\n");
83}
84
85
86
87/*************************************************
88* Expand and print debugging string *
89*************************************************/
90
91/* The string is expanded and written as debugging output. If
92expansion fails, a message is written instead.
93
94Argument: the string
95Returns: nothing
96*/
97
98void
99debug_print_string(uschar *debug_string)
100{
101if (debug_string == NULL) return;
102HDEBUG(D_any|D_v)
103 {
104 uschar *s = expand_string(debug_string);
105 if (s == NULL)
106 debug_printf("failed to expand debug_output \"%s\": %s\n", debug_string,
107 expand_string_message);
108 else if (s[0] != 0)
109 debug_printf("%s%s", s, (s[Ustrlen(s)-1] == '\n')? "" : "\n");
110 }
111}
112
113
114
115/*************************************************
116* Print current uids and gids *
117*************************************************/
118
119/*
120Argument: an introductory string
121Returns: nothing
122*/
123
124void
125debug_print_ids(uschar *s)
126{
127debug_printf("%s uid=%ld gid=%ld euid=%ld egid=%ld\n", s,
128 (long int)getuid(), (long int)getgid(), (long int)geteuid(),
129 (long int)getegid());
130}
131
132
133
134
135/*************************************************
136* Print debugging message *
137*************************************************/
138
139/* There are two entries, one for use when being called directly from a
2813c06e 140function with a variable argument list, one for prepending an indent.
420a0d19
CE
141
142If debug_pid is nonzero, print the pid at the start of each line. This is for
143tidier output when running parallel remote deliveries with debugging turned on.
144Must do the whole thing with a single printf and flush, as otherwise output may
145get interleaved. Since some calls to debug_printf() don't end with newline,
2813c06e
CE
146we save up the text until we do get the newline.
147Take care to not disturb errno. */
148
149
150/* Debug printf indented by ACL nest depth */
151void
152debug_printf_indent(const char * format, ...)
153{
154va_list ap;
155unsigned depth = acl_level + expand_level, i;
156
157if (!debug_file) return;
158if (depth > 0)
159 {
160 for (i = depth >> 2; i > 0; i--)
161 fprintf(debug_file, " .");
162 fprintf(debug_file, "%*s", depth & 3, "");
163 }
164
165va_start(ap, format);
166debug_vprintf(format, ap);
167va_end(ap);
168}
169
420a0d19
CE
170
171void
172debug_printf(const char *format, ...)
173{
174va_list ap;
175va_start(ap, format);
176debug_vprintf(format, ap);
177va_end(ap);
178}
179
180void
181debug_vprintf(const char *format, va_list ap)
182{
2813c06e
CE
183int save_errno = errno;
184
185if (!debug_file) return;
420a0d19
CE
186
187/* Various things can be inserted at the start of a line. Don't use the
188tod_stamp() function for the timestamp, because that will overwrite the
189timestamp buffer, which may contain something useful. (This was a bug fix: the
190+memory debugging with +timestamp did cause a problem.) */
191
192if (debug_ptr == debug_buffer)
193 {
194 DEBUG(D_timestamp)
195 {
196 time_t now = time(NULL);
197 struct tm *t = timestamps_utc? gmtime(&now) : localtime(&now);
198 (void) sprintf(CS debug_ptr, "%02d:%02d:%02d ", t->tm_hour, t->tm_min,
199 t->tm_sec);
200 while(*debug_ptr != 0) debug_ptr++;
201 }
202
203 DEBUG(D_pid)
204 {
205 sprintf(CS debug_ptr, "%5d ", (int)getpid());
206 while(*debug_ptr != 0) debug_ptr++;
207 }
208
209 /* Set up prefix if outputting for host checking and not debugging */
210
211 if (host_checking && debug_selector == 0)
212 {
213 Ustrcpy(debug_ptr, ">>> ");
214 debug_ptr += 4;
215 }
216
217 debug_prefix_length = debug_ptr - debug_buffer;
218 }
219
220/* Use the checked formatting routine to ensure that the buffer
221does not overflow. Ensure there's space for a newline at the end. */
222
223if (!string_vformat(debug_ptr,
224 sizeof(debug_buffer) - (debug_ptr - debug_buffer) - 1, format, ap))
225 {
226 uschar *s = US"**** debug string too long - truncated ****\n";
227 uschar *p = debug_buffer + Ustrlen(debug_buffer);
228 int maxlen = sizeof(debug_buffer) - Ustrlen(s) - 3;
229 if (p > debug_buffer + maxlen) p = debug_buffer + maxlen;
230 if (p > debug_buffer && p[-1] != '\n') *p++ = '\n';
231 Ustrcpy(p, s);
232 }
233
234while(*debug_ptr != 0) debug_ptr++;
235
236/* Output the line if it is complete. If we added any prefix data and there
237are internal newlines, make sure the prefix is on the continuation lines,
238as long as there is room in the buffer. We want to do just a single fprintf()
239so as to avoid interleaving. */
240
241if (debug_ptr[-1] == '\n')
242 {
243 if (debug_prefix_length > 0)
244 {
245 uschar *p = debug_buffer;
246 int left = sizeof(debug_buffer) - (debug_ptr - debug_buffer) - 1;
247 while ((p = Ustrchr(p, '\n') + 1) != debug_ptr &&
248 left >= debug_prefix_length)
249 {
250 int len = debug_ptr - p;
251 memmove(p + debug_prefix_length, p, len + 1);
252 memmove(p, debug_buffer, debug_prefix_length);
253 debug_ptr += debug_prefix_length;
254 left -= debug_prefix_length;
255 }
256 }
257
258 fprintf(debug_file, "%s", CS debug_buffer);
259 fflush(debug_file);
260 debug_ptr = debug_buffer;
261 debug_prefix_length = 0;
262 }
2813c06e 263errno = save_errno;
420a0d19
CE
264}
265
266/* End of debug.c */