defs.h revision afc64037e22cc7cafadba766286e32550d9e8feb
1/*
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
32#ifdef HAVE_CONFIG_H
33#include "config.h"
34#endif
35
36#ifdef MIPS
37#include <sgidefs.h>
38#endif
39
40#ifdef linux
41#include <features.h>
42#endif
43
44#ifdef _LARGEFILE64_SOURCE
45/* This is the macro everything checks before using foo64 names.  */
46# ifndef _LFS64_LARGEFILE
47#  define _LFS64_LARGEFILE 1
48# endif
49#endif
50
51/* Configuration section */
52#ifndef MAX_QUALS
53#if defined(LINUX) && defined(MIPS)
54#define MAX_QUALS	7000	/* maximum number of syscalls, signals, etc. */
55#else
56#define MAX_QUALS	2048	/* maximum number of syscalls, signals, etc. */
57#endif
58#endif
59#ifndef DEFAULT_STRLEN
60/* default maximum # of bytes printed in `printstr', change with -s switch */
61#define DEFAULT_STRLEN	32
62#endif
63#ifndef DEFAULT_ACOLUMN
64#define DEFAULT_ACOLUMN	40	/* default alignment column for results */
65#endif
66
67/* Maximum number of args to a syscall.
68 *
69 * Make sure that all entries in all syscallent.h files
70 * have nargs <= MAX_ARGS!
71 * linux/<ARCH>/syscallent.h: ia64 has many syscalls with
72 * nargs = 8, mips has two with nargs = 7 (both are printargs),
73 * all others are <= 6.
74 * freebsd/i386/syscallent.h: one syscall with nargs = 8
75 * (sys_sendfile, looks legitimate)
76 * and one with nargs = 7 (sys_mmap, maybe it should have 6?).
77 * sunos4/syscallent.h: all are <= 6.
78 * svr4/syscallent.h: all are -1.
79 */
80#ifndef MAX_ARGS
81# ifdef HPPA
82#  define MAX_ARGS	6
83# elif defined X86_64 || defined I386
84#  ifdef FREEBSD
85#   define MAX_ARGS	8
86#  else
87#   define MAX_ARGS	6
88#  endif
89# else
90/* Way too big. Switch your arch to saner size after you tested that it works */
91#  define MAX_ARGS	32
92# endif
93#endif
94
95#ifndef DEFAULT_SORTBY
96#define DEFAULT_SORTBY "time"	/* default sorting method for call profiling */
97#endif
98
99#include <sys/types.h>
100#include <unistd.h>
101#include <stdlib.h>
102#include <stdio.h>
103#include <ctype.h>
104#include <string.h>
105#include <time.h>
106#include <sys/time.h>
107#include <errno.h>
108
109#ifdef HAVE_STDBOOL_H
110#include <stdbool.h>
111#endif
112
113#ifdef STDC_HEADERS
114#include <stddef.h>
115#endif /* STDC_HEADERS */
116
117#ifdef HAVE_SIGINFO_T
118#include <signal.h>
119#endif
120
121#if defined(LINUX)
122#  if defined(SPARC) || defined(SPARC64)
123#     define LINUXSPARC
124#  endif
125#  if defined(X86_64)
126#     define LINUX_X86_64
127#  endif
128#  if defined(MIPS) && _MIPS_SIM == _MIPS_SIM_ABI32
129#     define LINUX_MIPSO32
130#  endif
131#  if defined(MIPS) && _MIPS_SIM == _MIPS_SIM_NABI32
132#     define LINUX_MIPSN32
133#     define LINUX_MIPS64
134#  endif
135#  if defined(MIPS) && _MIPS_SIM == _MIPS_SIM_ABI64
136#     define LINUX_MIPSN64
137#     define LINUX_MIPS64
138#  endif
139#  if defined(ARM)
140#     define LINUX_ARM
141#  endif
142#  if defined(AVR32)
143#     define LINUX_AVR32
144#  endif
145#endif
146
147#if defined(SVR4) || defined(FREEBSD)
148#define USE_PROCFS
149#else
150#undef USE_PROCFS
151#endif
152
153#ifdef FREEBSD
154#ifndef I386
155#error "FreeBSD support is only for i386 arch right now."
156#endif
157#include <machine/psl.h>
158#include <machine/reg.h>
159#include <sys/syscall.h>
160#endif
161
162#ifdef USE_PROCFS
163#include <sys/procfs.h>
164#ifdef HAVE_MP_PROCFS
165#include <sys/uio.h>
166#endif
167#ifdef FREEBSD
168#include <sys/pioctl.h>
169#endif /* FREEBSD */
170#else /* !USE_PROCFS */
171#if (defined(LINUXSPARC) || defined(LINUX_X86_64) || defined(LINUX_ARM) || defined(LINUX_AVR32)) && defined(__GLIBC__)
172#include <sys/ptrace.h>
173#else
174/* Work around awkward prototype in ptrace.h. */
175#define ptrace xptrace
176#include <sys/ptrace.h>
177#undef ptrace
178#ifdef POWERPC
179#define __KERNEL__
180#include <asm/ptrace.h>
181#undef __KERNEL__
182#endif
183#ifdef LINUX
184extern long ptrace(int, int, char *, long);
185#else /* !LINUX */
186extern int ptrace(int, int, char *, int, ...);
187#endif /* !LINUX */
188#endif /* !LINUXSPARC */
189#endif /* !SVR4 */
190
191#ifdef LINUX
192#if !defined(__GLIBC__)
193#define	PTRACE_PEEKUSER	PTRACE_PEEKUSR
194#define	PTRACE_POKEUSER	PTRACE_POKEUSR
195#endif
196#ifdef ALPHA
197#  define REG_R0 0
198#  define REG_A0 16
199#  define REG_A3 19
200#  define REG_FP 30
201#  define REG_PC 64
202#endif /* ALPHA */
203#ifdef MIPS
204#  define REG_V0 2
205#  define REG_A0 4
206#  define REG_A3 7
207#  define REG_SP 29
208#  define REG_EPC 64
209#endif /* MIPS */
210#ifdef HPPA
211#  define PT_GR20 (20*4)
212#  define PT_GR26 (26*4)
213#  define PT_GR28 (28*4)
214#  define PT_IAOQ0 (106*4)
215#  define PT_IAOQ1 (107*4)
216#endif /* HPPA */
217#ifdef SH64
218   /* SH64 Linux - this code assumes the following kernel API for system calls:
219          PC           Offset 0
220          System Call  Offset 16 (actually, (syscall no.) | (0x1n << 16),
221                       where n = no. of parameters.
222          Other regs   Offset 24+
223
224          On entry:    R2-7 = parameters 1-6 (as many as necessary)
225          On return:   R9   = result. */
226
227   /* Offset for peeks of registers */
228#  define REG_OFFSET         (24)
229#  define REG_GENERAL(x)     (8*(x)+REG_OFFSET)
230#  define REG_PC             (0*8)
231#  define REG_SYSCALL        (2*8)
232#endif /* SH64 */
233#endif /* LINUX */
234
235#define SUPPORTED_PERSONALITIES 1
236#define DEFAULT_PERSONALITY 0
237
238#ifdef LINUXSPARC
239/* Indexes into the pt_regs.u_reg[] array -- UREG_XX from kernel are all off
240 * by 1 and use Ix instead of Ox.  These work for both 32 and 64 bit Linux. */
241#define U_REG_G1 0
242#define U_REG_O0 7
243#define U_REG_O1 8
244#define PERSONALITY0_WORDSIZE 4
245#define PERSONALITY1_WORDSIZE 4
246#undef  SUPPORTED_PERSONALITIES
247#if defined(SPARC64)
248#include <asm/psrcompat.h>
249#define SUPPORTED_PERSONALITIES 3
250#define PERSONALITY2_WORDSIZE 8
251#else
252#include <asm/psr.h>
253#define SUPPORTED_PERSONALITIES 2
254#endif /* SPARC64 */
255#endif /* LINUXSPARC */
256
257#ifdef X86_64
258#undef SUPPORTED_PERSONALITIES
259#define SUPPORTED_PERSONALITIES 2
260#define PERSONALITY0_WORDSIZE 8
261#define PERSONALITY1_WORDSIZE 4
262#endif
263
264#ifdef ARM
265#undef SUPPORTED_PERSONALITIES
266#define SUPPORTED_PERSONALITIES 2
267#define PERSONALITY0_WORDSIZE 4
268#define PERSONALITY1_WORDSIZE 4
269#endif
270
271#ifdef POWERPC64
272#undef SUPPORTED_PERSONALITIES
273#define SUPPORTED_PERSONALITIES 2
274#define PERSONALITY0_WORDSIZE 8
275#define PERSONALITY1_WORDSIZE 4
276#endif
277
278#ifdef SVR4
279#ifdef HAVE_MP_PROCFS
280extern int mp_ioctl(int f, int c, void *a, int s);
281#define IOCTL(f,c,a)	mp_ioctl(f, c, a, sizeof *a)
282#define IOCTL_STATUS(t) \
283	 pread(t->pfd_stat, &t->status, sizeof t->status, 0)
284#define IOCTL_WSTOP(t) \
285	(IOCTL(t->pfd, PCWSTOP, (char *)NULL) < 0 ? -1 : IOCTL_STATUS(t))
286#define PR_WHY		pr_lwp.pr_why
287#define PR_WHAT		pr_lwp.pr_what
288#define PR_REG		pr_lwp.pr_context.uc_mcontext.gregs
289#define PR_FLAGS	pr_lwp.pr_flags
290#define PR_SYSCALL	pr_lwp.pr_syscall
291#define PR_INFO		pr_lwp.pr_info
292#define PIOCSTIP	PCSTOP
293#define PIOCSET		PCSET
294#define PIOCRESET	PCRESET
295#define PIOCSTRACE	PCSTRACE
296#define PIOCSFAULT	PCSFAULT
297#define PIOCWSTOP	PCWSTOP
298#define PIOCSTOP	PCSTOP
299#define PIOCSENTRY	PCSENTRY
300#define PIOCSEXIT	PCSEXIT
301#define PIOCRUN		PCRUN
302#else
303#define IOCTL		ioctl
304#define IOCTL_STATUS(t)	ioctl(t->pfd, PIOCSTATUS, &t->status)
305#define IOCTL_WSTOP(t)	ioctl(t->pfd, PIOCWSTOP, &t->status)
306#define PR_WHY		pr_why
307#define PR_WHAT		pr_what
308#define PR_REG		pr_reg
309#define PR_FLAGS	pr_flags
310#define PR_SYSCALL	pr_syscall
311#define PR_INFO		pr_info
312#endif
313#endif
314#ifdef FREEBSD
315#define IOCTL		ioctl
316#define IOCTL_STATUS(t)	ioctl(t->pfd, PIOCSTATUS, &t->status)
317#define IOCTL_WSTOP(t)	ioctl(t->pfd, PIOCWAIT, &t->status)
318#define PIOCRUN         PIOCCONT
319#define PIOCWSTOP       PIOCWAIT
320#define PR_WHY		why
321#define PR_WHAT		val
322#define PR_FLAGS	state
323/* from /usr/src/sys/miscfs/procfs/procfs_vnops.c,
324   status.state = 0 for running, 1 for stopped */
325#define PR_ASLEEP	1
326#define PR_SYSENTRY     S_SCE
327#define PR_SYSEXIT      S_SCX
328#define PR_SIGNALLED    S_SIG
329#define PR_FAULTED      S_CORE
330#endif
331
332#ifdef LINUX
333# if !HAVE_DECL_PTRACE_SETOPTIONS
334#  define PTRACE_SETOPTIONS	0x4200
335# endif
336# if !HAVE_DECL_PTRACE_GETEVENTMSG
337#  define PTRACE_GETEVENTMSG	0x4201
338# endif
339# if !HAVE_DECL_PTRACE_GETSIGINFO
340#  define PTRACE_GETSIGINFO	0x4202
341# endif
342
343# if !HAVE_DECL_PTRACE_O_TRACESYSGOOD
344#  define PTRACE_O_TRACESYSGOOD	0x00000001
345# endif
346# if !HAVE_DECL_PTRACE_O_TRACEFORK
347#  define PTRACE_O_TRACEFORK	0x00000002
348# endif
349# if !HAVE_DECL_PTRACE_O_TRACEVFORK
350#  define PTRACE_O_TRACEVFORK	0x00000004
351# endif
352# if !HAVE_DECL_PTRACE_O_TRACECLONE
353#  define PTRACE_O_TRACECLONE	0x00000008
354# endif
355# if !HAVE_DECL_PTRACE_O_TRACEEXEC
356#  define PTRACE_O_TRACEEXEC	0x00000010
357# endif
358# if !HAVE_DECL_PTRACE_O_TRACEEXIT
359#  define PTRACE_O_TRACEEXIT	0x00000040
360# endif
361
362# if !HAVE_DECL_PTRACE_EVENT_FORK
363#  define PTRACE_EVENT_FORK	1
364# endif
365# if !HAVE_DECL_PTRACE_EVENT_VFORK
366#  define PTRACE_EVENT_VFORK	2
367# endif
368# if !HAVE_DECL_PTRACE_EVENT_CLONE
369#  define PTRACE_EVENT_CLONE	3
370# endif
371# if !HAVE_DECL_PTRACE_EVENT_EXEC
372#  define PTRACE_EVENT_EXEC	4
373# endif
374# if !HAVE_DECL_PTRACE_EVENT_VFORK_DONE
375#  define PTRACE_EVENT_VFORK_DONE	5
376# endif
377# if !HAVE_DECL_PTRACE_EVENT_EXIT
378#  define PTRACE_EVENT_EXIT	6
379# endif
380#endif /* LINUX */
381
382#if !defined __GNUC__
383# define __attribute__(x) /*nothing*/
384#endif
385
386#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
387
388/* Trace Control Block */
389struct tcb {
390	int flags;		/* See below for TCB_ values */
391	int pid;		/* Process Id of this entry */
392	long scno;		/* System call number */
393	int u_nargs;		/* System call argument count */
394	long u_arg[MAX_ARGS];	/* System call arguments */
395#if defined (LINUX_MIPSN32)
396	long long ext_arg[MAX_ARGS];	/* System call arguments */
397#endif
398	int u_error;		/* Error code */
399	long u_rval;		/* (first) return value */
400#ifdef HAVE_LONG_LONG
401	long long u_lrval;	/* long long return value */
402#endif
403	FILE *outf;		/* Output file for this process */
404	int curcol;		/* Output column for this process */
405	const char *auxstr;	/* Auxiliary info from syscall (see RVAL_STR) */
406	struct timeval stime;	/* System time usage as of last process wait */
407	struct timeval dtime;	/* Delta for system time usage */
408	struct timeval etime;	/* Syscall entry time */
409				/* Support for tracing forked processes */
410	long baddr;		/* `Breakpoint' address */
411	long inst[2];		/* Instructions on above */
412	int ptrace_errno;
413#ifdef USE_PROCFS
414	int pfd;		/* proc file descriptor */
415#endif
416#ifdef SVR4
417# ifdef HAVE_MP_PROCFS
418	int pfd_stat;
419	int pfd_as;
420	pstatus_t status;
421# else
422	prstatus_t status;	/* procfs status structure */
423# endif
424#endif
425#ifdef FREEBSD
426	struct procfs_status status;
427	int pfd_reg;
428	int pfd_status;
429#endif
430};
431
432/* TCB flags */
433#define TCB_STARTUP	00001	/* We have just begun ptracing this process */
434#define TCB_INUSE	00002	/* This table entry is in use */
435/*
436 * Are we in system call entry or in syscall exit?
437 *
438 * This bit is set after all syscall entry processing is done.
439 * Therefore, this bit will be set when next ptrace stop occurs,
440 * which should be syscall exit stop. Other stops which are possible
441 * directly after syscall entry (death, ptrace event stop)
442 * are simpler and handled without calling trace_syscall(), therefore
443 * the places where TCB_INSYSCALL can be set but we aren't in syscall stop
444 * are limited to trace(), this condition is never observed in trace_syscall()
445 * and below.
446 * The bit is cleared after all syscall exit processing is done.
447 * User-generated SIGTRAPs and post-execve SIGTRAP make it necessary
448 * to be very careful and NOT set TCB_INSYSCALL bit when they are encountered.
449 * TCB_WAITEXECVE bit is used for this purpose (see below).
450 *
451 * Use entering(tcp) / exiting(tcp) to check this bit to make code more readable.
452 */
453#define TCB_INSYSCALL	00004
454#define TCB_ATTACHED	00010	/* Process is not our own child */
455#ifdef LINUX
456#define TCB_ATTACH_DONE	00020	/* PTRACE_ATTACH was done on this tcb->pid */
457#endif
458#define TCB_BPTSET	00100	/* "Breakpoint" set after fork(2) */
459#define TCB_SIGTRAPPED	00200	/* Process wanted to block SIGTRAP */
460#define TCB_REPRINT	01000	/* We should reprint this syscall on exit */
461#define TCB_FILTERED	02000	/* This system call has been filtered out */
462#ifdef LINUX
463/* x86 does not need TCB_WAITEXECVE.
464 * It can detect SIGTRAP by looking at eax/rax.
465 * See "not a syscall entry (eax = %ld)\n" message in syscall_fixup().
466 */
467# if defined(ALPHA) || defined(AVR32) || defined(SPARC) || defined(SPARC64) \
468  || defined(POWERPC) || defined(IA64) || defined(HPPA) \
469  || defined(SH) || defined(SH64) || defined(S390) || defined(S390X) \
470  || defined(ARM) || defined(MIPS) || defined(BFIN) || defined(TILE)
471/* This tracee has entered into execve syscall. Expect post-execve SIGTRAP
472 * to happen. (When it is detected, tracee is continued and this bit is cleared.)
473 */
474#  define TCB_WAITEXECVE 04000
475# endif
476# include <sys/syscall.h>
477# ifndef __NR_exit_group
478# /* Hack: Most headers around are too old to have __NR_exit_group.  */
479#  ifdef ALPHA
480#   define __NR_exit_group 405
481#  elif defined I386
482#   define __NR_exit_group 252
483#  elif defined X86_64
484#   define __NR_exit_group 231
485#  elif defined IA64
486#   define __NR_exit_group 1236
487#  elif defined POWERPC
488#   define __NR_exit_group 234
489#  elif defined S390 || defined S390X
490#   define __NR_exit_group 248
491#  elif defined SPARC || defined SPARC64
492#   define __NR_exit_group 188
493#  elif defined M68K
494#   define __NR_exit_group 247
495#  endif /* ALPHA et al */
496# endif	/* !__NR_exit_group */
497#endif /* LINUX */
498
499/* qualifier flags */
500#define QUAL_TRACE	0001	/* this system call should be traced */
501#define QUAL_ABBREV	0002	/* abbreviate the structures of this syscall */
502#define QUAL_VERBOSE	0004	/* decode the structures of this syscall */
503#define QUAL_RAW	0010	/* print all args in hex for this syscall */
504#define QUAL_SIGNAL	0020	/* report events with this signal */
505#define QUAL_FAULT	0040	/* report events with this fault */
506#define QUAL_READ	0100	/* dump data read on this file descriptor */
507#define QUAL_WRITE	0200	/* dump data written to this file descriptor */
508
509#define entering(tcp)	(!((tcp)->flags & TCB_INSYSCALL))
510#define exiting(tcp)	((tcp)->flags & TCB_INSYSCALL)
511#define syserror(tcp)	((tcp)->u_error != 0)
512#define verbose(tcp)	(qual_flags[(tcp)->scno] & QUAL_VERBOSE)
513#define abbrev(tcp)	(qual_flags[(tcp)->scno] & QUAL_ABBREV)
514#define filtered(tcp)	((tcp)->flags & TCB_FILTERED)
515
516struct xlat {
517	int val;
518	const char *str;
519};
520
521extern const struct xlat open_mode_flags[];
522extern const struct xlat addrfams[];
523extern const struct xlat struct_user_offsets[];
524extern const struct xlat open_access_modes[];
525
526/* Format of syscall return values */
527#define RVAL_DECIMAL	000	/* decimal format */
528#define RVAL_HEX	001	/* hex format */
529#define RVAL_OCTAL	002	/* octal format */
530#define RVAL_UDECIMAL	003	/* unsigned decimal format */
531#define RVAL_LDECIMAL	004	/* long decimal format */
532#define RVAL_LHEX	005	/* long hex format */
533#define RVAL_LOCTAL	006	/* long octal format */
534#define RVAL_LUDECIMAL	007	/* long unsigned decimal format */
535#define RVAL_MASK	007	/* mask for these values */
536
537#define RVAL_STR	010	/* Print `auxstr' field after return val */
538#define RVAL_NONE	020	/* Print nothing */
539
540#ifndef offsetof
541#define offsetof(type, member)	(((char *) &(((type *) NULL)->member)) - \
542				 ((char *) (type *) NULL))
543#endif /* !offsetof */
544
545/* get offset of member within a user struct */
546#define uoff(member)	offsetof(struct user, member)
547
548#define TRACE_FILE	001	/* Trace file-related syscalls. */
549#define TRACE_IPC	002	/* Trace IPC-related syscalls. */
550#define TRACE_NETWORK	004	/* Trace network-related syscalls. */
551#define TRACE_PROCESS	010	/* Trace process-related syscalls. */
552#define TRACE_SIGNAL	020	/* Trace signal-related syscalls. */
553#define TRACE_DESC	040	/* Trace file descriptor-related syscalls. */
554#define SYSCALL_NEVER_FAILS	0100	/* Syscall is always successful. */
555
556typedef enum {
557	CFLAG_NONE = 0,
558	CFLAG_ONLY_STATS,
559	CFLAG_BOTH
560} cflag_t;
561
562extern int *qual_flags;
563extern int debug, followfork;
564extern unsigned int ptrace_setoptions;
565extern int dtime, xflag, qflag;
566extern cflag_t cflag;
567extern int acolumn;
568extern int max_strlen;
569extern struct tcb *tcp_last;
570
571enum bitness_t { BITNESS_CURRENT = 0, BITNESS_32 };
572
573void error_msg(const char *fmt, ...) __attribute__ ((format(printf, 1, 2)));
574void perror_msg(const char *fmt, ...) __attribute__ ((format(printf, 1, 2)));
575void error_msg_and_die(const char *fmt, ...) __attribute__ ((noreturn, format(printf, 1, 2)));
576void perror_msg_and_die(const char *fmt, ...) __attribute__ ((noreturn, format(printf, 1, 2)));
577
578extern void set_personality(int personality);
579extern const char *xlookup(const struct xlat *, int);
580extern struct tcb *alloc_tcb(int, int);
581extern struct tcb *pid2tcb(int);
582extern void droptcb(struct tcb *);
583
584#define alloctcb(pid)	alloc_tcb((pid), 1)
585
586extern void set_sortby(const char *);
587extern void set_overhead(int);
588extern void qualify(const char *);
589extern int get_scno(struct tcb *);
590extern long known_scno(struct tcb *);
591extern long do_ptrace(int request, struct tcb *tcp, void *addr, void *data);
592extern int ptrace_restart(int request, struct tcb *tcp, int sig);
593extern int force_result(struct tcb *, int, long);
594extern int trace_syscall(struct tcb *);
595extern void count_syscall(struct tcb *, struct timeval *);
596extern void printxval(const struct xlat *, int, const char *);
597extern int printargs(struct tcb *);
598extern void addflags(const struct xlat *, int);
599extern int printflags(const struct xlat *, int, const char *);
600extern const char *sprintflags(const char *, const struct xlat *, int);
601extern int umoven(struct tcb *, long, int, char *);
602extern int umovestr(struct tcb *, long, int, char *);
603extern int upeek(struct tcb *, long, long *);
604extern void dumpiov(struct tcb *, int, long);
605extern void dumpstr(struct tcb *, long, int);
606extern void printstr(struct tcb *, long, int);
607extern void printnum(struct tcb *, long, const char *);
608extern void printnum_int(struct tcb *, long, const char *);
609extern void printpath(struct tcb *, long);
610extern void printpathn(struct tcb *, long, int);
611extern void printtv_bitness(struct tcb *, long, enum bitness_t, int);
612extern void sprinttv(struct tcb *, long, enum bitness_t, char *);
613extern void print_timespec(struct tcb *, long);
614extern void sprint_timespec(char *, struct tcb *, long);
615#ifdef HAVE_SIGINFO_T
616extern void printsiginfo(siginfo_t *, int);
617#endif
618extern const char *getfdpath(struct tcb *, int);
619extern void printfd(struct tcb *, int);
620extern void printsock(struct tcb *, long, int);
621extern void print_sock_optmgmt(struct tcb *, long, int);
622extern void printrusage(struct tcb *, long);
623#ifdef ALPHA
624extern void printrusage32(struct tcb *, long);
625#endif
626extern void printuid(const char *, unsigned long);
627extern int clearbpt(struct tcb *);
628/*
629 * On Linux, "setbpt" is a misnomer: we don't set a breakpoint
630 * (IOW: no poking in user's text segment),
631 * instead we change fork/vfork/clone into clone(CLONE_PTRACE).
632 * On newer kernels, we use PTRACE_O_TRACECLONE/TRACE[V]FORK instead.
633 */
634extern int setbpt(struct tcb *);
635extern void printcall(struct tcb *);
636extern const char *signame(int);
637extern void print_sigset(struct tcb *, long, int);
638extern void printsignal(int);
639extern void printleader(struct tcb *);
640extern void printtrailer(void);
641extern void tabto(int);
642extern void call_summary(FILE *);
643extern void tprint_iov(struct tcb *, unsigned long, unsigned long, int decode_iov);
644extern void tprint_open_modes(mode_t);
645extern const char *sprint_open_modes(mode_t);
646extern int is_restart_error(struct tcb *);
647
648extern int pathtrace_select(const char *);
649extern int pathtrace_match(struct tcb *);
650
651extern int change_syscall(struct tcb *, int);
652extern int internal_fork(struct tcb *);
653extern int internal_exec(struct tcb *);
654
655extern const struct ioctlent *ioctl_lookup(long);
656extern const struct ioctlent *ioctl_next_match(const struct ioctlent *);
657extern int ioctl_decode(struct tcb *, long, long);
658extern int term_ioctl(struct tcb *, long, long);
659extern int sock_ioctl(struct tcb *, long, long);
660extern int proc_ioctl(struct tcb *, int, int);
661extern int stream_ioctl(struct tcb *, int, int);
662#ifdef LINUX
663extern int rtc_ioctl(struct tcb *, long, long);
664extern int scsi_ioctl(struct tcb *, long, long);
665extern int block_ioctl(struct tcb *, long, long);
666#endif
667
668extern int tv_nz(struct timeval *);
669extern int tv_cmp(struct timeval *, struct timeval *);
670extern double tv_float(struct timeval *);
671extern void tv_add(struct timeval *, struct timeval *, struct timeval *);
672extern void tv_sub(struct timeval *, struct timeval *, struct timeval *);
673extern void tv_mul(struct timeval *, struct timeval *, int);
674extern void tv_div(struct timeval *, struct timeval *, int);
675
676#ifdef SUNOS4
677extern int fixvfork(struct tcb *);
678#endif
679#if !(defined(LINUX) && !defined(SPARC) && !defined(SPARC64) && !defined(IA64) \
680	&& !defined(SH))
681extern long getrval2(struct tcb *);
682#endif
683#ifdef USE_PROCFS
684extern int proc_open(struct tcb *tcp, int attaching);
685#endif
686
687#define umove(pid, addr, objp)	\
688	umoven((pid), (addr), sizeof *(objp), (char *) (objp))
689
690#define printtv(tcp, addr)	\
691	printtv_bitness((tcp), (addr), BITNESS_CURRENT, 0)
692#define printtv_special(tcp, addr)	\
693	printtv_bitness((tcp), (addr), BITNESS_CURRENT, 1)
694
695extern void tprintf(const char *fmt, ...) __attribute__ ((format (printf, 1, 2)));
696
697#ifndef HAVE_STRERROR
698const char *strerror(int);
699#endif
700#ifndef HAVE_STRSIGNAL
701const char *strsignal(int);
702#endif
703
704extern int current_personality;
705extern const int personality_wordsize[];
706
707struct sysent {
708	unsigned nargs;
709	int	sys_flags;
710	int	(*sys_func)();
711	const char *sys_name;
712	long	native_scno;	/* Match against SYS_* constants.  */
713};
714
715struct ioctlent {
716	const char *doth;
717	const char *symbol;
718	unsigned long code;
719};
720
721extern const struct sysent *sysent;
722extern unsigned nsyscalls;
723extern const char *const *errnoent;
724extern unsigned nerrnos;
725extern const struct ioctlent *ioctlent;
726extern unsigned nioctlents;
727extern const char *const *signalent;
728extern unsigned nsignals;
729
730#if HAVE_LONG_LONG
731
732/* _l refers to the lower numbered u_arg,
733 * _h refers to the higher numbered u_arg
734 */
735
736#if HAVE_LITTLE_ENDIAN_LONG_LONG
737#define LONG_LONG(_l,_h) \
738    ((long long)((unsigned long long)(unsigned)(_l) | ((unsigned long long)(_h)<<32)))
739#else
740#define LONG_LONG(_l,_h) \
741    ((long long)((unsigned long long)(unsigned)(_h) | ((unsigned long long)(_l)<<32)))
742#endif
743
744extern int printllval(struct tcb *, const char *, int);
745#endif
746
747#ifdef IA64
748extern long ia32;
749#endif
750
751extern int not_failing_only;
752extern int show_fd_path;
753extern int tracing_paths;
754