2 * Copyright (c) 2002 Jake Burkholder
3 * Copyright (c) 2004 Robert Watson
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 #include <sys/cdefs.h>
29 __FBSDID("$FreeBSD$");
31 #include <sys/types.h>
49 "usage: ktrdump [-cfqrtH] [-i ktrfile] [-M core] [-N system] [-o outfile]\n"
51 static void usage(void);
53 static struct nlist nl[] = {
71 static char corefile[PATH_MAX];
72 static char execfile[PATH_MAX];
74 static char desc[SBUFLEN];
75 static char errbuf[_POSIX2_LINE_MAX];
76 static char fbuf[PATH_MAX];
77 static char obuf[PATH_MAX];
78 static char sbuf[KTR_PARMS][SBUFLEN];
81 * Reads the ktr trace buffer from kernel memory and prints the trace entries.
84 main(int ac, char **av)
86 u_long parms[KTR_PARMS];
87 struct ktr_entry *buf;
88 uintmax_t tlast, tnow;
103 * Parse commandline arguments.
106 while ((c = getopt(ac, av, "cfqrtHe:i:m:M:N:o:")) != -1)
113 if (strlcpy(execfile, optarg, sizeof(execfile))
115 errx(1, "%s: File name too long", optarg);
123 if ((in = open(optarg, O_RDONLY)) == -1)
124 err(1, "%s", optarg);
128 if (strlcpy(corefile, optarg, sizeof(corefile))
130 errx(1, "%s: File name too long", optarg);
134 if ((out = fopen(optarg, "w")) == NULL)
135 err(1, "%s", optarg);
159 * Open our execfile and corefile, resolve needed symbols and read in
162 if ((kd = kvm_openfiles(Nflag ? execfile : NULL,
163 Mflag ? corefile : NULL, NULL, O_RDONLY, errbuf)) == NULL)
164 errx(1, "%s", errbuf);
165 if (kvm_nlist(kd, nl) != 0 ||
166 kvm_read(kd, nl[0].n_value, &version, sizeof(version)) == -1)
167 errx(1, "%s", kvm_geterr(kd));
168 if (version != KTR_VERSION)
169 errx(1, "ktr version mismatch");
171 if (fstat(in, &sb) == -1)
173 entries = sb.st_size / sizeof(*buf);
175 buf = mmap(NULL, sb.st_size, PROT_READ, MAP_SHARED, in, 0);
176 if (buf == MAP_FAILED)
179 if (kvm_read(kd, nl[1].n_value, &entries, sizeof(entries))
181 errx(1, "%s", kvm_geterr(kd));
182 if ((buf = malloc(sizeof(*buf) * entries)) == NULL)
184 if (kvm_read(kd, nl[2].n_value, &index, sizeof(index)) == -1 ||
185 kvm_read(kd, nl[3].n_value, &bufptr,
186 sizeof(bufptr)) == -1 ||
187 kvm_read(kd, bufptr, buf, sizeof(*buf) * entries) == -1)
188 errx(1, "%s", kvm_geterr(kd));
192 * Print a nice header.
195 fprintf(out, "%-6s ", "index");
197 fprintf(out, "%-3s ", "cpu");
199 fprintf(out, "%-16s ", "timestamp");
201 fprintf(out, "%-40s ", "file and line");
203 fprintf(out, "%-18s ", "tid");
204 fprintf(out, "%s", "trace");
207 fprintf(out, "------ ");
209 fprintf(out, "--- ");
211 fprintf(out, "---------------- ");
214 "---------------------------------------- ");
216 fprintf(out, "------------------ ");
217 fprintf(out, "----- ");
222 * Now tear through the trace buffer.
225 i = (index - 1) % entries;
228 if (buf[i].ktr_desc == NULL)
230 if (kvm_read(kd, (u_long)buf[i].ktr_desc, desc,
232 errx(1, "%s", kvm_geterr(kd));
233 desc[sizeof(desc) - 1] = '\0';
235 for (p = desc; (c = *p++) != '\0';) {
238 next: if ((c = *p++) == '\0')
240 if (parm == KTR_PARMS)
241 errx(1, "too many parameters");
243 case '0': case '1': case '2': case '3': case '4':
244 case '5': case '6': case '7': case '8': case '9':
245 case '#': case '-': case ' ': case '+': case '\'':
246 case 'h': case 'l': case 'j': case 't': case 'z':
247 case 'q': case 'L': case '.':
250 if (kvm_read(kd, (u_long)buf[i].ktr_parms[parm],
251 sbuf[parm], sizeof(sbuf[parm])) == -1)
252 strcpy(sbuf[parm], "(null)");
253 sbuf[parm][sizeof(sbuf[0]) - 1] = '\0';
254 parms[parm] = (u_long)sbuf[parm];
258 parms[parm] = buf[i].ktr_parms[parm];
263 fprintf(out, "%6d ", i);
265 fprintf(out, "%3d ", buf[i].ktr_cpu);
267 tnow = (uintmax_t)buf[i].ktr_timestamp;
271 fprintf(out, "%16ju ", !iflag ? tlast - tnow :
275 fprintf(out, "%16ju ", tnow);
278 if (kvm_read(kd, (u_long)buf[i].ktr_file, fbuf,
280 strcpy(fbuf, "(null)");
281 snprintf(obuf, sizeof(obuf), "%s:%d", fbuf,
283 fprintf(out, "%-40s ", obuf);
286 fprintf(out, "%p ", buf[i].ktr_thread);
287 fprintf(out, desc, parms[0], parms[1], parms[2], parms[3],
293 i = (i - 1) % entries;
307 fprintf(stderr, USAGE);