2 * Copyright (c) 1991, 1992 Paul Kranenburg <pk@cs.few.eur.nl>
3 * Copyright (c) 1993 Branko Lankester <branko@hacktic.nl>
4 * Copyright (c) 1993, 1994, 1995, 1996 Rick Sladkey <jrs@world.std.com>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40 /* configuration section */
42 #define MAX_QUALS 2048 /* maximum number of syscalls, signals, etc. */
45 #define MAX_PROCS 64 /* maximum number of processes tracable */
47 #ifndef DEFAULT_STRLEN
48 #define DEFAULT_STRLEN 32 /* default maximum # of bytes printed in
49 `printstr', change with `-s' switch */
51 #ifndef DEFAULT_ACOLUMN
52 #define DEFAULT_ACOLUMN 40 /* default alignment column for results */
55 #define MAX_ARGS 32 /* maximum number of args to a syscall */
57 #ifndef DEFAULT_SORTBY
58 #define DEFAULT_SORTBY "time" /* default sorting method for call profiling */
61 #include <sys/types.h>
72 #endif /* STDC_HEADERS */
84 #include <sys/procfs.h>
89 #if defined(LINUXSPARC) && defined(__GLIBC__)
90 #include <sys/ptrace.h>
92 /* Work around awkward prototype in ptrace.h. */
93 #define ptrace xptrace
94 #include <sys/ptrace.h>
98 #include <asm/ptrace.h>
104 #define ORIG_EAX PT_ORIG_R3
108 extern long ptrace(int, int, char *, long);
110 extern int ptrace(int, int, char *, int, ...);
112 #else /* !__STDC__ */
114 #endif /* !__STDC__ */
115 #endif /* !LINUXSPARC */
119 #if !defined(__GLIBC__)
120 #define PTRACE_PEEKUSER PTRACE_PEEKUSR
121 #define PTRACE_POKEUSER PTRACE_POKEUSR
139 #define SUPPORTED_PERSONALITIES 1
140 #define DEFAULT_PERSONALITY 0
143 #include <linux/a.out.h>
145 #undef SUPPORTED_PERSONALITIES
146 #define SUPPORTED_PERSONALITIES 2
147 #endif /* LINUXSPARC */
151 #ifdef HAVE_MP_PROCFS
152 extern int mp_ioctl (int f, int c, void *a, int s);
153 #define IOCTL(f,c,a) mp_ioctl (f, c, a, sizeof *a)
154 #define IOCTL_STATUS(t) \
155 pread (t->pfd_stat, &t->status, sizeof t->status, 0)
156 #define IOCTL_WSTOP(t) \
157 (IOCTL (t->pfd, PCWSTOP, NULL) < 0 ? -1 : \
159 #define PR_WHY pr_lwp.pr_why
160 #define PR_WHAT pr_lwp.pr_what
161 #define PR_REG pr_lwp.pr_context.uc_mcontext.gregs
162 #define PR_FLAGS pr_lwp.pr_flags
163 #define PIOCSTIP PCSTOP
164 #define PIOCSET PCSET
165 #define PIOCRESET PCRESET
166 #define PIOCSTRACE PCSTRACE
167 #define PIOCSFAULT PCSFAULT
168 #define PIOCWSTOP PCWSTOP
169 #define PIOCSTOP PCSTOP
170 #define PIOCSENTRY PCSENTRY
171 #define PIOCSEXIT PCSEXIT
172 #define PIOCRUN PCRUN
175 #define IOCTL_STATUS(t) ioctl (t->pfd, PIOCSTATUS, &t->status)
176 #define IOCTL_WSTOP(t) ioctl (t->pfd, PIOCWSTOP, &t->status)
177 #define PR_WHY pr_why
178 #define PR_WHAT pr_what
179 #define PR_REG pr_reg
180 #define PR_FLAGS pr_flags
184 /* Trace Control Block */
186 short flags; /* See below for TCB_ values */
187 int pid; /* Process Id of this entry */
188 long scno; /* System call number */
189 int u_nargs; /* System call arguments */
190 long u_arg[MAX_ARGS]; /* System call arguments */
191 int u_error; /* Error code */
192 long u_rval; /* (first) return value */
193 FILE *outf; /* Output file for this process */
194 char *auxstr; /* Auxiliary info from syscall (see RVAL_STR) */
195 struct timeval stime; /* System time usage as of last process wait */
196 struct timeval dtime; /* Delta for system time usage */
197 struct timeval etime; /* Syscall entry time */
198 /* Support for tracing forked processes */
199 struct tcb *parent; /* Parent of this process */
200 int nchildren; /* # of traced children */
201 int waitpid; /* pid(s) this process is waiting for */
202 /* (1st arg of wait4()) */
203 long baddr; /* `Breakpoint' address */
204 long inst[2]; /* Instructions on above */
205 int pfd; /* proc file descriptor */
207 #ifdef HAVE_MP_PROCFS
212 prstatus_t status; /* procfs status structure */
218 #define TCB_STARTUP 00001 /* We have just begun ptracing this process */
219 #define TCB_INUSE 00002 /* This table entry is in use */
220 #define TCB_INSYSCALL 00004 /* A system call is in progress */
221 #define TCB_ATTACHED 00010 /* Process is not our own child */
222 #define TCB_EXITING 00020 /* As far as we know, this process is exiting */
223 #define TCB_SUSPENDED 00040 /* Process has done a wait(4), that can
224 not be allowed to complete just now */
225 #define TCB_BPTSET 00100 /* "Breakpoint" set after fork(2) */
226 #define TCB_SIGTRAPPED 00200 /* Process wanted to block SIGTRAP */
227 #define TCB_FOLLOWFORK 00400 /* Process should have forks followed */
228 #define TCB_REPRINT 01000 /* We should reprint this syscall on exit */
230 #if defined(ALPHA) || defined(SPARC) || defined(POWERPC)
231 #define TCB_WAITEXECVE 02000 /* ignore SIGTRAP after exceve */
235 /* qualifier flags */
236 #define QUAL_TRACE 0001 /* this system call should be traced */
237 #define QUAL_ABBREV 0002 /* abbreviate the structures of this syscall */
238 #define QUAL_VERBOSE 0004 /* decode the structures of this syscall */
239 #define QUAL_RAW 0010 /* print all args in hex for this syscall */
240 #define QUAL_SIGNAL 0020 /* report events with this signal */
241 #define QUAL_FAULT 0040 /* report events with this fault */
242 #define QUAL_READ 0100 /* dump data read on this file descriptor */
243 #define QUAL_WRITE 0200 /* dump data written to this file descriptor */
245 #define entering(tcp) (!((tcp)->flags & TCB_INSYSCALL))
246 #define exiting(tcp) ((tcp)->flags & TCB_INSYSCALL)
247 #define syserror(tcp) ((tcp)->u_error != 0)
248 #define verbose(tcp) (qual_flags[(tcp)->scno] & QUAL_VERBOSE)
249 #define abbrev(tcp) (qual_flags[(tcp)->scno] & QUAL_ABBREV)
250 #define waiting_parent(tcp) \
252 (tcp->parent->flags & TCB_SUSPENDED) && \
253 (tcp->parent->waitpid <= 0 || tcp->parent->waitpid == tcp->pid))
260 /* Format of syscall return values */
261 #define RVAL_DECIMAL 000 /* decimal format */
262 #define RVAL_HEX 001 /* hex format */
263 #define RVAL_OCTAL 002 /* octal format */
264 #define RVAL_UDECIMAL 003 /* unsigned decimal format */
265 #define RVAL_MASK 007 /* mask for these values */
267 #define RVAL_STR 010 /* Print `auxstr' field after return val */
268 #define RVAL_NONE 020 /* Print nothing */
271 #define offsetof(type, member) (((char *) &(((type *) NULL)->member)) - \
272 ((char *) (type *) NULL))
273 #endif /* !offsetof */
275 /* get offset of member within a user struct */
276 #define uoff(member) offsetof(struct user, member)
278 #define TRACE_FILE 001 /* Trace file-related syscalls. */
279 #define TRACE_IPC 002 /* Trace IPC-related syscalls. */
280 #define TRACE_NETWORK 004 /* Trace network-related syscalls. */
281 #define TRACE_PROCESS 010 /* Trace process-related syscalls. */
282 #define TRACE_SIGNAL 020 /* Trace signal-related syscalls. */
284 extern struct tcb tcbtab[];
285 extern int qual_flags[];
286 extern int debug, followfork, followvfork;
287 extern int rflag, tflag, dtime, cflag, xflag, qflag;
289 extern char *outfname;
291 extern int max_strlen;
292 extern struct tcb *tcp_last;
300 extern int set_personality P((int personality));
301 extern char *xlookup P((struct xlat *, int));
302 extern struct tcb *alloctcb P((int));
303 extern void droptcb P((struct tcb *));
305 extern void set_sortby P((char *));
306 extern void set_overhead P((int));
307 extern void qualify P((char *));
308 extern void newoutf P((struct tcb *));
309 extern int trace_syscall P((struct tcb *));
310 extern void printxval P((struct xlat *, int, char *));
311 extern int printargs P((struct tcb *));
312 extern int addflags P((struct xlat *, int));
313 extern int printflags P((struct xlat *, int));
314 extern int umoven P((struct tcb *, long, int, char *));
315 extern int umovestr P((struct tcb *, long, int, char *));
316 extern int upeek P((int, long, long *));
317 extern void dumpstr P((struct tcb *, long, int));
318 extern void string_quote P((char *str));
319 extern void printstr P((struct tcb *, long, int));
320 extern void printnum P((struct tcb *, long, char *));
321 extern void printpath P((struct tcb *, long));
322 extern void printpathn P((struct tcb *, long, int));
323 extern void printtv P((struct tcb *, long));
324 extern void printsock P((struct tcb *, long, int));
325 extern void printrusage P((struct tcb *, long));
326 extern int clearbpt P((struct tcb *));
327 extern int setbpt P((struct tcb *));
328 extern int sigishandled P((struct tcb *, int));
329 extern void printcall P((struct tcb *));
330 extern char *signame P((int));
331 extern void printsignal P((int));
332 extern void printleader P((struct tcb *));
333 extern void printtrailer P((struct tcb *));
334 extern void tabto P((int));
335 extern void call_summary P((FILE *));
336 extern void fake_execve P((struct tcb *, char *, char *[], char *[]));
337 extern void printtv32 P((struct tcb*, long));
340 extern int internal_clone P((struct tcb *));
342 extern int internal_fork P((struct tcb *));
343 extern int internal_exec P((struct tcb *));
344 extern int internal_wait P((struct tcb *));
345 extern int internal_exit P((struct tcb *));
347 extern char *ioctl_lookup P((long));
348 extern int ioctl_decode P((struct tcb *, long, long));
349 extern int term_ioctl P((struct tcb *, long, long));
350 extern int sock_ioctl P((struct tcb *, long, long));
351 extern int proc_ioctl P((struct tcb *, int, int));
352 extern int stream_ioctl P((struct tcb *, int, int));
354 extern void tv_tv P((struct timeval *, int, int));
355 extern int tv_nz P((struct timeval *));
356 extern int tv_cmp P((struct timeval *, struct timeval *));
357 extern double tv_float P((struct timeval *));
358 extern void tv_add P((struct timeval *, struct timeval *, struct timeval *));
359 extern void tv_sub P((struct timeval *, struct timeval *, struct timeval *));
360 extern void tv_mul P((struct timeval *, struct timeval *, int));
361 extern void tv_div P((struct timeval *, struct timeval *, int));
364 extern int fixvfork P((struct tcb *));
366 #if !(defined(LINUX) && !defined(SPARC))
367 extern long getrval2 P((struct tcb *));
370 extern int proc_open P((struct tcb *tcp, int attaching));
373 #define umove(pid, addr, objp) \
374 umoven((pid), (addr), sizeof *(objp), (char *) (objp))
378 extern void tprintf(const char *fmt, ...)
379 __attribute__ ((format (printf, 1, 2)));
381 extern void tprintf(const char *fmt, ...);
384 extern void tprintf();
387 #ifndef HAVE_STRERROR
388 const char *strerror P((int));
390 #ifndef HAVE_STRSIGNAL
391 const char *strsignal P((int));
394 extern int current_personality;
403 extern struct sysent *sysent;
404 extern int nsyscalls;
406 extern char **errnoent;
415 extern struct ioctlent *ioctlent;
416 extern int nioctlent;
418 extern char **signalent;
421 extern struct ioctlent *ioctlent;
422 extern int nioctlents;
423 extern char **signalent;
426 extern struct ioctlent ioctlent0[];
427 extern int nioctlents0;
428 extern char *signalent0[];
429 extern int nsignals0;
431 #if SUPPORTED_PERSONALITIES >= 2
432 extern struct ioctlent ioctlent1[];
433 extern int nioctlents1;
434 extern char *signalent1[];
435 extern int nsignals1;
436 #endif /* SUPPORTED_PERSONALITIES >= 2 */
438 #if SUPPORTED_PERSONALITIES >= 3
439 extern struct ioctlent ioctlent2[];
440 extern int nioctlents2;
441 extern char *signalent2[];
442 extern int nsignals2;
443 #endif /* SUPPORTED_PERSONALITIES >= 3 */