2 * SPDX-License-Identifier: BSD-4-Clause
4 * Copyright 1997 Sean Eric Fagan
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.
14 * 3. All advertising materials mentioning features or use of this software
15 * must display the following acknowledgement:
16 * This product includes software developed by Sean Eric Fagan
17 * 4. Neither the name of the author may be used to endorse or promote
18 * products derived from this software without specific prior written
21 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR 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 AUTHOR 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
34 #include <sys/cdefs.h>
35 __FBSDID("$FreeBSD$");
38 * The main module for truss. Surprisingly simple, but, then, the other
39 * files handle the bulk of the work. And, of course, the kernel has to
40 * do a lot of the work :).
43 #include <sys/ptrace.h>
50 #include <sysdecode.h>
61 fprintf(stderr, "%s\n%s\n",
62 "usage: truss [-cfaedDHS] [-o file] [-s strsize] -p pid",
63 " truss [-cfaedDHS] [-o file] [-s strsize] command [args]");
68 main(int ac, char **av)
71 struct trussinfo *trussinfo;
80 /* Initialize the trussinfo struct */
81 trussinfo = (struct trussinfo *)calloc(1, sizeof(struct trussinfo));
82 if (trussinfo == NULL)
83 errx(1, "calloc() failed");
86 trussinfo->outfile = stderr;
87 trussinfo->strsize = 32;
88 trussinfo->curthread = NULL;
89 LIST_INIT(&trussinfo->proclist);
91 while ((c = getopt(ac, av, "p:o:facedDs:SH")) != -1) {
93 case 'p': /* specified pid */
95 /* make sure i don't trace me */
96 if (pid == getpid()) {
97 errx(2, "attempt to grab self.");
100 case 'f': /* Follow fork()'s */
101 trussinfo->flags |= FOLLOWFORKS;
103 case 'a': /* Print execve() argument strings. */
104 trussinfo->flags |= EXECVEARGS;
106 case 'c': /* Count number of system calls and time. */
107 trussinfo->flags |= (COUNTONLY | NOSIGS);
109 case 'e': /* Print execve() environment strings. */
110 trussinfo->flags |= EXECVEENVS;
112 case 'd': /* Absolute timestamps */
113 trussinfo->flags |= ABSOLUTETIMESTAMPS;
115 case 'D': /* Relative timestamps */
116 trussinfo->flags |= RELATIVETIMESTAMPS;
118 case 'o': /* Specified output file */
121 case 's': /* Specified string size */
122 trussinfo->strsize = strtonum(optarg, 0, INT_MAX, &errstr);
124 errx(1, "maximum string size is %s: %s", errstr, optarg);
126 case 'S': /* Don't trace signals */
127 trussinfo->flags |= NOSIGS;
130 trussinfo->flags |= DISPLAYTIDS;
137 ac -= optind; av += optind;
138 if ((pid == 0 && ac == 0) ||
139 (pid != 0 && ac != 0))
142 if (fname != NULL) { /* Use output file */
144 * Set close-on-exec ('e'), so that the output file is not
145 * shared with the traced process.
147 if ((trussinfo->outfile = fopen(fname, "we")) == NULL)
148 err(1, "cannot open %s", fname);
152 * If truss starts the process itself, it will ignore some signals --
153 * they should be passed off to the process, which may or may not
154 * exit. If, however, we are examining an already-running process,
155 * then we restore the event mask on these same signals.
158 /* Start a command ourselves */
160 setup_and_wait(trussinfo, command);
161 signal(SIGINT, SIG_IGN);
162 signal(SIGTERM, SIG_IGN);
163 signal(SIGQUIT, SIG_IGN);
165 sa.sa_handler = restore_proc;
167 sigemptyset(&sa.sa_mask);
168 sigaction(SIGINT, &sa, NULL);
169 sigaction(SIGQUIT, &sa, NULL);
170 sigaction(SIGTERM, &sa, NULL);
171 start_tracing(trussinfo, pid);
175 * At this point, if we started the process, it is stopped waiting to
176 * be woken up, either in exit() or in execve().
178 if (LIST_FIRST(&trussinfo->proclist)->abi == NULL) {
180 * If we are not able to handle this ABI, detach from the
181 * process and exit. If we just created a new process to
182 * run a command, kill the new process rather than letting
186 kill(LIST_FIRST(&trussinfo->proclist)->pid, SIGKILL);
187 ptrace(PT_DETACH, LIST_FIRST(&trussinfo->proclist)->pid, NULL,
191 ptrace(PT_SYSCALL, LIST_FIRST(&trussinfo->proclist)->pid, (caddr_t)1,
195 * At this point, it's a simple loop, waiting for the process to
196 * stop, finding out why, printing out why, and then continuing it.
197 * All of the grunt work is done in the support routines.
199 clock_gettime(CLOCK_REALTIME, &trussinfo->start_time);
201 eventloop(trussinfo);
203 if (trussinfo->flags & COUNTONLY)
204 print_summary(trussinfo);
206 fflush(trussinfo->outfile);