xref: /freebsd/usr.bin/truss/truss.h (revision 1f4bcc459a76b7aa664f3fd557684cd0ba6da352)
1 /*
2  * Copyright 2001 Jamey Wood
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23  * SUCH DAMAGE.
24  *
25  * $FreeBSD$
26  */
27 
28 #include <sys/linker_set.h>
29 #include <sys/queue.h>
30 
31 #define	FOLLOWFORKS		0x00000001
32 #define	RELATIVETIMESTAMPS	0x00000002
33 #define	ABSOLUTETIMESTAMPS	0x00000004
34 #define	NOSIGS			0x00000008
35 #define	EXECVEARGS		0x00000010
36 #define	EXECVEENVS		0x00000020
37 #define	COUNTONLY		0x00000040
38 
39 struct procinfo;
40 struct trussinfo;
41 
42 struct procabi {
43 	const char *type;
44 	enum sysdecode_abi abi;
45 	int (*fetch_args)(struct trussinfo *, u_int);
46 	int (*fetch_retval)(struct trussinfo *, long *, int *);
47 };
48 
49 #define	PROCABI(abi)	DATA_SET(procabi, abi)
50 
51 /*
52  * This is confusingly named.  It holds per-thread state about the
53  * currently executing system call.  syscall.h defines a struct
54  * syscall that holds metadata used to format system call arguments.
55  *
56  * NB: args[] stores the raw argument values (e.g. from registers)
57  * passed to the system call.  s_args[] stores a string representation
58  * of a system call's arguments.  These do not necessarily map one to
59  * one.  A system call description may omit individual arguments
60  * (padding) or combine adjacent arguments (e.g. when passing an off_t
61  * argument on a 32-bit system).  The nargs member contains the count
62  * of valid pointers in s_args[], not args[].
63  */
64 struct current_syscall {
65 	struct syscall *sc;
66 	const char *name;
67 	int number;
68 	unsigned long args[10];
69 	unsigned int nargs;
70 	char *s_args[10];	/* the printable arguments */
71 };
72 
73 struct threadinfo
74 {
75 	SLIST_ENTRY(threadinfo) entries;
76 	struct procinfo *proc;
77 	lwpid_t tid;
78 	int in_syscall;
79 	struct current_syscall cs;
80 	struct timespec before;
81 	struct timespec after;
82 };
83 
84 struct procinfo {
85 	LIST_ENTRY(procinfo) entries;
86 	pid_t pid;
87 	struct procabi *abi;
88 
89 	SLIST_HEAD(, threadinfo) threadlist;
90 };
91 
92 struct trussinfo
93 {
94 	int flags;
95 	int strsize;
96 	FILE *outfile;
97 
98 	struct timespec start_time;
99 
100 	struct threadinfo *curthread;
101 
102 	LIST_HEAD(, procinfo) proclist;
103 };
104 
105 #define	timespecsubt(tvp, uvp, vvp)					\
106 	do {								\
107 		(vvp)->tv_sec = (tvp)->tv_sec - (uvp)->tv_sec;		\
108 		(vvp)->tv_nsec = (tvp)->tv_nsec - (uvp)->tv_nsec;	\
109 		if ((vvp)->tv_nsec < 0) {				\
110 			(vvp)->tv_sec--;				\
111 			(vvp)->tv_nsec += 1000000000;			\
112 		}							\
113 	} while (0)
114 
115 #define	timespecadd(tvp, uvp, vvp)					\
116 	do {								\
117 		(vvp)->tv_sec = (tvp)->tv_sec + (uvp)->tv_sec;		\
118 		(vvp)->tv_nsec = (tvp)->tv_nsec + (uvp)->tv_nsec;	\
119 		if ((vvp)->tv_nsec > 1000000000) {				\
120 			(vvp)->tv_sec++;				\
121 			(vvp)->tv_nsec -= 1000000000;			\
122 		}							\
123 	} while (0)
124