2 * Copyright 1997 Sean Eric Fagan
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
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 * 3. All advertising materials mentioning features or use of this software
13 * must display the following acknowledgement:
14 * This product includes software developed by Sean Eric Fagan
15 * 4. Neither the name of the author may be used to endorse or promote
16 * products derived from this software without specific prior written
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 static const char rcsid[] =
38 * This file has routines used to print out system calls and their
42 #include <sys/types.h>
44 #include <sys/procctl.h>
45 #include <sys/ptrace.h>
46 #include <sys/socket.h>
50 #include <netinet/in.h>
51 #include <arpa/inet.h>
52 #include <sys/ioccom.h>
53 #include <machine/atomic.h>
56 #include <sys/event.h>
58 #include <sys/resource.h>
77 /* 64-bit alignment on 32-bit platforms. */
84 /* Number of slots needed for a 64-bit argument. */
92 * This should probably be in its own file, sorted alphabetically.
94 static struct syscall syscalls[] = {
95 { .name = "fcntl", .ret_type = 1, .nargs = 3,
96 .args = { { Int, 0 } , { Fcntl, 1 }, { Fcntlflag | OUT, 2 } } },
97 { .name = "fork", .ret_type = 1, .nargs = 0 },
98 { .name = "vfork", .ret_type = 1, .nargs = 0 },
99 { .name = "rfork", .ret_type = 1, .nargs = 1,
100 .args = { { Rforkflags, 0 } } },
101 { .name = "getegid", .ret_type = 1, .nargs = 0 },
102 { .name = "geteuid", .ret_type = 1, .nargs = 0 },
103 { .name = "linux_readlink", .ret_type = 1, .nargs = 3,
104 .args = { { Name, 0 } , { Name | OUT, 1 }, { Int, 2 }}},
105 { .name = "linux_socketcall", .ret_type = 1, .nargs = 2,
106 .args = { { Int, 0 } , { LinuxSockArgs, 1 }}},
107 { .name = "getgid", .ret_type = 1, .nargs = 0 },
108 { .name = "getpid", .ret_type = 1, .nargs = 0 },
109 { .name = "getpgid", .ret_type = 1, .nargs = 1,
110 .args = { { Int, 0 } } },
111 { .name = "getpgrp", .ret_type = 1, .nargs = 0 },
112 { .name = "getppid", .ret_type = 1, .nargs = 0 },
113 { .name = "getsid", .ret_type = 1, .nargs = 1,
114 .args = { { Int, 0 } } },
115 { .name = "getuid", .ret_type = 1, .nargs = 0 },
116 { .name = "readlink", .ret_type = 1, .nargs = 3,
117 .args = { { Name, 0 } , { Readlinkres | OUT, 1 }, { Int, 2 } } },
118 { .name = "lseek", .ret_type = 2, .nargs = 3,
119 .args = { { Int, 0 }, { Quad, 1 + QUAD_ALIGN }, { Whence, 1 + QUAD_SLOTS + QUAD_ALIGN } } },
120 { .name = "linux_lseek", .ret_type = 2, .nargs = 3,
121 .args = { { Int, 0 }, { Int, 1 }, { Whence, 2 } } },
122 { .name = "mmap", .ret_type = 2, .nargs = 6,
123 .args = { { Ptr, 0 }, { Int, 1 }, { Mprot, 2 }, { Mmapflags, 3 }, { Int, 4 }, { Quad, 5 + QUAD_ALIGN } } },
124 { .name = "linux_mkdir", .ret_type = 1, .nargs = 2,
125 .args = { { Name | IN, 0} , {Int, 1}}},
126 { .name = "mprotect", .ret_type = 1, .nargs = 3,
127 .args = { { Ptr, 0 }, { Int, 1 }, { Mprot, 2 } } },
128 { .name = "open", .ret_type = 1, .nargs = 3,
129 .args = { { Name | IN, 0 } , { Open, 1 }, { Octal, 2 } } },
130 { .name = "mkdir", .ret_type = 1, .nargs = 2,
131 .args = { { Name, 0 } , { Octal, 1 } } },
132 { .name = "linux_open", .ret_type = 1, .nargs = 3,
133 .args = { { Name, 0 }, { Hex, 1 }, { Octal, 2 } } },
134 { .name = "close", .ret_type = 1, .nargs = 1,
135 .args = { { Int, 0 } } },
136 { .name = "link", .ret_type = 0, .nargs = 2,
137 .args = { { Name, 0 }, { Name, 1 } } },
138 { .name = "unlink", .ret_type = 0, .nargs = 1,
139 .args = { { Name, 0 } } },
140 { .name = "chdir", .ret_type = 0, .nargs = 1,
141 .args = { { Name, 0 } } },
142 { .name = "chroot", .ret_type = 0, .nargs = 1,
143 .args = { { Name, 0 } } },
144 { .name = "mknod", .ret_type = 0, .nargs = 3,
145 .args = { { Name, 0 }, { Octal, 1 }, { Int, 3 } } },
146 { .name = "chmod", .ret_type = 0, .nargs = 2,
147 .args = { { Name, 0 }, { Octal, 1 } } },
148 { .name = "chown", .ret_type = 0, .nargs = 3,
149 .args = { { Name, 0 }, { Int, 1 }, { Int, 2 } } },
150 { .name = "linux_stat64", .ret_type = 1, .nargs = 3,
151 .args = { { Name | IN, 0 }, { Ptr | OUT, 1 }, { Ptr | IN, 1 }}},
152 { .name = "mount", .ret_type = 0, .nargs = 4,
153 .args = { { Name, 0 }, { Name, 1 }, { Int, 2 }, { Ptr, 3 } } },
154 { .name = "umount", .ret_type = 0, .nargs = 2,
155 .args = { { Name, 0 }, { Int, 2 } } },
156 { .name = "fstat", .ret_type = 1, .nargs = 2,
157 .args = { { Int, 0 }, { Stat | OUT , 1 } } },
158 { .name = "stat", .ret_type = 1, .nargs = 2,
159 .args = { { Name | IN, 0 }, { Stat | OUT, 1 } } },
160 { .name = "lstat", .ret_type = 1, .nargs = 2,
161 .args = { { Name | IN, 0 }, { Stat | OUT, 1 } } },
162 { .name = "linux_newstat", .ret_type = 1, .nargs = 2,
163 .args = { { Name | IN, 0 }, { Ptr | OUT, 1 } } },
164 { .name = "linux_access", .ret_type = 1, .nargs = 2,
165 .args = { { Name, 0 }, { Int, 1 }}},
166 { .name = "linux_newfstat", .ret_type = 1, .nargs = 2,
167 .args = { { Int, 0 }, { Ptr | OUT, 1 } } },
168 { .name = "write", .ret_type = 1, .nargs = 3,
169 .args = { { Int, 0 }, { BinString | IN, 1 }, { Int, 2 } } },
170 { .name = "ioctl", .ret_type = 1, .nargs = 3,
171 .args = { { Int, 0 }, { Ioctl, 1 }, { Hex, 2 } } },
172 { .name = "break", .ret_type = 1, .nargs = 1,
173 .args = { { Ptr, 0 } } },
174 { .name = "exit", .ret_type = 0, .nargs = 1,
175 .args = { { Hex, 0 } } },
176 { .name = "access", .ret_type = 1, .nargs = 2,
177 .args = { { Name | IN, 0 }, { Int, 1 } } },
178 { .name = "sigaction", .ret_type = 1, .nargs = 3,
179 .args = { { Signal, 0 }, { Sigaction | IN, 1 }, { Sigaction | OUT, 2 } } },
180 { .name = "accept", .ret_type = 1, .nargs = 3,
181 .args = { { Int, 0 }, { Sockaddr | OUT, 1 }, { Ptr | OUT, 2 } } },
182 { .name = "bind", .ret_type = 1, .nargs = 3,
183 .args = { { Int, 0 }, { Sockaddr | IN, 1 }, { Int, 2 } } },
184 { .name = "connect", .ret_type = 1, .nargs = 3,
185 .args = { { Int, 0 }, { Sockaddr | IN, 1 }, { Int, 2 } } },
186 { .name = "getpeername", .ret_type = 1, .nargs = 3,
187 .args = { { Int, 0 }, { Sockaddr | OUT, 1 }, { Ptr | OUT, 2 } } },
188 { .name = "getsockname", .ret_type = 1, .nargs = 3,
189 .args = { { Int, 0 }, { Sockaddr | OUT, 1 }, { Ptr | OUT, 2 } } },
190 { .name = "recvfrom", .ret_type = 1, .nargs = 6,
191 .args = { { Int, 0 }, { BinString | OUT, 1 }, { Int, 2 }, { Hex, 3 }, { Sockaddr | OUT, 4 }, { Ptr | OUT, 5 } } },
192 { .name = "sendto", .ret_type = 1, .nargs = 6,
193 .args = { { Int, 0 }, { BinString | IN, 1 }, { Int, 2 }, { Hex, 3 }, { Sockaddr | IN, 4 }, { Ptr | IN, 5 } } },
194 { .name = "execve", .ret_type = 1, .nargs = 3,
195 .args = { { Name | IN, 0 }, { StringArray | IN, 1 }, { StringArray | IN, 2 } } },
196 { .name = "linux_execve", .ret_type = 1, .nargs = 3,
197 .args = { { Name | IN, 0 }, { StringArray | IN, 1 }, { StringArray | IN, 2 } } },
198 { .name = "kldload", .ret_type = 0, .nargs = 1,
199 .args = { { Name | IN, 0 } } },
200 { .name = "kldunload", .ret_type = 0, .nargs = 1,
201 .args = { { Int, 0 } } },
202 { .name = "kldfind", .ret_type = 0, .nargs = 1,
203 .args = { { Name | IN, 0 } } },
204 { .name = "kldnext", .ret_type = 0, .nargs = 1,
205 .args = { { Int, 0 } } },
206 { .name = "kldstat", .ret_type = 0, .nargs = 2,
207 .args = { { Int, 0 }, { Ptr, 1 } } },
208 { .name = "kldfirstmod", .ret_type = 0, .nargs = 1,
209 .args = { { Int, 0 } } },
210 { .name = "nanosleep", .ret_type = 0, .nargs = 1,
211 .args = { { Timespec, 0 } } },
212 { .name = "select", .ret_type = 1, .nargs = 5,
213 .args = { { Int, 0 }, { Fd_set, 1 }, { Fd_set, 2 }, { Fd_set, 3 }, { Timeval, 4 } } },
214 { .name = "poll", .ret_type = 1, .nargs = 3,
215 .args = { { Pollfd, 0 }, { Int, 1 }, { Int, 2 } } },
216 { .name = "gettimeofday", .ret_type = 1, .nargs = 2,
217 .args = { { Timeval | OUT, 0 }, { Ptr, 1 } } },
218 { .name = "clock_gettime", .ret_type = 1, .nargs = 2,
219 .args = { { Int, 0 }, { Timespec | OUT, 1 } } },
220 { .name = "getitimer", .ret_type = 1, .nargs = 2,
221 .args = { { Int, 0 }, { Itimerval | OUT, 2 } } },
222 { .name = "setitimer", .ret_type = 1, .nargs = 3,
223 .args = { { Int, 0 }, { Itimerval, 1 } , { Itimerval | OUT, 2 } } },
224 { .name = "kse_release", .ret_type = 0, .nargs = 1,
225 .args = { { Timespec, 0 } } },
226 { .name = "kevent", .ret_type = 0, .nargs = 6,
227 .args = { { Int, 0 }, { Kevent, 1 }, { Int, 2 }, { Kevent | OUT, 3 }, { Int, 4 }, { Timespec, 5 } } },
228 { .name = "_umtx_lock", .ret_type = 0, .nargs = 1,
229 .args = { { Umtx, 0 } } },
230 { .name = "_umtx_unlock", .ret_type = 0, .nargs = 1,
231 .args = { { Umtx, 0 } } },
232 { .name = "sigprocmask", .ret_type = 0, .nargs = 3,
233 .args = { { Sigprocmask, 0 }, { Sigset, 1 }, { Sigset | OUT, 2 } } },
234 { .name = "unmount", .ret_type = 1, .nargs = 2,
235 .args = { { Name, 0 }, { Int, 1 } } },
236 { .name = "socket", .ret_type = 1, .nargs = 3,
237 .args = { { Sockdomain, 0 }, { Socktype, 1 }, { Int, 2 } } },
238 { .name = "getrusage", .ret_type = 1, .nargs = 2,
239 .args = { { Int, 0 }, { Rusage | OUT, 1 } } },
240 { .name = "__getcwd", .ret_type = 1, .nargs = 2,
241 .args = { { Name | OUT, 0 }, { Int, 1 } } },
242 { .name = "shutdown", .ret_type = 1, .nargs = 2,
243 .args = { { Int, 0 }, { Shutdown, 1 } } },
244 { .name = "getrlimit", .ret_type = 1, .nargs = 2,
245 .args = { { Resource, 0 }, { Rlimit | OUT, 1 } } },
246 { .name = "setrlimit", .ret_type = 1, .nargs = 2,
247 .args = { { Resource, 0 }, { Rlimit | IN, 1 } } },
248 { .name = "utimes", .ret_type = 1, .nargs = 2,
249 .args = { { Name | IN, 0 }, { Timeval2 | IN, 1 } } },
250 { .name = "lutimes", .ret_type = 1, .nargs = 2,
251 .args = { { Name | IN, 0 }, { Timeval2 | IN, 1 } } },
252 { .name = "futimes", .ret_type = 1, .nargs = 2,
253 .args = { { Int, 0 }, { Timeval | IN, 1 } } },
254 { .name = "chflags", .ret_type = 1, .nargs = 2,
255 .args = { { Name | IN, 0 }, { Hex, 1 } } },
256 { .name = "lchflags", .ret_type = 1, .nargs = 2,
257 .args = { { Name | IN, 0 }, { Hex, 1 } } },
258 { .name = "pathconf", .ret_type = 1, .nargs = 2,
259 .args = { { Name | IN, 0 }, { Pathconf, 1 } } },
260 { .name = "pipe", .ret_type = 1, .nargs = 1,
261 .args = { { Ptr, 0 } } },
262 { .name = "truncate", .ret_type = 1, .nargs = 3,
263 .args = { { Name | IN, 0 }, { Int | IN, 1 }, { Quad | IN, 2 } } },
264 { .name = "ftruncate", .ret_type = 1, .nargs = 3,
265 .args = { { Int | IN, 0 }, { Int | IN, 1 }, { Quad | IN, 2 } } },
266 { .name = "kill", .ret_type = 1, .nargs = 2,
267 .args = { { Int | IN, 0 }, { Signal | IN, 1 } } },
268 { .name = "munmap", .ret_type = 1, .nargs = 2,
269 .args = { { Ptr, 0 }, { Int, 1 } } },
270 { .name = "read", .ret_type = 1, .nargs = 3,
271 .args = { { Int, 0 }, { BinString | OUT, 1 }, { Int, 2 } } },
272 { .name = "rename", .ret_type = 1, .nargs = 2,
273 .args = { { Name , 0 } , { Name, 1 } } },
274 { .name = "symlink", .ret_type = 1, .nargs = 2,
275 .args = { { Name , 0 } , { Name, 1 } } },
276 { .name = "posix_openpt", .ret_type = 1, .nargs = 1,
277 .args = { { Open, 0 } } },
278 { .name = "wait4", .ret_type = 1, .nargs = 4,
279 .args = { { Int, 0 }, { ExitStatus | OUT, 1 }, { Waitoptions, 2 },
280 { Rusage | OUT, 3 } } },
281 { .name = "wait6", .ret_type = 1, .nargs = 6,
282 .args = { { Idtype, 0 }, { Int, 1 }, { ExitStatus | OUT, 2 },
283 { Waitoptions, 3 }, { Rusage | OUT, 4 }, { Ptr, 5 } } },
284 { .name = "procctl", .ret_type = 1, .nargs = 4,
285 .args = { { Idtype, 0 }, { Int, 1 }, { Procctl, 2 }, { Ptr, 3 } } },
289 /* Xlat idea taken from strace */
295 #define X(a) { a, #a },
296 #define XEND { 0, NULL }
298 static struct xlat kevent_filters[] = {
299 X(EVFILT_READ) X(EVFILT_WRITE) X(EVFILT_AIO) X(EVFILT_VNODE)
300 X(EVFILT_PROC) X(EVFILT_SIGNAL) X(EVFILT_TIMER)
301 X(EVFILT_FS) X(EVFILT_READ) XEND
304 static struct xlat kevent_flags[] = {
305 X(EV_ADD) X(EV_DELETE) X(EV_ENABLE) X(EV_DISABLE) X(EV_ONESHOT)
306 X(EV_CLEAR) X(EV_FLAG1) X(EV_ERROR) X(EV_EOF) XEND
309 static struct xlat poll_flags[] = {
310 X(POLLSTANDARD) X(POLLIN) X(POLLPRI) X(POLLOUT) X(POLLERR)
311 X(POLLHUP) X(POLLNVAL) X(POLLRDNORM) X(POLLRDBAND)
312 X(POLLWRBAND) X(POLLINIGNEOF) XEND
315 static struct xlat mmap_flags[] = {
316 X(MAP_SHARED) X(MAP_PRIVATE) X(MAP_FIXED) X(MAP_RENAME)
317 X(MAP_NORESERVE) X(MAP_RESERVED0080) X(MAP_RESERVED0100)
318 X(MAP_HASSEMAPHORE) X(MAP_STACK) X(MAP_NOSYNC) X(MAP_ANON)
319 X(MAP_NOCORE) X(MAP_PREFAULT_READ)
326 static struct xlat mprot_flags[] = {
327 X(PROT_NONE) X(PROT_READ) X(PROT_WRITE) X(PROT_EXEC) XEND
330 static struct xlat whence_arg[] = {
331 X(SEEK_SET) X(SEEK_CUR) X(SEEK_END) XEND
334 static struct xlat sigaction_flags[] = {
335 X(SA_ONSTACK) X(SA_RESTART) X(SA_RESETHAND) X(SA_NOCLDSTOP)
336 X(SA_NODEFER) X(SA_NOCLDWAIT) X(SA_SIGINFO) XEND
339 static struct xlat fcntl_arg[] = {
340 X(F_DUPFD) X(F_GETFD) X(F_SETFD) X(F_GETFL) X(F_SETFL)
341 X(F_GETOWN) X(F_SETOWN) X(F_GETLK) X(F_SETLK) X(F_SETLKW) XEND
344 static struct xlat fcntlfd_arg[] = {
348 static struct xlat fcntlfl_arg[] = {
349 X(O_APPEND) X(O_ASYNC) X(O_FSYNC) X(O_NONBLOCK) X(O_NOFOLLOW)
353 static struct xlat sockdomain_arg[] = {
354 X(PF_UNSPEC) X(PF_LOCAL) X(PF_UNIX) X(PF_INET) X(PF_IMPLINK)
355 X(PF_PUP) X(PF_CHAOS) X(PF_NETBIOS) X(PF_ISO) X(PF_OSI)
356 X(PF_ECMA) X(PF_DATAKIT) X(PF_CCITT) X(PF_SNA) X(PF_DECnet)
357 X(PF_DLI) X(PF_LAT) X(PF_HYLINK) X(PF_APPLETALK) X(PF_ROUTE)
358 X(PF_LINK) X(PF_XTP) X(PF_COIP) X(PF_CNT) X(PF_SIP) X(PF_IPX)
359 X(PF_RTIP) X(PF_PIP) X(PF_ISDN) X(PF_KEY) X(PF_INET6)
360 X(PF_NATM) X(PF_ATM) X(PF_NETGRAPH) X(PF_SLOW) X(PF_SCLUSTER)
361 X(PF_ARP) X(PF_BLUETOOTH) XEND
364 static struct xlat socktype_arg[] = {
365 X(SOCK_STREAM) X(SOCK_DGRAM) X(SOCK_RAW) X(SOCK_RDM)
366 X(SOCK_SEQPACKET) XEND
369 static struct xlat open_flags[] = {
370 X(O_RDONLY) X(O_WRONLY) X(O_RDWR) X(O_ACCMODE) X(O_NONBLOCK)
371 X(O_APPEND) X(O_SHLOCK) X(O_EXLOCK) X(O_ASYNC) X(O_FSYNC)
372 X(O_NOFOLLOW) X(O_CREAT) X(O_TRUNC) X(O_EXCL) X(O_NOCTTY)
373 X(O_DIRECT) X(O_DIRECTORY) X(O_EXEC) X(O_TTY_INIT) X(O_CLOEXEC) XEND
376 static struct xlat shutdown_arg[] = {
377 X(SHUT_RD) X(SHUT_WR) X(SHUT_RDWR) XEND
380 static struct xlat resource_arg[] = {
381 X(RLIMIT_CPU) X(RLIMIT_FSIZE) X(RLIMIT_DATA) X(RLIMIT_STACK)
382 X(RLIMIT_CORE) X(RLIMIT_RSS) X(RLIMIT_MEMLOCK) X(RLIMIT_NPROC)
383 X(RLIMIT_NOFILE) X(RLIMIT_SBSIZE) X(RLIMIT_VMEM) XEND
386 static struct xlat pathconf_arg[] = {
387 X(_PC_LINK_MAX) X(_PC_MAX_CANON) X(_PC_MAX_INPUT)
388 X(_PC_NAME_MAX) X(_PC_PATH_MAX) X(_PC_PIPE_BUF)
389 X(_PC_CHOWN_RESTRICTED) X(_PC_NO_TRUNC) X(_PC_VDISABLE)
390 X(_PC_ASYNC_IO) X(_PC_PRIO_IO) X(_PC_SYNC_IO)
391 X(_PC_ALLOC_SIZE_MIN) X(_PC_FILESIZEBITS)
392 X(_PC_REC_INCR_XFER_SIZE) X(_PC_REC_MAX_XFER_SIZE)
393 X(_PC_REC_MIN_XFER_SIZE) X(_PC_REC_XFER_ALIGN)
394 X(_PC_SYMLINK_MAX) X(_PC_ACL_EXTENDED) X(_PC_ACL_PATH_MAX)
395 X(_PC_CAP_PRESENT) X(_PC_INF_PRESENT) X(_PC_MAC_PRESENT)
399 static struct xlat rfork_flags[] = {
400 X(RFPROC) X(RFNOWAIT) X(RFFDG) X(RFCFDG) X(RFTHREAD) X(RFMEM)
401 X(RFSIGSHARE) X(RFTSIGZMB) X(RFLINUXTHPN) XEND
404 static struct xlat wait_options[] = {
405 X(WNOHANG) X(WUNTRACED) X(WCONTINUED) X(WNOWAIT) X(WEXITED)
409 static struct xlat idtype_arg[] = {
410 X(P_PID) X(P_PPID) X(P_PGID) X(P_SID) X(P_CID) X(P_UID) X(P_GID)
411 X(P_ALL) X(P_LWPID) X(P_TASKID) X(P_PROJID) X(P_POOLID) X(P_JAILID)
412 X(P_CTID) X(P_CPUID) X(P_PSETID) XEND
415 static struct xlat procctl_arg[] = {
416 X(PROC_SPROTECT) XEND
423 * Searches an xlat array for a value, and returns it if found. Otherwise
424 * return a string representation.
427 lookup(struct xlat *xlat, int val, int base)
431 for (; xlat->str != NULL; xlat++)
432 if (xlat->val == val)
436 sprintf(tmp, "0%o", val);
439 sprintf(tmp, "0x%x", val);
442 sprintf(tmp, "%u", val);
445 errx(1,"Unknown lookup base");
452 xlookup(struct xlat *xlat, int val)
455 return (lookup(xlat, val, 16));
458 /* Searches an xlat array containing bitfield values. Remaining bits
459 set after removing the known ones are printed at the end:
462 xlookup_bits(struct xlat *xlat, int val)
465 static char str[512];
469 for (; xlat->str != NULL; xlat++) {
470 if ((xlat->val & rem) == xlat->val) {
471 /* don't print the "all-bits-zero" string unless all
472 bits are really zero */
473 if (xlat->val == 0 && val != 0)
475 len += sprintf(str + len, "%s|", xlat->str);
479 /* if we have leftover bits or didn't match anything */
481 len += sprintf(str + len, "0x%x", rem);
482 if (len && str[len - 1] == '|')
489 * If/when the list gets big, it might be desirable to do it
490 * as a hash table or binary search.
494 get_syscall(const char *name)
502 if (strcmp(name, sc->name) == 0)
512 * Copy a fixed amount of bytes from the process.
516 get_struct(pid_t pid, void *offset, void *buf, int len)
518 struct ptrace_io_desc iorequest;
520 iorequest.piod_op = PIOD_READ_D;
521 iorequest.piod_offs = offset;
522 iorequest.piod_addr = buf;
523 iorequest.piod_len = len;
524 if (ptrace(PT_IO, pid, (caddr_t)&iorequest, 0) < 0)
530 #define BLOCKSIZE 1024
533 * Copy a string from the process. Note that it is
534 * expected to be a C string, but if max is set, it will
535 * only get that much.
539 get_string(pid_t pid, void *offset, int max)
541 struct ptrace_io_desc iorequest;
543 int diff, i, size, totalsize;
546 totalsize = size = max ? (max + 1) : BLOCKSIZE;
547 buf = malloc(totalsize);
551 diff = totalsize - size;
552 iorequest.piod_op = PIOD_READ_D;
553 iorequest.piod_offs = (char *)offset + diff;
554 iorequest.piod_addr = buf + diff;
555 iorequest.piod_len = size;
556 if (ptrace(PT_IO, pid, (caddr_t)&iorequest, 0) < 0) {
560 for (i = 0 ; i < size; i++) {
561 if (buf[diff + i] == '\0')
564 if (totalsize < MAXSIZE - BLOCKSIZE && max == 0) {
565 totalsize += BLOCKSIZE;
566 buf = realloc(buf, totalsize);
569 buf[totalsize - 1] = '\0';
582 asprintf(&tmp, "%d", sig);
588 * Converts a syscall argument into a string. Said string is
589 * allocated via malloc(), so needs to be free()'d. The file
590 * descriptor is for the process' memory (via /proc), and is used
591 * to get any data (where the argument is a pointer). sc is
592 * a pointer to the syscall description (see above); args is
593 * an array of all of the system call arguments.
597 print_arg(struct syscall_args *sc, unsigned long *args, long retval,
598 struct trussinfo *trussinfo)
604 pid = trussinfo->pid;
605 switch (sc->type & ARG_MASK) {
607 asprintf(&tmp, "0x%x", (int)args[sc->offset]);
610 asprintf(&tmp, "0%o", (int)args[sc->offset]);
613 asprintf(&tmp, "%d", (int)args[sc->offset]);
616 /* NULL-terminated string. */
618 tmp2 = get_string(pid, (void*)args[sc->offset], 0);
619 asprintf(&tmp, "\"%s\"", tmp2);
624 /* Binary block of data that might have printable characters.
625 XXX If type|OUT, assume that the length is the syscall's
626 return value. Otherwise, assume that the length of the block
627 is in the next syscall argument. */
628 int max_string = trussinfo->strsize;
629 char tmp2[max_string+1], *tmp3;
636 len = args[sc->offset + 1];
638 /* Don't print more than max_string characters, to avoid word
639 wrap. If we have to truncate put some ... after the string.
641 if (len > max_string) {
645 if (len && get_struct(pid, (void*)args[sc->offset], &tmp2, len)
647 tmp3 = malloc(len * 4 + 1);
649 if (strvisx(tmp3, tmp2, len,
650 VIS_CSTYLE|VIS_TAB|VIS_NL) <= max_string)
655 asprintf(&tmp, "\"%s\"%s", tmp3, truncated ?
659 asprintf(&tmp, "0x%lx", args[sc->offset]);
667 char *strarray[100]; /* XXX This is ugly. */
669 if (get_struct(pid, (void *)args[sc->offset],
670 (void *)&strarray, sizeof(strarray)) == -1)
671 err(1, "get_struct %p", (void *)args[sc->offset]);
675 /* Find out how large of a buffer we'll need. */
676 while (strarray[num] != NULL) {
677 string = get_string(pid, (void*)strarray[num], 0);
678 size += strlen(string);
682 size += 4 + (num * 4);
683 tmp = (char *)malloc(size);
686 tmp2 += sprintf(tmp2, " [");
687 for (i = 0; i < num; i++) {
688 string = get_string(pid, (void*)strarray[i], 0);
689 tmp2 += sprintf(tmp2, " \"%s\"%c", string,
690 (i + 1 == num) ? ' ' : ',');
693 tmp2 += sprintf(tmp2, "]");
698 asprintf(&tmp, "0x%lx", args[sc->offset]);
702 unsigned long long ll;
703 ll = *(unsigned long long *)(args + sc->offset);
704 asprintf(&tmp, "0x%llx", ll);
709 asprintf(&tmp, "0x%lx", args[sc->offset]);
717 tmp2 = get_string(pid, (void*)args[sc->offset], retval);
718 asprintf(&tmp, "\"%s\"", tmp2);
723 const char *temp = ioctlname(args[sc->offset]);
727 unsigned long arg = args[sc->offset];
728 asprintf(&tmp, "0x%lx { IO%s%s 0x%lx('%c'), %lu, %lu }",
729 arg, arg & IOC_OUT ? "R" : "",
730 arg & IOC_IN ? "W" : "", IOCGROUP(arg),
731 isprint(IOCGROUP(arg)) ? (char)IOCGROUP(arg) : '?',
732 arg & 0xFF, IOCPARM_LEN(arg));
738 if (get_struct(pid, (void *)args[sc->offset], &umtx,
740 asprintf(&tmp, "{ 0x%lx }", (long)umtx.u_owner);
742 asprintf(&tmp, "0x%lx", args[sc->offset]);
747 if (get_struct(pid, (void *)args[sc->offset], &ts,
749 asprintf(&tmp, "{%ld.%09ld }", (long)ts.tv_sec,
752 asprintf(&tmp, "0x%lx", args[sc->offset]);
757 if (get_struct(pid, (void *)args[sc->offset], &tv, sizeof(tv))
759 asprintf(&tmp, "{%ld.%06ld }", (long)tv.tv_sec,
762 asprintf(&tmp, "0x%lx", args[sc->offset]);
766 struct timeval tv[2];
767 if (get_struct(pid, (void *)args[sc->offset], &tv, sizeof(tv))
769 asprintf(&tmp, "{%ld.%06ld, %ld.%06ld }",
770 (long)tv[0].tv_sec, tv[0].tv_usec,
771 (long)tv[1].tv_sec, tv[1].tv_usec);
773 asprintf(&tmp, "0x%lx", args[sc->offset]);
777 struct itimerval itv;
778 if (get_struct(pid, (void *)args[sc->offset], &itv,
780 asprintf(&tmp, "{%ld.%06ld, %ld.%06ld }",
781 (long)itv.it_interval.tv_sec,
782 itv.it_interval.tv_usec,
783 (long)itv.it_value.tv_sec,
784 itv.it_value.tv_usec);
786 asprintf(&tmp, "0x%lx", args[sc->offset]);
791 struct linux_socketcall_args largs;
792 if (get_struct(pid, (void *)args[sc->offset], (void *)&largs,
793 sizeof(largs)) == -1) {
794 err(1, "get_struct %p", (void *)args[sc->offset]);
799 switch (largs.what) {
801 what = "LINUX_SOCKET";
807 what = "LINUX_CONNECT";
810 what = "LINUX_LISTEN";
813 what = "LINUX_ACCEPT";
815 case LINUX_GETSOCKNAME:
816 what = "LINUX_GETSOCKNAME";
818 case LINUX_GETPEERNAME:
819 what = "LINUX_GETPEERNAME";
821 case LINUX_SOCKETPAIR:
822 what = "LINUX_SOCKETPAIR";
831 what = "LINUX_SENDTO";
834 what = "LINUX_RECVFROM";
837 what = "LINUX_SHUTDOWN";
839 case LINUX_SETSOCKOPT:
840 what = "LINUX_SETSOCKOPT";
842 case LINUX_GETSOCKOPT:
843 what = "LINUX_GETSOCKOPT";
846 what = "LINUX_SENDMSG";
849 what = "LINUX_RECVMSG";
852 sprintf(buf, "%d", largs.what);
856 asprintf(&tmp, "(0x%lx)%s, 0x%lx", args[sc->offset], what, (long unsigned int)largs.args);
861 * XXX: A Pollfd argument expects the /next/ syscall argument
862 * to be the number of fds in the array. This matches the poll
866 int numfds = args[sc->offset+1];
867 int bytes = sizeof(struct pollfd) * numfds;
868 int i, tmpsize, u, used;
869 const int per_fd = 100;
871 if ((pfd = malloc(bytes)) == NULL)
872 err(1, "Cannot malloc %d bytes for pollfd array",
874 if (get_struct(pid, (void *)args[sc->offset], pfd, bytes)
877 tmpsize = 1 + per_fd * numfds + 2;
878 if ((tmp = malloc(tmpsize)) == NULL)
879 err(1, "Cannot alloc %d bytes for poll output",
883 for (i = 0; i < numfds; i++) {
885 u = snprintf(tmp + used, per_fd, "%s%d/%s",
886 i > 0 ? " " : "", pfd[i].fd,
887 xlookup_bits(poll_flags, pfd[i].events));
889 used += u < per_fd ? u : per_fd;
894 asprintf(&tmp, "0x%lx", args[sc->offset]);
901 * XXX: A Fd_set argument expects the /first/ syscall argument
902 * to be the number of fds in the array. This matches the
906 int numfds = args[0];
907 int bytes = _howmany(numfds, _NFDBITS) * _NFDBITS;
908 int i, tmpsize, u, used;
909 const int per_fd = 20;
911 if ((fds = malloc(bytes)) == NULL)
912 err(1, "Cannot malloc %d bytes for fd_set array",
914 if (get_struct(pid, (void *)args[sc->offset], fds, bytes)
917 tmpsize = 1 + numfds * per_fd + 2;
918 if ((tmp = malloc(tmpsize)) == NULL)
919 err(1, "Cannot alloc %d bytes for fd_set "
923 for (i = 0; i < numfds; i++) {
924 if (FD_ISSET(i, fds)) {
925 u = snprintf(tmp + used, per_fd, "%d ",
928 used += u < per_fd ? u : per_fd;
931 if (tmp[used-1] == ' ')
936 asprintf(&tmp, "0x%lx", args[sc->offset]);
941 tmp = strsig2(args[sc->offset]);
949 sig = args[sc->offset];
950 if (get_struct(pid, (void *)args[sc->offset], (void *)&ss,
952 asprintf(&tmp, "0x%lx", args[sc->offset]);
955 tmp = malloc(sys_nsig * 8); /* 7 bytes avg per signal name */
957 for (i = 1; i < sys_nsig; i++) {
958 if (sigismember(&ss, i)) {
960 used += sprintf(tmp + used, "%s|", signame);
971 switch (args[sc->offset]) {
972 #define S(a) case a: tmp = strdup(#a); break;
979 asprintf(&tmp, "0x%lx", args[sc->offset]);
983 /* XXX output depends on the value of the previous argument */
984 switch (args[sc->offset-1]) {
986 tmp = strdup(xlookup_bits(fcntlfd_arg,
990 tmp = strdup(xlookup_bits(fcntlfl_arg,
999 asprintf(&tmp, "0x%lx", args[sc->offset]);
1005 tmp = strdup(xlookup_bits(open_flags, args[sc->offset]));
1008 tmp = strdup(xlookup(fcntl_arg, args[sc->offset]));
1011 tmp = strdup(xlookup_bits(mprot_flags, args[sc->offset]));
1014 char *base, *alignstr;
1018 * MAP_ALIGNED can't be handled by xlookup_bits(), so
1019 * generate that string manually and prepend it to the
1020 * string from xlookup_bits(). Have to be careful to
1021 * avoid outputting MAP_ALIGNED|0 if MAP_ALIGNED is
1024 flags = args[sc->offset] & ~MAP_ALIGNMENT_MASK;
1025 align = args[sc->offset] & MAP_ALIGNMENT_MASK;
1027 if (align == MAP_ALIGNED_SUPER)
1028 alignstr = strdup("MAP_ALIGNED_SUPER");
1030 asprintf(&alignstr, "MAP_ALIGNED(%d)",
1031 align >> MAP_ALIGNMENT_SHIFT);
1038 base = strdup(xlookup_bits(mmap_flags, flags));
1039 if (alignstr == NULL) {
1043 asprintf(&tmp, "%s|%s", alignstr, base);
1049 tmp = strdup(xlookup(whence_arg, args[sc->offset]));
1052 tmp = strdup(xlookup(sockdomain_arg, args[sc->offset]));
1055 tmp = strdup(xlookup(socktype_arg, args[sc->offset]));
1058 tmp = strdup(xlookup(shutdown_arg, args[sc->offset]));
1061 tmp = strdup(xlookup(resource_arg, args[sc->offset]));
1064 tmp = strdup(xlookup(pathconf_arg, args[sc->offset]));
1067 tmp = strdup(xlookup_bits(rfork_flags, args[sc->offset]));
1070 struct sockaddr_storage ss;
1072 struct sockaddr_in *lsin;
1073 struct sockaddr_in6 *lsin6;
1074 struct sockaddr_un *sun;
1075 struct sockaddr *sa;
1080 if (args[sc->offset] == 0) {
1081 asprintf(&tmp, "NULL");
1085 /* yuck: get ss_len */
1086 if (get_struct(pid, (void *)args[sc->offset], (void *)&ss,
1087 sizeof(ss.ss_len) + sizeof(ss.ss_family)) == -1)
1088 err(1, "get_struct %p", (void *)args[sc->offset]);
1090 * If ss_len is 0, then try to guess from the sockaddr type.
1091 * AF_UNIX may be initialized incorrectly, so always frob
1092 * it by using the "right" size.
1094 if (ss.ss_len == 0 || ss.ss_family == AF_UNIX) {
1095 switch (ss.ss_family) {
1097 ss.ss_len = sizeof(*lsin);
1100 ss.ss_len = sizeof(*sun);
1107 if (get_struct(pid, (void *)args[sc->offset], (void *)&ss,
1109 err(2, "get_struct %p", (void *)args[sc->offset]);
1112 switch (ss.ss_family) {
1114 lsin = (struct sockaddr_in *)&ss;
1115 inet_ntop(AF_INET, &lsin->sin_addr, addr, sizeof addr);
1116 asprintf(&tmp, "{ AF_INET %s:%d }", addr,
1117 htons(lsin->sin_port));
1120 lsin6 = (struct sockaddr_in6 *)&ss;
1121 inet_ntop(AF_INET6, &lsin6->sin6_addr, addr,
1123 asprintf(&tmp, "{ AF_INET6 [%s]:%d }", addr,
1124 htons(lsin6->sin6_port));
1127 sun = (struct sockaddr_un *)&ss;
1128 asprintf(&tmp, "{ AF_UNIX \"%s\" }", sun->sun_path);
1131 sa = (struct sockaddr *)&ss;
1132 asprintf(&tmp, "{ sa_len = %d, sa_family = %d, sa_data "
1133 "= {%n%*s } }", (int)sa->sa_len, (int)sa->sa_family,
1134 &i, 6 * (int)(sa->sa_len - ((char *)&sa->sa_data -
1138 for (q = (u_char *)&sa->sa_data;
1139 q < (u_char *)sa + sa->sa_len; q++)
1140 p += sprintf(p, " %#02x,", *q);
1146 struct sigaction sa;
1150 if (get_struct(pid, (void *)args[sc->offset], &sa, sizeof(sa))
1152 asprintf(&hand, "%p", sa.sa_handler);
1153 if (sa.sa_handler == SIG_DFL)
1155 else if (sa.sa_handler == SIG_IGN)
1160 asprintf(&tmp, "{ %s %s ss_t }", h,
1161 xlookup_bits(sigaction_flags, sa.sa_flags));
1164 asprintf(&tmp, "0x%lx", args[sc->offset]);
1169 * XXX XXX: the size of the array is determined by either the
1170 * next syscall argument, or by the syscall returnvalue,
1171 * depending on which argument number we are. This matches the
1172 * kevent syscall, but luckily that's the only syscall that uses
1178 int i, tmpsize, u, used;
1179 const int per_ke = 100;
1181 if (sc->offset == 1)
1182 numevents = args[sc->offset+1];
1183 else if (sc->offset == 3 && retval != -1)
1187 bytes = sizeof(struct kevent) * numevents;
1188 if ((ke = malloc(bytes)) == NULL)
1189 err(1, "Cannot malloc %d bytes for kevent array",
1191 if (numevents >= 0 && get_struct(pid, (void *)args[sc->offset],
1194 tmpsize = 1 + per_ke * numevents + 2;
1195 if ((tmp = malloc(tmpsize)) == NULL)
1196 err(1, "Cannot alloc %d bytes for kevent "
1200 for (i = 0; i < numevents; i++) {
1201 u = snprintf(tmp + used, per_ke,
1202 "%s%p,%s,%s,%d,%p,%p",
1204 (void *)ke[i].ident,
1205 xlookup(kevent_filters, ke[i].filter),
1206 xlookup_bits(kevent_flags, ke[i].flags),
1209 (void *)ke[i].udata);
1211 used += u < per_ke ? u : per_ke;
1216 asprintf(&tmp, "0x%lx", args[sc->offset]);
1223 if (get_struct(pid, (void *)args[sc->offset], &st, sizeof(st))
1226 strmode(st.st_mode, mode);
1228 "{ mode=%s,inode=%jd,size=%jd,blksize=%ld }", mode,
1229 (intmax_t)st.st_ino, (intmax_t)st.st_size,
1230 (long)st.st_blksize);
1232 asprintf(&tmp, "0x%lx", args[sc->offset]);
1238 if (get_struct(pid, (void *)args[sc->offset], &ru, sizeof(ru))
1241 "{ u=%ld.%06ld,s=%ld.%06ld,in=%ld,out=%ld }",
1242 (long)ru.ru_utime.tv_sec, ru.ru_utime.tv_usec,
1243 (long)ru.ru_stime.tv_sec, ru.ru_stime.tv_usec,
1244 ru.ru_inblock, ru.ru_oublock);
1246 asprintf(&tmp, "0x%lx", args[sc->offset]);
1251 if (get_struct(pid, (void *)args[sc->offset], &rl, sizeof(rl))
1253 asprintf(&tmp, "{ cur=%ju,max=%ju }",
1254 rl.rlim_cur, rl.rlim_max);
1256 asprintf(&tmp, "0x%lx", args[sc->offset]);
1263 if (get_struct(pid, (void *)args[sc->offset], &status,
1264 sizeof(status)) != -1) {
1265 if (WIFCONTINUED(status))
1266 tmp = strdup("{ CONTINUED }");
1267 else if (WIFEXITED(status))
1268 asprintf(&tmp, "{ EXITED,val=%d }",
1269 WEXITSTATUS(status));
1270 else if (WIFSIGNALED(status))
1271 asprintf(&tmp, "{ SIGNALED,sig=%s%s }",
1272 signame = strsig2(WTERMSIG(status)),
1273 WCOREDUMP(status) ? ",cored" : "");
1275 asprintf(&tmp, "{ STOPPED,sig=%s }",
1276 signame = strsig2(WTERMSIG(status)));
1278 asprintf(&tmp, "0x%lx", args[sc->offset]);
1283 tmp = strdup(xlookup_bits(wait_options, args[sc->offset]));
1286 tmp = strdup(xlookup(idtype_arg, args[sc->offset]));
1289 tmp = strdup(xlookup(procctl_arg, args[sc->offset]));
1292 errx(1, "Invalid argument type %d\n", sc->type & ARG_MASK);
1299 * Print (to outfile) the system call and its arguments. Note that
1300 * nargs is the number of arguments (not the number of words; this is
1301 * potentially confusing, I know).
1305 print_syscall(struct trussinfo *trussinfo, const char *name, int nargs,
1308 struct timespec timediff;
1312 if (trussinfo->flags & FOLLOWFORKS)
1313 len += fprintf(trussinfo->outfile, "%5d: ", trussinfo->pid);
1315 if (name != NULL && (strcmp(name, "execve") == 0 ||
1316 strcmp(name, "exit") == 0)) {
1317 clock_gettime(CLOCK_REALTIME, &trussinfo->curthread->after);
1320 if (trussinfo->flags & ABSOLUTETIMESTAMPS) {
1321 timespecsubt(&trussinfo->curthread->after,
1322 &trussinfo->start_time, &timediff);
1323 len += fprintf(trussinfo->outfile, "%ld.%09ld ",
1324 (long)timediff.tv_sec, timediff.tv_nsec);
1327 if (trussinfo->flags & RELATIVETIMESTAMPS) {
1328 timespecsubt(&trussinfo->curthread->after,
1329 &trussinfo->curthread->before, &timediff);
1330 len += fprintf(trussinfo->outfile, "%ld.%09ld ",
1331 (long)timediff.tv_sec, timediff.tv_nsec);
1334 len += fprintf(trussinfo->outfile, "%s(", name);
1336 for (i = 0; i < nargs; i++) {
1338 len += fprintf(trussinfo->outfile, "%s", s_args[i]);
1340 len += fprintf(trussinfo->outfile,
1341 "<missing argument>");
1342 len += fprintf(trussinfo->outfile, "%s", i < (nargs - 1) ?
1345 len += fprintf(trussinfo->outfile, ")");
1346 for (i = 0; i < 6 - (len / 8); i++)
1347 fprintf(trussinfo->outfile, "\t");
1351 print_syscall_ret(struct trussinfo *trussinfo, const char *name, int nargs,
1352 char **s_args, int errorp, long retval, struct syscall *sc)
1354 struct timespec timediff;
1356 if (trussinfo->flags & COUNTONLY) {
1359 clock_gettime(CLOCK_REALTIME, &trussinfo->curthread->after);
1360 timespecsubt(&trussinfo->curthread->after,
1361 &trussinfo->curthread->before, &timediff);
1362 timespecadd(&sc->time, &timediff, &sc->time);
1369 print_syscall(trussinfo, name, nargs, s_args);
1370 fflush(trussinfo->outfile);
1372 fprintf(trussinfo->outfile, " ERR#%ld '%s'\n", retval,
1376 * Because pipe(2) has a special assembly glue to provide the
1377 * libc API, we have to adjust retval.
1379 if (name != NULL && strcmp(name, "pipe") == 0)
1381 fprintf(trussinfo->outfile, " = %ld (0x%lx)\n", retval, retval);
1386 print_summary(struct trussinfo *trussinfo)
1388 struct timespec total = {0, 0};
1392 fprintf(trussinfo->outfile, "%-20s%15s%8s%8s\n",
1393 "syscall", "seconds", "calls", "errors");
1395 for (sc = syscalls; sc->name != NULL; sc++)
1397 fprintf(trussinfo->outfile, "%-20s%5jd.%09ld%8d%8d\n",
1398 sc->name, (intmax_t)sc->time.tv_sec,
1399 sc->time.tv_nsec, sc->ncalls, sc->nerror);
1400 timespecadd(&total, &sc->time, &total);
1401 ncall += sc->ncalls;
1402 nerror += sc->nerror;
1404 fprintf(trussinfo->outfile, "%20s%15s%8s%8s\n",
1405 "", "-------------", "-------", "-------");
1406 fprintf(trussinfo->outfile, "%-20s%5jd.%09ld%8d%8d\n",
1407 "", (intmax_t)total.tv_sec, total.tv_nsec, ncall, nerror);