iscontrol(8): Fix synopsis, sync usage() & improve markup
[dragonfly.git] / usr.bin / ktrace / ktrace.c
blob261d4fbd2121d3d9d00b490ce6fcd0fb673cbcc0
1 /*-
2 * Copyright (c) 1988, 1993
3 * The Regents of the University of California. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. All advertising materials mentioning features or use of this software
14 * must display the following acknowledgement:
15 * This product includes software developed by the University of
16 * California, Berkeley and its contributors.
17 * 4. Neither the name of the University nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 * SUCH DAMAGE.
33 * @(#) Copyright (c) 1988, 1993 The Regents of the University of California. All rights reserved.
34 * @(#)ktrace.c 8.1 (Berkeley) 6/6/93
35 * $FreeBSD: src/usr.bin/ktrace/ktrace.c,v 1.12.2.3 2001/07/11 00:29:27 mikeh Exp $
36 * $DragonFly: src/usr.bin/ktrace/ktrace.c,v 1.4 2005/06/01 03:05:40 swildner Exp $
39 #include <sys/param.h>
40 #include <sys/stat.h>
41 #include <sys/file.h>
42 #include <sys/time.h>
43 #include <sys/errno.h>
44 #include <sys/uio.h>
45 #include <sys/ktrace.h>
47 #include <err.h>
48 #include <stdio.h>
49 #include <stdlib.h>
50 #include <unistd.h>
52 #include "ktrace.h"
54 static void no_ktrace(int);
55 static int rpid(char *p);
56 static void usage(void);
58 int
59 main(int argc, char **argv)
61 enum { NOTSET, CLEAR, CLEARALL } clear;
62 int append, ch, fd, inherit, ops, pid, pidset, trpoints;
63 const char *tracefile;
64 mode_t omask;
65 struct stat sb;
67 clear = NOTSET;
68 append = ops = pid = pidset = inherit = 0;
69 trpoints = DEF_POINTS;
70 tracefile = DEF_TRACEFILE;
71 while ((ch = getopt(argc, argv, "aCcdf:g:ip:t:")) != -1)
72 switch(ch) {
73 case 'a':
74 append = 1;
75 break;
76 case 'C':
77 clear = CLEARALL;
78 pidset = 1;
79 break;
80 case 'c':
81 clear = CLEAR;
82 break;
83 case 'd':
84 ops |= KTRFLAG_DESCEND;
85 break;
86 case 'f':
87 tracefile = optarg;
88 break;
89 case 'g':
90 pid = -rpid(optarg);
91 pidset = 1;
92 break;
93 case 'i':
94 inherit = 1;
95 break;
96 case 'p':
97 pid = rpid(optarg);
98 pidset = 1;
99 break;
100 case 't':
101 trpoints = getpoints(optarg);
102 if (trpoints < 0) {
103 warnx("unknown facility in %s", optarg);
104 usage();
106 break;
107 default:
108 usage();
110 argv += optind;
111 argc -= optind;
113 if ((pidset && *argv) || (!pidset && clear == NOTSET && !*argv))
114 usage();
116 if (inherit)
117 trpoints |= KTRFAC_INHERIT;
119 signal(SIGSYS, no_ktrace);
120 if (clear != NOTSET) {
121 if (clear == CLEARALL) {
122 ops = KTROP_CLEAR | KTRFLAG_DESCEND;
123 trpoints = ALL_POINTS;
124 pid = 1;
125 } else
126 ops |= pidset ? KTROP_CLEAR : KTROP_CLEARFILE;
128 if (ktrace(tracefile, ops, trpoints, pid) < 0)
129 err(1, "%s", tracefile);
130 exit(0);
133 omask = umask(S_IRWXG|S_IRWXO);
134 if (append) {
135 if ((fd = open(tracefile, O_CREAT | O_WRONLY, DEFFILEMODE)) < 0)
136 err(1, "%s", tracefile);
137 if (fstat(fd, &sb) != 0 || sb.st_uid != getuid())
138 errx(1, "Refuse to append to %s not owned by you.",
139 tracefile);
140 } else {
141 if (unlink(tracefile) == -1 && errno != ENOENT)
142 err(1, "unlink %s", tracefile);
143 if ((fd = open(tracefile, O_CREAT | O_EXCL | O_WRONLY,
144 DEFFILEMODE)) < 0)
145 err(1, "%s", tracefile);
147 umask(omask);
148 close(fd);
150 if (*argv) {
151 if (ktrace(tracefile, ops, trpoints, getpid()) < 0)
152 err(1, "%s", tracefile);
153 execvp(argv[0], &argv[0]);
154 err(1, "exec of '%s' failed", argv[0]);
156 else if (ktrace(tracefile, ops, trpoints, pid) < 0)
157 err(1, "%s", tracefile);
158 exit(0);
161 static int
162 rpid(char *p)
164 static int first;
166 if (first++) {
167 warnx("only one -g or -p flag is permitted.");
168 usage();
170 if (!*p) {
171 warnx("illegal process id.");
172 usage();
174 return(atoi(p));
177 static void
178 usage(void)
180 fprintf(stderr, "%s\n%s\n",
181 "usage: ktrace [-aCcdi] [-f trfile] [-g pgrp | -p pid] [-t cnisuw]",
182 " ktrace [-adi] [-f trfile] [-t cnisuw] command");
183 exit(1);
186 static void
187 no_ktrace(int sig __unused)
189 fprintf(stderr,
190 "error:\tktrace() system call not supported in the running kernel\n\tre-compile kernel with 'options KTRACE'\n");
191 exit(1);