blob: a56563235c01729da51be5715e4d745f086ef1bc [file] [log] [blame]
Wichert Akkerman76baf7c1999-02-19 00:21:36 +00001/*
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>
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
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.
17 *
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.
28 *
29 * $Id$
30 */
31
Roland McGrath795edb12005-02-02 04:44:57 +000032#ifdef HAVE_CONFIG_H
Denys Vlasenko329655a2012-02-25 02:42:32 +010033# include "config.h"
Roland McGrath795edb12005-02-02 04:44:57 +000034#endif
35
Roland McGrath542c2c62008-05-20 01:11:56 +000036#ifdef MIPS
Denys Vlasenko329655a2012-02-25 02:42:32 +010037# include <sgidefs.h>
Roland McGrath542c2c62008-05-20 01:11:56 +000038#endif
39
Wichert Akkermanb859bea1999-04-18 22:50:50 +000040#include <features.h>
Wichert Akkermanb859bea1999-04-18 22:50:50 +000041
Roland McGrathe6d3a292003-01-14 09:46:18 +000042#ifdef _LARGEFILE64_SOURCE
43/* This is the macro everything checks before using foo64 names. */
44# ifndef _LFS64_LARGEFILE
45# define _LFS64_LARGEFILE 1
46# endif
47#endif
48
Denys Vlasenkod9560c12011-08-19 17:41:28 +020049/* Configuration section */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000050#ifndef MAX_QUALS
Denys Vlasenko329655a2012-02-25 02:42:32 +010051# if defined(MIPS)
52# define MAX_QUALS 7000 /* maximum number of syscalls, signals, etc. */
53# else
54# define MAX_QUALS 2048 /* maximum number of syscalls, signals, etc. */
55# endif
Wichert Akkerman5ae21ea2000-05-01 01:53:59 +000056#endif
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000057#ifndef DEFAULT_STRLEN
Denys Vlasenko041b3ee2011-08-18 12:48:56 +020058/* default maximum # of bytes printed in `printstr', change with -s switch */
Denys Vlasenko329655a2012-02-25 02:42:32 +010059# define DEFAULT_STRLEN 32
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000060#endif
61#ifndef DEFAULT_ACOLUMN
Denys Vlasenko329655a2012-02-25 02:42:32 +010062# define DEFAULT_ACOLUMN 40 /* default alignment column for results */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000063#endif
Denys Vlasenkod9560c12011-08-19 17:41:28 +020064
65/* Maximum number of args to a syscall.
66 *
Denys Vlasenkoaa925db2012-02-25 15:19:02 +010067 * Make sure that all entries in all syscallent.h files have nargs <= MAX_ARGS!
Denys Vlasenko44142a72011-08-23 18:04:25 +020068 * linux/<ARCH>/syscallent.h: all have nargs <= 6.
Denys Vlasenkod9560c12011-08-19 17:41:28 +020069 */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000070#ifndef MAX_ARGS
Denys Vlasenko329655a2012-02-25 02:42:32 +010071# define MAX_ARGS 6
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000072#endif
Denys Vlasenkod9560c12011-08-19 17:41:28 +020073
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000074#ifndef DEFAULT_SORTBY
Denys Vlasenko329655a2012-02-25 02:42:32 +010075# define DEFAULT_SORTBY "time" /* default sorting method for call profiling */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000076#endif
77
78#include <sys/types.h>
79#include <unistd.h>
80#include <stdlib.h>
81#include <stdio.h>
82#include <ctype.h>
83#include <string.h>
Wichert Akkerman8c7122c2001-02-16 19:59:55 +000084#include <time.h>
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000085#include <sys/time.h>
86#include <errno.h>
87
Roland McGrath639658b2008-08-01 01:06:31 +000088#ifdef HAVE_STDBOOL_H
Denys Vlasenko329655a2012-02-25 02:42:32 +010089# include <stdbool.h>
Roland McGrath639658b2008-08-01 01:06:31 +000090#endif
91
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000092#ifdef STDC_HEADERS
Denys Vlasenko329655a2012-02-25 02:42:32 +010093# include <stddef.h>
Wichert Akkerman76baf7c1999-02-19 00:21:36 +000094#endif /* STDC_HEADERS */
95
John Hughes58265892001-10-18 15:13:53 +000096#ifdef HAVE_SIGINFO_T
Denys Vlasenko329655a2012-02-25 02:42:32 +010097# include <signal.h>
John Hughes58265892001-10-18 15:13:53 +000098#endif
99
Denys Vlasenko329655a2012-02-25 02:42:32 +0100100#if defined(SPARC) || defined(SPARC64)
101# define LINUXSPARC
102#endif
103#if defined(MIPS) && _MIPS_SIM == _MIPS_SIM_ABI32
104# define LINUX_MIPSO32
105#endif
106#if defined(MIPS) && _MIPS_SIM == _MIPS_SIM_NABI32
107# define LINUX_MIPSN32
108# define LINUX_MIPS64
109#endif
110#if defined(MIPS) && _MIPS_SIM == _MIPS_SIM_ABI64
111# define LINUX_MIPSN64
112# define LINUX_MIPS64
113#endif
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000114
Denys Vlasenko329655a2012-02-25 02:42:32 +0100115#if (defined(LINUXSPARC) || defined(X86_64) || defined(ARM) || defined(AVR32)) && defined(__GLIBC__)
116# include <sys/ptrace.h>
117#else
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000118/* Work around awkward prototype in ptrace.h. */
Denys Vlasenko329655a2012-02-25 02:42:32 +0100119# define ptrace xptrace
120# include <sys/ptrace.h>
121# undef ptrace
122# ifdef POWERPC
123# define __KERNEL__
124# include <asm/ptrace.h>
125# undef __KERNEL__
Denys Vlasenko77770bb2011-08-26 19:25:09 +0200126# endif
Denys Vlasenko329655a2012-02-25 02:42:32 +0100127extern long ptrace(int, int, char *, long);
128#endif
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000129
Wichert Akkermanb859bea1999-04-18 22:50:50 +0000130#if !defined(__GLIBC__)
Denys Vlasenko329655a2012-02-25 02:42:32 +0100131# define PTRACE_PEEKUSER PTRACE_PEEKUSR
132# define PTRACE_POKEUSER PTRACE_POKEUSR
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000133#endif
Denys Vlasenkoeb0e3e82011-08-30 18:53:49 +0200134#if defined(X86_64) || defined(I386)
135/* For struct pt_regs. x86 strace uses PTRACE_GETREGS.
136 * PTRACE_GETREGS returns registers in the layout of this struct.
137 */
Denys Vlasenko329655a2012-02-25 02:42:32 +0100138# include <asm/ptrace.h>
Denys Vlasenkoeb0e3e82011-08-30 18:53:49 +0200139#endif
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000140#ifdef ALPHA
Denys Vlasenko329655a2012-02-25 02:42:32 +0100141# define REG_R0 0
142# define REG_A0 16
143# define REG_A3 19
144# define REG_FP 30
145# define REG_PC 64
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000146#endif /* ALPHA */
Wichert Akkermanf90da011999-10-31 21:15:38 +0000147#ifdef MIPS
Denys Vlasenko329655a2012-02-25 02:42:32 +0100148# define REG_V0 2
149# define REG_A0 4
150# define REG_A3 7
151# define REG_SP 29
152# define REG_EPC 64
Wichert Akkermanf90da011999-10-31 21:15:38 +0000153#endif /* MIPS */
Wichert Akkermanc1652e22001-03-27 12:17:16 +0000154#ifdef HPPA
Denys Vlasenko329655a2012-02-25 02:42:32 +0100155# define PT_GR20 (20*4)
156# define PT_GR26 (26*4)
157# define PT_GR28 (28*4)
158# define PT_IAOQ0 (106*4)
159# define PT_IAOQ1 (107*4)
Wichert Akkermanc1652e22001-03-27 12:17:16 +0000160#endif /* HPPA */
Roland McGrathf5a47772003-06-26 22:40:42 +0000161#ifdef SH64
162 /* SH64 Linux - this code assumes the following kernel API for system calls:
Roland McGrathe1e584b2003-06-02 19:18:58 +0000163 PC Offset 0
164 System Call Offset 16 (actually, (syscall no.) | (0x1n << 16),
165 where n = no. of parameters.
166 Other regs Offset 24+
167
168 On entry: R2-7 = parameters 1-6 (as many as necessary)
169 On return: R9 = result. */
170
171 /* Offset for peeks of registers */
Denys Vlasenko329655a2012-02-25 02:42:32 +0100172# define REG_OFFSET (24)
173# define REG_GENERAL(x) (8*(x)+REG_OFFSET)
174# define REG_PC (0*8)
175# define REG_SYSCALL (2*8)
Roland McGrathf5a47772003-06-26 22:40:42 +0000176#endif /* SH64 */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000177
178#define SUPPORTED_PERSONALITIES 1
179#define DEFAULT_PERSONALITY 0
180
181#ifdef LINUXSPARC
Mike Frysinger8566c502009-10-12 11:05:14 -0400182/* Indexes into the pt_regs.u_reg[] array -- UREG_XX from kernel are all off
183 * by 1 and use Ix instead of Ox. These work for both 32 and 64 bit Linux. */
Denys Vlasenko329655a2012-02-25 02:42:32 +0100184# define U_REG_G1 0
185# define U_REG_O0 7
186# define U_REG_O1 8
187# define PERSONALITY0_WORDSIZE 4
188# define PERSONALITY1_WORDSIZE 4
189# undef SUPPORTED_PERSONALITIES
190# if defined(SPARC64)
191# include <asm/psrcompat.h>
192# define SUPPORTED_PERSONALITIES 3
193# define PERSONALITY2_WORDSIZE 8
194# else
195# include <asm/psr.h>
196# define SUPPORTED_PERSONALITIES 2
197# endif /* SPARC64 */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000198#endif /* LINUXSPARC */
199
Michal Ludvig0e035502002-09-23 15:41:01 +0000200#ifdef X86_64
Denys Vlasenko329655a2012-02-25 02:42:32 +0100201# undef SUPPORTED_PERSONALITIES
202# define SUPPORTED_PERSONALITIES 2
203# define PERSONALITY0_WORDSIZE 8
204# define PERSONALITY1_WORDSIZE 4
Roland McGrathee9d4352002-12-18 04:16:10 +0000205#endif
206
Roland McGrath56703312008-05-20 01:35:55 +0000207#ifdef ARM
Denys Vlasenko329655a2012-02-25 02:42:32 +0100208# undef SUPPORTED_PERSONALITIES
209# define SUPPORTED_PERSONALITIES 2
210# define PERSONALITY0_WORDSIZE 4
211# define PERSONALITY1_WORDSIZE 4
Roland McGrath56703312008-05-20 01:35:55 +0000212#endif
213
Andreas Schwabd69fa492010-07-12 21:39:57 +0200214#ifdef POWERPC64
Denys Vlasenko329655a2012-02-25 02:42:32 +0100215# undef SUPPORTED_PERSONALITIES
216# define SUPPORTED_PERSONALITIES 2
217# define PERSONALITY0_WORDSIZE 8
218# define PERSONALITY1_WORDSIZE 4
Andreas Schwabd69fa492010-07-12 21:39:57 +0200219#endif
220
Denys Vlasenko329655a2012-02-25 02:42:32 +0100221#if !HAVE_DECL_PTRACE_SETOPTIONS
222# define PTRACE_SETOPTIONS 0x4200
223#endif
224#if !HAVE_DECL_PTRACE_GETEVENTMSG
225# define PTRACE_GETEVENTMSG 0x4201
226#endif
227#if !HAVE_DECL_PTRACE_GETSIGINFO
228# define PTRACE_GETSIGINFO 0x4202
229#endif
Dmitry V. Levin1b0df402011-07-19 22:13:11 +0000230
Denys Vlasenko329655a2012-02-25 02:42:32 +0100231#if !HAVE_DECL_PTRACE_O_TRACESYSGOOD
232# define PTRACE_O_TRACESYSGOOD 0x00000001
233#endif
234#if !HAVE_DECL_PTRACE_O_TRACEFORK
235# define PTRACE_O_TRACEFORK 0x00000002
236#endif
237#if !HAVE_DECL_PTRACE_O_TRACEVFORK
238# define PTRACE_O_TRACEVFORK 0x00000004
239#endif
240#if !HAVE_DECL_PTRACE_O_TRACECLONE
241# define PTRACE_O_TRACECLONE 0x00000008
242#endif
243#if !HAVE_DECL_PTRACE_O_TRACEEXEC
244# define PTRACE_O_TRACEEXEC 0x00000010
245#endif
246#if !HAVE_DECL_PTRACE_O_TRACEEXIT
247# define PTRACE_O_TRACEEXIT 0x00000040
248#endif
Wang Chaob13c0de2010-11-12 17:25:19 +0800249
Denys Vlasenko329655a2012-02-25 02:42:32 +0100250#if !HAVE_DECL_PTRACE_EVENT_FORK
251# define PTRACE_EVENT_FORK 1
252#endif
253#if !HAVE_DECL_PTRACE_EVENT_VFORK
254# define PTRACE_EVENT_VFORK 2
255#endif
256#if !HAVE_DECL_PTRACE_EVENT_CLONE
257# define PTRACE_EVENT_CLONE 3
258#endif
259#if !HAVE_DECL_PTRACE_EVENT_EXEC
260# define PTRACE_EVENT_EXEC 4
261#endif
262#if !HAVE_DECL_PTRACE_EVENT_VFORK_DONE
263# define PTRACE_EVENT_VFORK_DONE 5
264#endif
265#if !HAVE_DECL_PTRACE_EVENT_EXIT
266# define PTRACE_EVENT_EXIT 6
267#endif
Denys Vlasenko31fa8a22012-01-29 02:01:44 +0100268
269/* Experimental code using PTRACE_SEIZE can be enabled here: */
270//# define USE_SEIZE 1
271
Denys Vlasenko329655a2012-02-25 02:42:32 +0100272#ifdef USE_SEIZE
273# undef PTRACE_SEIZE
274# define PTRACE_SEIZE 0x4206
275# undef PTRACE_INTERRUPT
276# define PTRACE_INTERRUPT 0x4207
277# undef PTRACE_LISTEN
278# define PTRACE_LISTEN 0x4208
279# undef PTRACE_SEIZE_DEVEL
280# define PTRACE_SEIZE_DEVEL 0x80000000
281# undef PTRACE_EVENT_STOP
282# define PTRACE_EVENT_STOP 7
283# define PTRACE_EVENT_STOP1 128
284#endif
Denys Vlasenko31fa8a22012-01-29 02:01:44 +0100285
Denys Vlasenko75422762011-05-27 14:36:01 +0200286#if !defined __GNUC__
287# define __attribute__(x) /*nothing*/
288#endif
289
Dmitry V. Levinfcda7a52011-06-13 21:58:43 +0000290#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
291
Denys Vlasenko329655a2012-02-25 02:42:32 +0100292#if defined(I386)
Dmitry V. Levin024cad92012-01-17 18:37:13 +0000293extern struct pt_regs i386_regs;
Denys Vlasenko329655a2012-02-25 02:42:32 +0100294#endif
Denys Vlasenkob11322f2012-01-10 16:40:35 +0100295
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000296/* Trace Control Block */
297struct tcb {
Denys Vlasenkod9ec1412011-08-20 01:39:05 +0200298 int flags; /* See below for TCB_ values */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000299 int pid; /* Process Id of this entry */
Denys Vlasenko8dc0c8c2011-08-20 13:44:56 +0200300 int u_nargs; /* System call argument count */
Denys Vlasenko92d443c2011-08-25 00:25:08 +0200301 int u_error; /* Error code */
302 long scno; /* System call number */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000303 long u_arg[MAX_ARGS]; /* System call arguments */
Denys Vlasenko329655a2012-02-25 02:42:32 +0100304#if defined(LINUX_MIPSN32)
Roland McGrath542c2c62008-05-20 01:11:56 +0000305 long long ext_arg[MAX_ARGS]; /* System call arguments */
306#endif
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000307 long u_rval; /* (first) return value */
Wichert Akkerman16a03d22000-08-10 02:14:04 +0000308#ifdef HAVE_LONG_LONG
309 long long u_lrval; /* long long return value */
310#endif
Denys Vlasenko92d443c2011-08-25 00:25:08 +0200311 int ptrace_errno;
Dmitry V. Levina5a839a2011-12-23 00:50:49 +0000312#if SUPPORTED_PERSONALITIES > 1
313 int currpers; /* Personality at the time of scno update */
314#endif
Andreas Schwabccdff482009-10-27 16:27:13 +0100315 int curcol; /* Output column for this process */
Denys Vlasenko92d443c2011-08-25 00:25:08 +0200316 FILE *outf; /* Output file for this process */
Wichert Akkerman43a74822000-06-27 17:33:32 +0000317 const char *auxstr; /* Auxiliary info from syscall (see RVAL_STR) */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000318 struct timeval stime; /* System time usage as of last process wait */
319 struct timeval dtime; /* Delta for system time usage */
320 struct timeval etime; /* Syscall entry time */
321 /* Support for tracing forked processes */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000322 long baddr; /* `Breakpoint' address */
323 long inst[2]; /* Instructions on above */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000324};
325
326/* TCB flags */
Denys Vlasenkof88837a2011-09-05 14:05:46 +0200327#define TCB_INUSE 00001 /* This table entry is in use */
328/* We have attached to this process, but did not see it stopping yet.
329 * (If this bit is not set, we either didn't attach yet,
330 * or we did attach to it, already saw it stopping at least once,
331 * did some init work on it and cleared this bit. TODO: maybe it makes sense
332 * to split these two states?)
333 */
334#define TCB_STARTUP 00002
335#define TCB_IGNORE_ONE_SIGSTOP 00004 /* Next SIGSTOP is to be ignored */
Denys Vlasenkob88f9612011-08-21 18:03:23 +0200336/*
337 * Are we in system call entry or in syscall exit?
338 *
339 * This bit is set after all syscall entry processing is done.
340 * Therefore, this bit will be set when next ptrace stop occurs,
341 * which should be syscall exit stop. Other stops which are possible
342 * directly after syscall entry (death, ptrace event stop)
343 * are simpler and handled without calling trace_syscall(), therefore
344 * the places where TCB_INSYSCALL can be set but we aren't in syscall stop
345 * are limited to trace(), this condition is never observed in trace_syscall()
346 * and below.
347 * The bit is cleared after all syscall exit processing is done.
348 * User-generated SIGTRAPs and post-execve SIGTRAP make it necessary
349 * to be very careful and NOT set TCB_INSYSCALL bit when they are encountered.
350 * TCB_WAITEXECVE bit is used for this purpose (see below).
351 *
352 * Use entering(tcp) / exiting(tcp) to check this bit to make code more readable.
353 */
Denys Vlasenkof88837a2011-09-05 14:05:46 +0200354#define TCB_INSYSCALL 00010
Denys Vlasenko75fe85c2012-03-09 15:15:24 +0100355#define TCB_ATTACHED 00020 /* It is attached already */
356/* Are we PROG from "strace PROG [ARGS]" invocation? */
357#define TCB_STRACE_CHILD 00040
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000358#define TCB_BPTSET 00100 /* "Breakpoint" set after fork(2) */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000359#define TCB_REPRINT 01000 /* We should reprint this syscall on exit */
Grant Edwards8a082772011-04-07 20:25:40 +0000360#define TCB_FILTERED 02000 /* This system call has been filtered out */
Roland McGratheb9e2e82009-06-02 16:49:22 -0700361/* x86 does not need TCB_WAITEXECVE.
Denys Vlasenkob88f9612011-08-21 18:03:23 +0200362 * It can detect SIGTRAP by looking at eax/rax.
Denys Vlasenko8b4454c2011-08-25 10:40:14 +0200363 * See "not a syscall entry (eax = %ld)\n" message
364 * in syscall_fixup_on_sysenter().
Denys Vlasenkobc161ec2009-01-02 18:02:45 +0000365 */
Denys Vlasenko329655a2012-02-25 02:42:32 +0100366#if defined(ALPHA) || defined(AVR32) || defined(SPARC) || defined(SPARC64) \
Denys Vlasenkoc71016e2009-03-06 00:33:24 +0000367 || defined(POWERPC) || defined(IA64) || defined(HPPA) \
368 || defined(SH) || defined(SH64) || defined(S390) || defined(S390X) \
Chris Metcalfc8c66982009-12-28 10:00:15 -0500369 || defined(ARM) || defined(MIPS) || defined(BFIN) || defined(TILE)
Denys Vlasenkob88f9612011-08-21 18:03:23 +0200370/* This tracee has entered into execve syscall. Expect post-execve SIGTRAP
371 * to happen. (When it is detected, tracee is continued and this bit is cleared.)
372 */
Denys Vlasenko329655a2012-02-25 02:42:32 +0100373# define TCB_WAITEXECVE 04000
374#endif
375#include <sys/syscall.h>
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000376
377/* qualifier flags */
378#define QUAL_TRACE 0001 /* this system call should be traced */
379#define QUAL_ABBREV 0002 /* abbreviate the structures of this syscall */
380#define QUAL_VERBOSE 0004 /* decode the structures of this syscall */
381#define QUAL_RAW 0010 /* print all args in hex for this syscall */
382#define QUAL_SIGNAL 0020 /* report events with this signal */
383#define QUAL_FAULT 0040 /* report events with this fault */
384#define QUAL_READ 0100 /* dump data read on this file descriptor */
385#define QUAL_WRITE 0200 /* dump data written to this file descriptor */
386
387#define entering(tcp) (!((tcp)->flags & TCB_INSYSCALL))
388#define exiting(tcp) ((tcp)->flags & TCB_INSYSCALL)
389#define syserror(tcp) ((tcp)->u_error != 0)
390#define verbose(tcp) (qual_flags[(tcp)->scno] & QUAL_VERBOSE)
391#define abbrev(tcp) (qual_flags[(tcp)->scno] & QUAL_ABBREV)
Grant Edwards8a082772011-04-07 20:25:40 +0000392#define filtered(tcp) ((tcp)->flags & TCB_FILTERED)
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000393
394struct xlat {
395 int val;
Dmitry V. Levin30145dd2010-09-06 22:08:24 +0000396 const char *str;
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000397};
398
Denys Vlasenkof535b542009-01-13 18:30:55 +0000399extern const struct xlat open_mode_flags[];
400extern const struct xlat addrfams[];
401extern const struct xlat struct_user_offsets[];
402extern const struct xlat open_access_modes[];
403
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000404/* Format of syscall return values */
405#define RVAL_DECIMAL 000 /* decimal format */
406#define RVAL_HEX 001 /* hex format */
407#define RVAL_OCTAL 002 /* octal format */
408#define RVAL_UDECIMAL 003 /* unsigned decimal format */
Wichert Akkermanbf79f2e2000-09-01 21:03:06 +0000409#define RVAL_LDECIMAL 004 /* long decimal format */
410#define RVAL_LHEX 005 /* long hex format */
411#define RVAL_LOCTAL 006 /* long octal format */
412#define RVAL_LUDECIMAL 007 /* long unsigned decimal format */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000413#define RVAL_MASK 007 /* mask for these values */
414
415#define RVAL_STR 010 /* Print `auxstr' field after return val */
416#define RVAL_NONE 020 /* Print nothing */
417
418#ifndef offsetof
Denys Vlasenko329655a2012-02-25 02:42:32 +0100419# define offsetof(type, member) (((char *) &(((type *) NULL)->member)) - \
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000420 ((char *) (type *) NULL))
Denys Vlasenko329655a2012-02-25 02:42:32 +0100421#endif
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000422
423/* get offset of member within a user struct */
424#define uoff(member) offsetof(struct user, member)
425
426#define TRACE_FILE 001 /* Trace file-related syscalls. */
427#define TRACE_IPC 002 /* Trace IPC-related syscalls. */
428#define TRACE_NETWORK 004 /* Trace network-related syscalls. */
429#define TRACE_PROCESS 010 /* Trace process-related syscalls. */
430#define TRACE_SIGNAL 020 /* Trace signal-related syscalls. */
Roland McGrath2fe7b132005-07-05 03:25:35 +0000431#define TRACE_DESC 040 /* Trace file descriptor-related syscalls. */
Dmitry V. Levin7655fa02011-02-05 01:07:08 +0000432#define SYSCALL_NEVER_FAILS 0100 /* Syscall is always successful. */
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000433
Dmitry V. Levine3a7ef52010-03-28 19:24:54 +0000434typedef enum {
435 CFLAG_NONE = 0,
436 CFLAG_ONLY_STATS,
437 CFLAG_BOTH
438} cflag_t;
439
Roland McGrath138c6a32006-01-12 09:50:49 +0000440extern int *qual_flags;
Roland McGrath41c48222008-07-18 00:25:10 +0000441extern int debug, followfork;
Denys Vlasenkof44cce42011-06-21 14:34:10 +0200442extern unsigned int ptrace_setoptions;
Dmitry V. Levine3a7ef52010-03-28 19:24:54 +0000443extern int dtime, xflag, qflag;
444extern cflag_t cflag;
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000445extern int max_strlen;
Dmitry V. Levina7945a32006-12-13 17:10:11 +0000446enum bitness_t { BITNESS_CURRENT = 0, BITNESS_32 };
447
Denys Vlasenko75422762011-05-27 14:36:01 +0200448void error_msg(const char *fmt, ...) __attribute__ ((format(printf, 1, 2)));
449void perror_msg(const char *fmt, ...) __attribute__ ((format(printf, 1, 2)));
450void error_msg_and_die(const char *fmt, ...) __attribute__ ((noreturn, format(printf, 1, 2)));
451void perror_msg_and_die(const char *fmt, ...) __attribute__ ((noreturn, format(printf, 1, 2)));
Denys Vlasenko1d46ba52011-08-31 14:00:02 +0200452void die_out_of_memory(void) __attribute__ ((noreturn));
Denys Vlasenko75422762011-05-27 14:36:01 +0200453
Denys Vlasenko5c774b22011-08-20 01:50:09 +0200454extern void set_personality(int personality);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100455extern const char *xlookup(const struct xlat *, int);
456extern struct tcb *alloc_tcb(int, int);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100457extern void droptcb(struct tcb *);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000458
Dmitry V. Levin10de62b2006-12-13 21:45:31 +0000459#define alloctcb(pid) alloc_tcb((pid), 1)
460
Dmitry V. Levin30145dd2010-09-06 22:08:24 +0000461extern void set_sortby(const char *);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100462extern void set_overhead(int);
Dmitry V. Levin30145dd2010-09-06 22:08:24 +0000463extern void qualify(const char *);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100464extern int ptrace_restart(int request, struct tcb *tcp, int sig);
465extern int trace_syscall(struct tcb *);
Denys Vlasenkoc95a88f2011-08-21 17:47:40 +0200466extern void count_syscall(struct tcb *, struct timeval *);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100467extern void printxval(const struct xlat *, int, const char *);
468extern int printargs(struct tcb *);
Denys Vlasenko72879c62012-02-27 14:18:02 +0100469extern int printargs_lu(struct tcb *);
470extern int printargs_ld(struct tcb *);
Denys Vlasenko4924dbd2011-08-19 18:06:46 +0200471extern void addflags(const struct xlat *, int);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100472extern int printflags(const struct xlat *, int, const char *);
473extern const char *sprintflags(const char *, const struct xlat *, int);
474extern int umoven(struct tcb *, long, int, char *);
475extern int umovestr(struct tcb *, long, int, char *);
476extern int upeek(struct tcb *, long, long *);
477extern void dumpiov(struct tcb *, int, long);
478extern void dumpstr(struct tcb *, long, int);
479extern void printstr(struct tcb *, long, int);
Dmitry V. Levin30145dd2010-09-06 22:08:24 +0000480extern void printnum(struct tcb *, long, const char *);
481extern void printnum_int(struct tcb *, long, const char *);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100482extern void printpath(struct tcb *, long);
483extern void printpathn(struct tcb *, long, int);
Denys Vlasenkoa1d541e2012-01-20 11:04:04 +0100484#define TIMESPEC_TEXT_BUFSIZE (sizeof(long)*3 * 2 + sizeof("{%u, %u}"))
485#define TIMEVAL_TEXT_BUFSIZE TIMESPEC_TEXT_BUFSIZE
Andreas Schwabe5355de2009-10-27 16:56:43 +0100486extern void printtv_bitness(struct tcb *, long, enum bitness_t, int);
Denys Vlasenkoa1d541e2012-01-20 11:04:04 +0100487extern char *sprinttv(char *, struct tcb *, long, enum bitness_t, int special);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100488extern void print_timespec(struct tcb *, long);
489extern void sprint_timespec(char *, struct tcb *, long);
John Hughes58265892001-10-18 15:13:53 +0000490#ifdef HAVE_SIGINFO_T
Andreas Schwabe5355de2009-10-27 16:56:43 +0100491extern void printsiginfo(siginfo_t *, int);
John Hughes58265892001-10-18 15:13:53 +0000492#endif
Grant Edwards8a082772011-04-07 20:25:40 +0000493extern const char *getfdpath(struct tcb *, int);
Dmitry V. Levin31382132011-03-04 05:08:02 +0300494extern void printfd(struct tcb *, int);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100495extern void printsock(struct tcb *, long, int);
496extern void print_sock_optmgmt(struct tcb *, long, int);
497extern void printrusage(struct tcb *, long);
Sergei Trofimovich02a08fb2011-08-11 18:04:53 +0300498#ifdef ALPHA
499extern void printrusage32(struct tcb *, long);
500#endif
Andreas Schwabe5355de2009-10-27 16:56:43 +0100501extern void printuid(const char *, unsigned long);
502extern int clearbpt(struct tcb *);
Denys Vlasenko91ecfac2011-06-23 22:05:50 +0200503/*
504 * On Linux, "setbpt" is a misnomer: we don't set a breakpoint
505 * (IOW: no poking in user's text segment),
506 * instead we change fork/vfork/clone into clone(CLONE_PTRACE).
507 * On newer kernels, we use PTRACE_O_TRACECLONE/TRACE[V]FORK instead.
508 */
Andreas Schwabe5355de2009-10-27 16:56:43 +0100509extern int setbpt(struct tcb *);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100510extern void printcall(struct tcb *);
511extern const char *signame(int);
512extern void print_sigset(struct tcb *, long, int);
513extern void printsignal(int);
Denys Vlasenko7de265d2012-03-13 11:44:31 +0100514
515
Andreas Schwabe5355de2009-10-27 16:56:43 +0100516extern void call_summary(FILE *);
Dmitry V. Levin88849682011-06-13 22:58:44 +0000517extern void tprint_iov(struct tcb *, unsigned long, unsigned long, int decode_iov);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100518extern void tprint_open_modes(mode_t);
519extern const char *sprint_open_modes(mode_t);
520extern int is_restart_error(struct tcb *);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000521
Grant Edwards8a082772011-04-07 20:25:40 +0000522extern int pathtrace_select(const char *);
523extern int pathtrace_match(struct tcb *);
524
Andreas Schwabe5355de2009-10-27 16:56:43 +0100525extern int change_syscall(struct tcb *, int);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100526extern int internal_fork(struct tcb *);
527extern int internal_exec(struct tcb *);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000528
Andreas Schwabe5355de2009-10-27 16:56:43 +0100529extern const struct ioctlent *ioctl_lookup(long);
530extern const struct ioctlent *ioctl_next_match(const struct ioctlent *);
531extern int ioctl_decode(struct tcb *, long, long);
532extern int term_ioctl(struct tcb *, long, long);
533extern int sock_ioctl(struct tcb *, long, long);
534extern int proc_ioctl(struct tcb *, int, int);
Andreas Schwabe5355de2009-10-27 16:56:43 +0100535extern int rtc_ioctl(struct tcb *, long, long);
536extern int scsi_ioctl(struct tcb *, long, long);
Dmitry V. Levin4ef6db42011-01-15 20:15:31 +0000537extern int block_ioctl(struct tcb *, long, long);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000538
Andreas Schwabe5355de2009-10-27 16:56:43 +0100539extern int tv_nz(struct timeval *);
540extern int tv_cmp(struct timeval *, struct timeval *);
541extern double tv_float(struct timeval *);
542extern void tv_add(struct timeval *, struct timeval *, struct timeval *);
543extern void tv_sub(struct timeval *, struct timeval *, struct timeval *);
544extern void tv_mul(struct timeval *, struct timeval *, int);
545extern void tv_div(struct timeval *, struct timeval *, int);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000546
Denys Vlasenko0a295bc2011-09-01 16:31:48 +0200547#if !defined HAVE_STPCPY
Denys Vlasenko52845572011-08-31 12:07:38 +0200548/* Some libc have stpcpy, some don't. Sigh...
549 * Roll our private implementation...
550 */
551#undef stpcpy
552#define stpcpy strace_stpcpy
553extern char *stpcpy(char *dst, const char *src);
Denys Vlasenko0a295bc2011-09-01 16:31:48 +0200554#endif
Denys Vlasenko52845572011-08-31 12:07:38 +0200555
Denys Vlasenko84703742012-02-25 02:38:52 +0100556#if defined(SPARC) || defined(SPARC64) || defined(IA64) || defined(SH)
Andreas Schwabe5355de2009-10-27 16:56:43 +0100557extern long getrval2(struct tcb *);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000558#endif
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000559
Denys Vlasenko7de265d2012-03-13 11:44:31 +0100560/* Strace log generation machinery.
561 *
562 * printing_tcp: tcb which has incomplete line being printed right now.
563 * NULL if last line has been completed ('\n'-terminated).
564 * printleader(tcp) examines it, finishes incomplete line if needed,
565 * the sets it to tcp.
566 * line_ended() clears printing_tcp and resets ->curcol = 0.
567 * tcp->curcol == 0 check is also used to detect completeness
568 * of last line, since in -ff mode just checking printing_tcp for NULL
569 * is not enough.
570 *
571 * If you change this code, test log generation in both -f and -ff modes
572 * using:
573 * strace -oLOG -f[f] test/threaded_execve
574 * strace -oLOG -f[f] test/sigkill_rain
575 * strace -oLOG -f[f] -p "`pidof web_browser`"
576 */
577extern struct tcb *printing_tcp;
578extern void printleader(struct tcb *);
579extern void line_ended(void);
580extern void tabto(void);
581extern void tprintf(const char *fmt, ...) __attribute__ ((format (printf, 1, 2)));
582extern void tprints(const char *str);
583
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000584#define umove(pid, addr, objp) \
585 umoven((pid), (addr), sizeof *(objp), (char *) (objp))
586
Dmitry V. Levina7945a32006-12-13 17:10:11 +0000587#define printtv(tcp, addr) \
Roland McGrath6afc5652007-07-24 01:57:11 +0000588 printtv_bitness((tcp), (addr), BITNESS_CURRENT, 0)
589#define printtv_special(tcp, addr) \
590 printtv_bitness((tcp), (addr), BITNESS_CURRENT, 1)
Dmitry V. Levina7945a32006-12-13 17:10:11 +0000591
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000592#ifndef HAVE_STRERROR
Andreas Schwabe5355de2009-10-27 16:56:43 +0100593const char *strerror(int);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000594#endif
595#ifndef HAVE_STRSIGNAL
Andreas Schwabe5355de2009-10-27 16:56:43 +0100596const char *strsignal(int);
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000597#endif
598
599extern int current_personality;
Dmitry V. Levin4ebb4e32006-12-13 17:08:08 +0000600extern const int personality_wordsize[];
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000601
602struct sysent {
Denys Vlasenkoac1ce772011-08-23 13:24:17 +0200603 unsigned nargs;
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000604 int sys_flags;
605 int (*sys_func)();
Roland McGrathee36ce12004-09-04 03:53:10 +0000606 const char *sys_name;
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000607};
608
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000609struct ioctlent {
Roland McGrathee36ce12004-09-04 03:53:10 +0000610 const char *doth;
611 const char *symbol;
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000612 unsigned long code;
613};
614
Denys Vlasenko39fca622011-08-20 02:12:33 +0200615extern const struct sysent *sysent;
Denys Vlasenkoafc64032011-08-23 13:29:01 +0200616extern unsigned nsyscalls;
Denys Vlasenko39fca622011-08-20 02:12:33 +0200617extern const char *const *errnoent;
Denys Vlasenkoafc64032011-08-23 13:29:01 +0200618extern unsigned nerrnos;
Roland McGrathee36ce12004-09-04 03:53:10 +0000619extern const struct ioctlent *ioctlent;
Denys Vlasenkoafc64032011-08-23 13:29:01 +0200620extern unsigned nioctlents;
Roland McGrathee36ce12004-09-04 03:53:10 +0000621extern const char *const *signalent;
Denys Vlasenkoafc64032011-08-23 13:29:01 +0200622extern unsigned nsignals;
Wichert Akkerman76baf7c1999-02-19 00:21:36 +0000623
H.J. Lue752bed2012-02-03 10:19:55 -0800624#define SCNO_IN_RANGE(scno) \
625 ((unsigned long)(scno) < nsyscalls && sysent[scno].sys_func)
Denys Vlasenkocb6f0562011-08-25 01:13:43 +0200626
John Hughes0c79e012001-03-08 14:40:06 +0000627#if HAVE_LONG_LONG
John Hughes5a826b82001-03-07 13:21:24 +0000628
John Hughesbdf48f52001-03-06 15:08:09 +0000629/* _l refers to the lower numbered u_arg,
630 * _h refers to the higher numbered u_arg
631 */
John Hughes5a826b82001-03-07 13:21:24 +0000632
John Hughesb8a85a42001-03-28 08:05:27 +0000633#if HAVE_LITTLE_ENDIAN_LONG_LONG
John Hughes0c79e012001-03-08 14:40:06 +0000634#define LONG_LONG(_l,_h) \
Wichert Akkerman7ab47b62002-03-31 19:00:02 +0000635 ((long long)((unsigned long long)(unsigned)(_l) | ((unsigned long long)(_h)<<32)))
John Hughesbdf48f52001-03-06 15:08:09 +0000636#else
John Hughes0c79e012001-03-08 14:40:06 +0000637#define LONG_LONG(_l,_h) \
Wichert Akkerman7ab47b62002-03-31 19:00:02 +0000638 ((long long)((unsigned long long)(unsigned)(_h) | ((unsigned long long)(_l)<<32)))
John Hughesbdf48f52001-03-06 15:08:09 +0000639#endif
Andreas Schwabb5600fc2009-11-04 17:08:34 +0100640
641extern int printllval(struct tcb *, const char *, int);
John Hughesbdf48f52001-03-06 15:08:09 +0000642#endif
Wichert Akkerman7b3346b2001-10-09 23:47:38 +0000643
644#ifdef IA64
645extern long ia32;
646#endif
Michal Ludvig17f8fb32002-11-06 13:17:21 +0000647
648extern int not_failing_only;
Grant Edwards8a082772011-04-07 20:25:40 +0000649extern int show_fd_path;
650extern int tracing_paths;