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
43 #include <sys/types.h>
44 #include <sys/ptrace.h>
45 #include <sys/socket.h>
48 #include <netinet/in.h>
49 #include <arpa/inet.h>
50 #include <sys/ioccom.h>
51 #include <machine/atomic.h>
54 #include <sys/event.h>
56 #include <sys/resource.h>
75 /* 64-bit alignment on 32-bit platforms. */
82 /* Number of slots needed for a 64-bit argument. */
90 * This should probably be in its own file, sorted alphabetically.
92 struct syscall syscalls[] = {
93 { .name = "fcntl", .ret_type = 1, .nargs = 3,
94 .args = { { Int, 0 } , { Fcntl, 1 }, { Fcntlflag | OUT, 2 } } },
95 { .name = "fork", .ret_type = 1, .nargs = 0 },
96 { .name = "getegid", .ret_type = 1, .nargs = 0 },
97 { .name = "geteuid", .ret_type = 1, .nargs = 0 },
98 { .name = "getgid", .ret_type = 1, .nargs = 0 },
99 { .name = "getpid", .ret_type = 1, .nargs = 0 },
100 { .name = "getpgid", .ret_type = 1, .nargs = 1,
101 .args = { { Int, 0 } } },
102 { .name = "getpgrp", .ret_type = 1, .nargs = 0 },
103 { .name = "getppid", .ret_type = 1, .nargs = 0 },
104 { .name = "getsid", .ret_type = 1, .nargs = 1,
105 .args = { { Int, 0 } } },
106 { .name = "getuid", .ret_type = 1, .nargs = 0 },
107 { .name = "readlink", .ret_type = 1, .nargs = 3,
108 .args = { { Name, 0 } , { Readlinkres | OUT, 1 }, { Int, 2 } } },
109 { .name = "lseek", .ret_type = 2, .nargs = 3,
110 .args = { { Int, 0 }, { Quad, 1 + QUAD_ALIGN }, { Whence, 1 + QUAD_SLOTS + QUAD_ALIGN } } },
111 { .name = "linux_lseek", .ret_type = 2, .nargs = 3,
112 .args = { { Int, 0 }, { Int, 1 }, { Whence, 2 } } },
113 { .name = "mmap", .ret_type = 2, .nargs = 6,
114 .args = { { Ptr, 0 }, { Int, 1 }, { Mprot, 2 }, { Mmapflags, 3 }, { Int, 4 }, { Quad, 5 + QUAD_ALIGN } } },
115 { .name = "mprotect", .ret_type = 1, .nargs = 3,
116 .args = { { Ptr, 0 }, { Int, 1 }, { Mprot, 2 } } },
117 { .name = "open", .ret_type = 1, .nargs = 3,
118 .args = { { Name | IN, 0 } , { Open, 1 }, { Octal, 2 } } },
119 { .name = "mkdir", .ret_type = 1, .nargs = 2,
120 .args = { { Name, 0 } , { Octal, 1 } } },
121 { .name = "linux_open", .ret_type = 1, .nargs = 3,
122 .args = { { Name, 0 }, { Hex, 1 }, { Octal, 2 } } },
123 { .name = "close", .ret_type = 1, .nargs = 1,
124 .args = { { Int, 0 } } },
125 { .name = "link", .ret_type = 0, .nargs = 2,
126 .args = { { Name, 0 }, { Name, 1 } } },
127 { .name = "unlink", .ret_type = 0, .nargs = 1,
128 .args = { { Name, 0 } } },
129 { .name = "chdir", .ret_type = 0, .nargs = 1,
130 .args = { { Name, 0 } } },
131 { .name = "chroot", .ret_type = 0, .nargs = 1,
132 .args = { { Name, 0 } } },
133 { .name = "mknod", .ret_type = 0, .nargs = 3,
134 .args = { { Name, 0 }, { Octal, 1 }, { Int, 3 } } },
135 { .name = "chmod", .ret_type = 0, .nargs = 2,
136 .args = { { Name, 0 }, { Octal, 1 } } },
137 { .name = "chown", .ret_type = 0, .nargs = 3,
138 .args = { { Name, 0 }, { Int, 1 }, { Int, 2 } } },
139 { .name = "mount", .ret_type = 0, .nargs = 4,
140 .args = { { Name, 0 }, { Name, 1 }, { Int, 2 }, { Ptr, 3 } } },
141 { .name = "umount", .ret_type = 0, .nargs = 2,
142 .args = { { Name, 0 }, { Int, 2 } } },
143 { .name = "fstat", .ret_type = 1, .nargs = 2,
144 .args = { { Int, 0 }, { Stat | OUT , 1 } } },
145 { .name = "stat", .ret_type = 1, .nargs = 2,
146 .args = { { Name | IN, 0 }, { Stat | OUT, 1 } } },
147 { .name = "lstat", .ret_type = 1, .nargs = 2,
148 .args = { { Name | IN, 0 }, { Stat | OUT, 1 } } },
149 { .name = "linux_newstat", .ret_type = 1, .nargs = 2,
150 .args = { { Name | IN, 0 }, { Ptr | OUT, 1 } } },
151 { .name = "linux_newfstat", .ret_type = 1, .nargs = 2,
152 .args = { { Int, 0 }, { Ptr | OUT, 1 } } },
153 { .name = "write", .ret_type = 1, .nargs = 3,
154 .args = { { Int, 0 }, { BinString | IN, 1 }, { Int, 2 } } },
155 { .name = "ioctl", .ret_type = 1, .nargs = 3,
156 .args = { { Int, 0 }, { Ioctl, 1 }, { Hex, 2 } } },
157 { .name = "break", .ret_type = 1, .nargs = 1,
158 .args = { { Ptr, 0 } } },
159 { .name = "exit", .ret_type = 0, .nargs = 1,
160 .args = { { Hex, 0 } } },
161 { .name = "access", .ret_type = 1, .nargs = 2,
162 .args = { { Name | IN, 0 }, { Int, 1 } } },
163 { .name = "sigaction", .ret_type = 1, .nargs = 3,
164 .args = { { Signal, 0 }, { Sigaction | IN, 1 }, { Sigaction | OUT, 2 } } },
165 { .name = "accept", .ret_type = 1, .nargs = 3,
166 .args = { { Int, 0 }, { Sockaddr | OUT, 1 }, { Ptr | OUT, 2 } } },
167 { .name = "bind", .ret_type = 1, .nargs = 3,
168 .args = { { Int, 0 }, { Sockaddr | IN, 1 }, { Int, 2 } } },
169 { .name = "connect", .ret_type = 1, .nargs = 3,
170 .args = { { Int, 0 }, { Sockaddr | IN, 1 }, { Int, 2 } } },
171 { .name = "getpeername", .ret_type = 1, .nargs = 3,
172 .args = { { Int, 0 }, { Sockaddr | OUT, 1 }, { Ptr | OUT, 2 } } },
173 { .name = "getsockname", .ret_type = 1, .nargs = 3,
174 .args = { { Int, 0 }, { Sockaddr | OUT, 1 }, { Ptr | OUT, 2 } } },
175 { .name = "recvfrom", .ret_type = 1, .nargs = 6,
176 .args = { { Int, 0 }, { BinString | OUT, 1 }, { Int, 2 }, { Hex, 3 }, { Sockaddr | OUT, 4 }, { Ptr | OUT, 5 } } },
177 { .name = "sendto", .ret_type = 1, .nargs = 6,
178 .args = { { Int, 0 }, { BinString | IN, 1 }, { Int, 2 }, { Hex, 3 }, { Sockaddr | IN, 4 }, { Ptr | IN, 5 } } },
179 { .name = "execve", .ret_type = 1, .nargs = 3,
180 .args = { { Name | IN, 0 }, { StringArray | IN, 1 }, { StringArray | IN, 2 } } },
181 { .name = "linux_execve", .ret_type = 1, .nargs = 3,
182 .args = { { Name | IN, 0 }, { StringArray | IN, 1 }, { StringArray | IN, 2 } } },
183 { .name = "kldload", .ret_type = 0, .nargs = 1,
184 .args = { { Name | IN, 0 } } },
185 { .name = "kldunload", .ret_type = 0, .nargs = 1,
186 .args = { { Int, 0 } } },
187 { .name = "kldfind", .ret_type = 0, .nargs = 1,
188 .args = { { Name | IN, 0 } } },
189 { .name = "kldnext", .ret_type = 0, .nargs = 1,
190 .args = { { Int, 0 } } },
191 { .name = "kldstat", .ret_type = 0, .nargs = 2,
192 .args = { { Int, 0 }, { Ptr, 1 } } },
193 { .name = "kldfirstmod", .ret_type = 0, .nargs = 1,
194 .args = { { Int, 0 } } },
195 { .name = "nanosleep", .ret_type = 0, .nargs = 1,
196 .args = { { Timespec, 0 } } },
197 { .name = "select", .ret_type = 1, .nargs = 5,
198 .args = { { Int, 0 }, { Fd_set, 1 }, { Fd_set, 2 }, { Fd_set, 3 }, { Timeval, 4 } } },
199 { .name = "poll", .ret_type = 1, .nargs = 3,
200 .args = { { Pollfd, 0 }, { Int, 1 }, { Int, 2 } } },
201 { .name = "gettimeofday", .ret_type = 1, .nargs = 2,
202 .args = { { Timeval | OUT, 0 }, { Ptr, 1 } } },
203 { .name = "clock_gettime", .ret_type = 1, .nargs = 2,
204 .args = { { Int, 0 }, { Timespec | OUT, 1 } } },
205 { .name = "getitimer", .ret_type = 1, .nargs = 2,
206 .args = { { Int, 0 }, { Itimerval | OUT, 2 } } },
207 { .name = "setitimer", .ret_type = 1, .nargs = 3,
208 .args = { { Int, 0 }, { Itimerval, 1 } , { Itimerval | OUT, 2 } } },
209 { .name = "kse_release", .ret_type = 0, .nargs = 1,
210 .args = { { Timespec, 0 } } },
211 { .name = "kevent", .ret_type = 0, .nargs = 6,
212 .args = { { Int, 0 }, { Kevent, 1 }, { Int, 2 }, { Kevent | OUT, 3 }, { Int, 4 }, { Timespec, 5 } } },
213 { .name = "_umtx_lock", .ret_type = 0, .nargs = 1,
214 .args = { { Umtx, 0 } } },
215 { .name = "_umtx_unlock", .ret_type = 0, .nargs = 1,
216 .args = { { Umtx, 0 } } },
217 { .name = "sigprocmask", .ret_type = 0, .nargs = 3,
218 .args = { { Sigprocmask, 0 }, { Sigset, 1 }, { Sigset | OUT, 2 } } },
219 { .name = "unmount", .ret_type = 1, .nargs = 2,
220 .args = { { Name, 0 }, { Int, 1 } } },
221 { .name = "socket", .ret_type = 1, .nargs = 3,
222 .args = { { Sockdomain, 0 }, { Socktype, 1 }, { Int, 2 } } },
223 { .name = "getrusage", .ret_type = 1, .nargs = 2,
224 .args = { { Int, 0 }, { Rusage | OUT, 1 } } },
225 { .name = "__getcwd", .ret_type = 1, .nargs = 2,
226 .args = { { Name | OUT, 0 }, { Int, 1 } } },
227 { .name = "shutdown", .ret_type = 1, .nargs = 2,
228 .args = { { Int, 0 }, { Shutdown, 1 } } },
229 { .name = "getrlimit", .ret_type = 1, .nargs = 2,
230 .args = { { Resource, 0 }, { Rlimit | OUT, 1 } } },
231 { .name = "setrlimit", .ret_type = 1, .nargs = 2,
232 .args = { { Resource, 0 }, { Rlimit | IN, 1 } } },
233 { .name = "utimes", .ret_type = 1, .nargs = 2,
234 .args = { { Name | IN, 0 }, { Timeval2 | IN, 1 } } },
235 { .name = "lutimes", .ret_type = 1, .nargs = 2,
236 .args = { { Name | IN, 0 }, { Timeval2 | IN, 1 } } },
237 { .name = "futimes", .ret_type = 1, .nargs = 2,
238 .args = { { Int, 0 }, { Timeval | IN, 1 } } },
239 { .name = "chflags", .ret_type = 1, .nargs = 2,
240 .args = { { Name | IN, 0 }, { Hex, 1 } } },
241 { .name = "lchflags", .ret_type = 1, .nargs = 2,
242 .args = { { Name | IN, 0 }, { Hex, 1 } } },
243 { .name = "pathconf", .ret_type = 1, .nargs = 2,
244 .args = { { Name | IN, 0 }, { Pathconf, 1 } } },
245 { .name = "pipe", .ret_type = 1, .nargs = 1,
246 .args = { { Ptr, 0 } } },
247 { .name = "truncate", .ret_type = 1, .nargs = 3,
248 .args = { { Name | IN, 0 }, { Int | IN, 1 }, { Quad | IN, 2 } } },
249 { .name = "ftruncate", .ret_type = 1, .nargs = 3,
250 .args = { { Int | IN, 0 }, { Int | IN, 1 }, { Quad | IN, 2 } } },
251 { .name = "kill", .ret_type = 1, .nargs = 2,
252 .args = { { Int | IN, 0 }, { Signal | IN, 1 } } },
253 { .name = "munmap", .ret_type = 1, .nargs = 2,
254 .args = { { Ptr, 0 }, { Int, 1 } } },
255 { .name = "read", .ret_type = 1, .nargs = 3,
256 .args = { { Int, 0 }, { BinString | OUT, 1 }, { Int, 2 } } },
257 { .name = "rename", .ret_type = 1, .nargs = 2,
258 .args = { { Name , 0 } , { Name, 1 } } },
259 { .name = "symlink", .ret_type = 1, .nargs = 2,
260 .args = { { Name , 0 } , { Name, 1 } } },
261 { .name = "posix_openpt", .ret_type = 1, .nargs = 1,
262 .args = { { Open, 0 } } },
266 /* Xlat idea taken from strace */
272 #define X(a) { a, #a },
273 #define XEND { 0, NULL }
275 static struct xlat kevent_filters[] = {
276 X(EVFILT_READ) X(EVFILT_WRITE) X(EVFILT_AIO) X(EVFILT_VNODE)
277 X(EVFILT_PROC) X(EVFILT_SIGNAL) X(EVFILT_TIMER)
278 X(EVFILT_FS) X(EVFILT_READ) XEND
281 static struct xlat kevent_flags[] = {
282 X(EV_ADD) X(EV_DELETE) X(EV_ENABLE) X(EV_DISABLE) X(EV_ONESHOT)
283 X(EV_CLEAR) X(EV_FLAG1) X(EV_ERROR) X(EV_EOF) XEND
286 struct xlat poll_flags[] = {
287 X(POLLSTANDARD) X(POLLIN) X(POLLPRI) X(POLLOUT) X(POLLERR)
288 X(POLLHUP) X(POLLNVAL) X(POLLRDNORM) X(POLLRDBAND)
289 X(POLLWRBAND) X(POLLINIGNEOF) XEND
292 static struct xlat mmap_flags[] = {
293 X(MAP_SHARED) X(MAP_PRIVATE) X(MAP_FIXED) X(MAP_RENAME)
294 X(MAP_NORESERVE) X(MAP_RESERVED0080) X(MAP_RESERVED0100)
295 X(MAP_HASSEMAPHORE) X(MAP_STACK) X(MAP_NOSYNC) X(MAP_ANON)
299 static struct xlat mprot_flags[] = {
300 X(PROT_NONE) X(PROT_READ) X(PROT_WRITE) X(PROT_EXEC) XEND
303 static struct xlat whence_arg[] = {
304 X(SEEK_SET) X(SEEK_CUR) X(SEEK_END) XEND
307 static struct xlat sigaction_flags[] = {
308 X(SA_ONSTACK) X(SA_RESTART) X(SA_RESETHAND) X(SA_NOCLDSTOP)
309 X(SA_NODEFER) X(SA_NOCLDWAIT) X(SA_SIGINFO) XEND
312 static struct xlat fcntl_arg[] = {
313 X(F_DUPFD) X(F_GETFD) X(F_SETFD) X(F_GETFL) X(F_SETFL)
314 X(F_GETOWN) X(F_SETOWN) X(F_GETLK) X(F_SETLK) X(F_SETLKW) XEND
317 static struct xlat fcntlfd_arg[] = {
321 static struct xlat fcntlfl_arg[] = {
322 X(O_APPEND) X(O_ASYNC) X(O_FSYNC) X(O_NONBLOCK) X(O_NOFOLLOW)
326 static struct xlat sockdomain_arg[] = {
327 X(PF_UNSPEC) X(PF_LOCAL) X(PF_UNIX) X(PF_INET) X(PF_IMPLINK)
328 X(PF_PUP) X(PF_CHAOS) X(PF_NETBIOS) X(PF_ISO) X(PF_OSI)
329 X(PF_ECMA) X(PF_DATAKIT) X(PF_CCITT) X(PF_SNA) X(PF_DECnet)
330 X(PF_DLI) X(PF_LAT) X(PF_HYLINK) X(PF_APPLETALK) X(PF_ROUTE)
331 X(PF_LINK) X(PF_XTP) X(PF_COIP) X(PF_CNT) X(PF_SIP) X(PF_IPX)
332 X(PF_RTIP) X(PF_PIP) X(PF_ISDN) X(PF_KEY) X(PF_INET6)
333 X(PF_NATM) X(PF_ATM) X(PF_NETGRAPH) X(PF_SLOW) X(PF_SCLUSTER)
334 X(PF_ARP) X(PF_BLUETOOTH) XEND
337 static struct xlat socktype_arg[] = {
338 X(SOCK_STREAM) X(SOCK_DGRAM) X(SOCK_RAW) X(SOCK_RDM)
339 X(SOCK_SEQPACKET) XEND
342 static struct xlat open_flags[] = {
343 X(O_RDONLY) X(O_WRONLY) X(O_RDWR) X(O_ACCMODE) X(O_NONBLOCK)
344 X(O_APPEND) X(O_SHLOCK) X(O_EXLOCK) X(O_ASYNC) X(O_FSYNC)
345 X(O_NOFOLLOW) X(O_CREAT) X(O_TRUNC) X(O_EXCL) X(O_NOCTTY)
349 static struct xlat shutdown_arg[] = {
350 X(SHUT_RD) X(SHUT_WR) X(SHUT_RDWR) XEND
353 static struct xlat resource_arg[] = {
354 X(RLIMIT_CPU) X(RLIMIT_FSIZE) X(RLIMIT_DATA) X(RLIMIT_STACK)
355 X(RLIMIT_CORE) X(RLIMIT_RSS) X(RLIMIT_MEMLOCK) X(RLIMIT_NPROC)
356 X(RLIMIT_NOFILE) X(RLIMIT_SBSIZE) X(RLIMIT_VMEM) XEND
359 static struct xlat pathconf_arg[] = {
360 X(_PC_LINK_MAX) X(_PC_MAX_CANON) X(_PC_MAX_INPUT)
361 X(_PC_NAME_MAX) X(_PC_PATH_MAX) X(_PC_PIPE_BUF)
362 X(_PC_CHOWN_RESTRICTED) X(_PC_NO_TRUNC) X(_PC_VDISABLE)
363 X(_PC_ASYNC_IO) X(_PC_PRIO_IO) X(_PC_SYNC_IO)
364 X(_PC_ALLOC_SIZE_MIN) X(_PC_FILESIZEBITS)
365 X(_PC_REC_INCR_XFER_SIZE) X(_PC_REC_MAX_XFER_SIZE)
366 X(_PC_REC_MIN_XFER_SIZE) X(_PC_REC_XFER_ALIGN)
367 X(_PC_SYMLINK_MAX) X(_PC_ACL_EXTENDED) X(_PC_ACL_PATH_MAX)
368 X(_PC_CAP_PRESENT) X(_PC_INF_PRESENT) X(_PC_MAC_PRESENT)
376 * Searches an xlat array for a value, and returns it if found. Otherwise
377 * return a string representation.
380 lookup(struct xlat *xlat, int val, int base)
384 for (; xlat->str != NULL; xlat++)
385 if (xlat->val == val)
389 sprintf(tmp, "0%o", val);
392 sprintf(tmp, "0x%x", val);
395 sprintf(tmp, "%u", val);
398 errx(1,"Unknown lookup base");
405 xlookup(struct xlat *xlat, int val)
408 return (lookup(xlat, val, 16));
411 /* Searches an xlat array containing bitfield values. Remaining bits
412 set after removing the known ones are printed at the end:
415 xlookup_bits(struct xlat *xlat, int val)
417 static char str[512];
421 for (; xlat->str != NULL; xlat++) {
422 if ((xlat->val & rem) == xlat->val) {
423 /* don't print the "all-bits-zero" string unless all
424 bits are really zero */
425 if (xlat->val == 0 && val != 0)
427 len += sprintf(str + len, "%s|", xlat->str);
431 /* if we have leftover bits or didn't match anything */
433 len += sprintf(str + len, "0x%x", rem);
434 if (len && str[len - 1] == '|')
441 * If/when the list gets big, it might be desirable to do it
442 * as a hash table or binary search.
446 get_syscall(const char *name)
448 struct syscall *sc = syscalls;
453 if (!strcmp(name, sc->name))
463 * Copy a fixed amount of bytes from the process.
467 get_struct(int pid, void *offset, void *buf, int len)
469 struct ptrace_io_desc iorequest;
471 iorequest.piod_op = PIOD_READ_D;
472 iorequest.piod_offs = offset;
473 iorequest.piod_addr = buf;
474 iorequest.piod_len = len;
475 if (ptrace(PT_IO, pid, (caddr_t)&iorequest, 0) < 0)
481 #define BLOCKSIZE 1024
484 * Copy a string from the process. Note that it is
485 * expected to be a C string, but if max is set, it will
486 * only get that much.
490 get_string(pid_t pid, void *offset, int max)
493 struct ptrace_io_desc iorequest;
498 totalsize = size = max ? (max + 1) : BLOCKSIZE;
499 buf = malloc(totalsize);
503 diff = totalsize - size;
504 iorequest.piod_op = PIOD_READ_D;
505 iorequest.piod_offs = (char *)offset + diff;
506 iorequest.piod_addr = buf + diff;
507 iorequest.piod_len = size;
508 if (ptrace(PT_IO, pid, (caddr_t)&iorequest, 0) < 0) {
512 for (i = 0 ; i < size; i++) {
513 if (buf[diff + i] == '\0')
516 if (totalsize < MAXSIZE - BLOCKSIZE && max == 0) {
517 totalsize += BLOCKSIZE;
518 buf = realloc(buf, totalsize);
521 buf[totalsize - 1] = '\0';
530 * Converts a syscall argument into a string. Said string is
531 * allocated via malloc(), so needs to be free()'d. The file
532 * descriptor is for the process' memory (via /proc), and is used
533 * to get any data (where the argument is a pointer). sc is
534 * a pointer to the syscall description (see above); args is
535 * an array of all of the system call arguments.
539 print_arg(struct syscall_args *sc, unsigned long *args, long retval, struct trussinfo *trussinfo)
542 int pid = trussinfo->pid;
544 switch (sc->type & ARG_MASK) {
546 asprintf(&tmp, "0x%x", (int)args[sc->offset]);
549 asprintf(&tmp, "0%o", (int)args[sc->offset]);
552 asprintf(&tmp, "%d", (int)args[sc->offset]);
555 /* NULL-terminated string. */
557 tmp2 = get_string(pid, (void*)args[sc->offset], 0);
558 asprintf(&tmp, "\"%s\"", tmp2);
563 /* Binary block of data that might have printable characters.
564 XXX If type|OUT, assume that the length is the syscall's
565 return value. Otherwise, assume that the length of the block
566 is in the next syscall argument. */
567 int max_string = trussinfo->strsize;
568 char tmp2[max_string+1], *tmp3;
575 len = args[sc->offset + 1];
577 /* Don't print more than max_string characters, to avoid word
578 wrap. If we have to truncate put some ... after the string.
580 if (len > max_string) {
584 if (len && get_struct(pid, (void*)args[sc->offset], &tmp2, len) != -1) {
585 tmp3 = malloc(len * 4 + 1);
587 if (strvisx(tmp3, tmp2, len, VIS_CSTYLE|VIS_TAB|VIS_NL) <= max_string)
592 asprintf(&tmp, "\"%s\"%s", tmp3, truncated?"...":"");
595 asprintf(&tmp, "0x%lx", args[sc->offset]);
603 char *strarray[100]; /* XXX This is ugly. */
605 if (get_struct(pid, (void *)args[sc->offset], (void *)&strarray,
606 sizeof(strarray)) == -1) {
607 err(1, "get_struct %p", (void *)args[sc->offset]);
612 /* Find out how large of a buffer we'll need. */
613 while (strarray[num] != NULL) {
614 string = get_string(pid, (void*)strarray[num], 0);
615 size += strlen(string);
619 size += 4 + (num * 4);
620 tmp = (char *)malloc(size);
623 tmp2 += sprintf(tmp2, " [");
624 for (i = 0; i < num; i++) {
625 string = get_string(pid, (void*)strarray[i], 0);
626 tmp2 += sprintf(tmp2, " \"%s\"%c", string, (i+1 == num) ? ' ' : ',');
629 tmp2 += sprintf(tmp2, "]");
634 asprintf(&tmp, "0x%lx", args[sc->offset]);
638 unsigned long long ll;
639 ll = *(unsigned long long *)(args + sc->offset);
640 asprintf(&tmp, "0x%llx", ll);
645 asprintf(&tmp, "0x%lx", args[sc->offset]);
653 tmp2 = get_string(pid, (void*)args[sc->offset], retval);
654 asprintf(&tmp, "\"%s\"", tmp2);
659 const char *temp = ioctlname(args[sc->offset]);
663 unsigned long arg = args[sc->offset];
664 asprintf(&tmp, "0x%lx { IO%s%s 0x%lx('%c'), %lu, %lu }", arg,
665 arg&IOC_OUT?"R":"", arg&IOC_IN?"W":"",
666 IOCGROUP(arg), isprint(IOCGROUP(arg))?(char)IOCGROUP(arg):'?',
667 arg & 0xFF, IOCPARM_LEN(arg));
673 if (get_struct(pid, (void *)args[sc->offset], &umtx, sizeof(umtx)) != -1)
674 asprintf(&tmp, "{ 0x%lx }", (long)umtx.u_owner);
676 asprintf(&tmp, "0x%lx", args[sc->offset]);
681 if (get_struct(pid, (void *)args[sc->offset], &ts, sizeof(ts)) != -1)
682 asprintf(&tmp, "{%ld.%09ld }", (long)ts.tv_sec, ts.tv_nsec);
684 asprintf(&tmp, "0x%lx", args[sc->offset]);
689 if (get_struct(pid, (void *)args[sc->offset], &tv, sizeof(tv)) != -1)
690 asprintf(&tmp, "{%ld.%06ld }", (long)tv.tv_sec, tv.tv_usec);
692 asprintf(&tmp, "0x%lx", args[sc->offset]);
696 struct timeval tv[2];
697 if (get_struct(pid, (void *)args[sc->offset], &tv, sizeof(tv)) != -1)
698 asprintf(&tmp, "{%ld.%06ld, %ld.%06ld }",
699 (long)tv[0].tv_sec, tv[0].tv_usec,
700 (long)tv[1].tv_sec, tv[1].tv_usec);
702 asprintf(&tmp, "0x%lx", args[sc->offset]);
706 struct itimerval itv;
707 if (get_struct(pid, (void *)args[sc->offset], &itv, sizeof(itv)) != -1)
708 asprintf(&tmp, "{%ld.%06ld, %ld.%06ld }",
709 (long)itv.it_interval.tv_sec,
710 itv.it_interval.tv_usec,
711 (long)itv.it_value.tv_sec,
712 itv.it_value.tv_usec);
714 asprintf(&tmp, "0x%lx", args[sc->offset]);
719 * XXX: A Pollfd argument expects the /next/ syscall argument to be
720 * the number of fds in the array. This matches the poll syscall.
723 int numfds = args[sc->offset+1];
724 int bytes = sizeof(struct pollfd) * numfds;
725 int i, tmpsize, u, used;
726 const int per_fd = 100;
728 if ((pfd = malloc(bytes)) == NULL)
729 err(1, "Cannot malloc %d bytes for pollfd array", bytes);
730 if (get_struct(pid, (void *)args[sc->offset], pfd, bytes) != -1) {
733 tmpsize = 1 + per_fd * numfds + 2;
734 if ((tmp = malloc(tmpsize)) == NULL)
735 err(1, "Cannot alloc %d bytes for poll output", tmpsize);
738 for (i = 0; i < numfds; i++) {
740 u = snprintf(tmp + used, per_fd,
744 xlookup_bits(poll_flags, pfd[i].events) );
746 used += u < per_fd ? u : per_fd;
751 asprintf(&tmp, "0x%lx", args[sc->offset]);
758 * XXX: A Fd_set argument expects the /first/ syscall argument to be
759 * the number of fds in the array. This matches the select syscall.
762 int numfds = args[0];
763 int bytes = _howmany(numfds, _NFDBITS) * _NFDBITS;
764 int i, tmpsize, u, used;
765 const int per_fd = 20;
767 if ((fds = malloc(bytes)) == NULL)
768 err(1, "Cannot malloc %d bytes for fd_set array", bytes);
769 if (get_struct(pid, (void *)args[sc->offset], fds, bytes) != -1) {
771 tmpsize = 1 + numfds * per_fd + 2;
772 if ((tmp = malloc(tmpsize)) == NULL)
773 err(1, "Cannot alloc %d bytes for fd_set output", tmpsize);
776 for (i = 0; i < numfds; i++) {
777 if (FD_ISSET(i, fds)) {
778 u = snprintf(tmp + used, per_fd, "%d ", i);
780 used += u < per_fd ? u : per_fd;
783 if (tmp[used-1] == ' ')
788 asprintf(&tmp, "0x%lx", args[sc->offset]);
796 sig = args[sc->offset];
799 asprintf(&tmp, "%ld", sig);
807 sig = args[sc->offset];
808 if (get_struct(pid, (void *)args[sc->offset], (void *)&ss, sizeof(ss)) == -1) {
809 asprintf(&tmp, "0x%lx", args[sc->offset]);
812 tmp = malloc(sys_nsig * 8); /* 7 bytes avg per signal name */
814 for (i = 1; i < sys_nsig; i++) {
815 if (sigismember(&ss, i)) {
816 used += sprintf(tmp + used, "%s|", strsig(i));
826 switch (args[sc->offset]) {
827 #define S(a) case a: tmp = strdup(#a); break;
834 asprintf(&tmp, "0x%lx", args[sc->offset]);
838 /* XXX output depends on the value of the previous argument */
839 switch (args[sc->offset-1]) {
841 tmp = strdup(xlookup_bits(fcntlfd_arg, args[sc->offset]));
844 tmp = strdup(xlookup_bits(fcntlfl_arg, args[sc->offset]));
852 asprintf(&tmp, "0x%lx", args[sc->offset]);
858 tmp = strdup(xlookup_bits(open_flags, args[sc->offset]));
861 tmp = strdup(xlookup(fcntl_arg, args[sc->offset]));
864 tmp = strdup(xlookup_bits(mprot_flags, args[sc->offset]));
867 tmp = strdup(xlookup_bits(mmap_flags, args[sc->offset]));
870 tmp = strdup(xlookup(whence_arg, args[sc->offset]));
873 tmp = strdup(xlookup(sockdomain_arg, args[sc->offset]));
876 tmp = strdup(xlookup(socktype_arg, args[sc->offset]));
879 tmp = strdup(xlookup(shutdown_arg, args[sc->offset]));
882 tmp = strdup(xlookup(resource_arg, args[sc->offset]));
885 tmp = strdup(xlookup(pathconf_arg, args[sc->offset]));
888 struct sockaddr_storage ss;
890 struct sockaddr_in *lsin;
891 struct sockaddr_in6 *lsin6;
892 struct sockaddr_un *sun;
898 if (args[sc->offset] == 0) {
899 asprintf(&tmp, "NULL");
903 /* yuck: get ss_len */
904 if (get_struct(pid, (void *)args[sc->offset], (void *)&ss,
905 sizeof(ss.ss_len) + sizeof(ss.ss_family)) == -1)
906 err(1, "get_struct %p", (void *)args[sc->offset]);
908 * If ss_len is 0, then try to guess from the sockaddr type.
909 * AF_UNIX may be initialized incorrectly, so always frob
910 * it by using the "right" size.
912 if (ss.ss_len == 0 || ss.ss_family == AF_UNIX) {
913 switch (ss.ss_family) {
915 ss.ss_len = sizeof(*lsin);
918 ss.ss_len = sizeof(*sun);
925 if (get_struct(pid, (void *)args[sc->offset], (void *)&ss, ss.ss_len)
927 err(2, "get_struct %p", (void *)args[sc->offset]);
930 switch (ss.ss_family) {
932 lsin = (struct sockaddr_in *)&ss;
933 inet_ntop(AF_INET, &lsin->sin_addr, addr, sizeof addr);
934 asprintf(&tmp, "{ AF_INET %s:%d }", addr, htons(lsin->sin_port));
937 lsin6 = (struct sockaddr_in6 *)&ss;
938 inet_ntop(AF_INET6, &lsin6->sin6_addr, addr, sizeof addr);
939 asprintf(&tmp, "{ AF_INET6 [%s]:%d }", addr, htons(lsin6->sin6_port));
942 sun = (struct sockaddr_un *)&ss;
943 asprintf(&tmp, "{ AF_UNIX \"%s\" }", sun->sun_path);
946 sa = (struct sockaddr *)&ss;
947 asprintf(&tmp, "{ sa_len = %d, sa_family = %d, sa_data = {%n%*s } }",
948 (int)sa->sa_len, (int)sa->sa_family, &i,
949 6 * (int)(sa->sa_len - ((char *)&sa->sa_data - (char *)sa)), "");
952 for (q = (u_char *)&sa->sa_data; q < (u_char *)sa + sa->sa_len; q++)
953 p += sprintf(p, " %#02x,", *q);
963 if (get_struct(pid, (void *)args[sc->offset], &sa, sizeof(sa)) != -1) {
965 asprintf(&hand, "%p", sa.sa_handler);
966 if (sa.sa_handler == SIG_DFL)
968 else if (sa.sa_handler == SIG_IGN)
973 asprintf(&tmp, "{ %s %s ss_t }",
975 xlookup_bits(sigaction_flags, sa.sa_flags));
978 asprintf(&tmp, "0x%lx", args[sc->offset]);
984 * XXX XXX: the size of the array is determined by either the
985 * next syscall argument, or by the syscall returnvalue,
986 * depending on which argument number we are. This matches the
987 * kevent syscall, but luckily that's the only syscall that uses
993 int i, tmpsize, u, used;
994 const int per_ke = 100;
997 numevents = args[sc->offset+1];
998 else if (sc->offset == 3 && retval != -1)
1002 bytes = sizeof(struct kevent) * numevents;
1003 if ((ke = malloc(bytes)) == NULL)
1004 err(1, "Cannot malloc %d bytes for kevent array", bytes);
1005 if (numevents >= 0 && get_struct(pid, (void *)args[sc->offset], ke, bytes) != -1) {
1007 tmpsize = 1 + per_ke * numevents + 2;
1008 if ((tmp = malloc(tmpsize)) == NULL)
1009 err(1, "Cannot alloc %d bytes for kevent output", tmpsize);
1012 for (i = 0; i < numevents; i++) {
1013 u = snprintf(tmp + used, per_ke,
1014 "%s%p,%s,%s,%d,%p,%p",
1016 (void *)ke[i].ident,
1017 xlookup(kevent_filters, ke[i].filter),
1018 xlookup_bits(kevent_flags, ke[i].flags),
1021 (void *)ke[i].udata);
1023 used += u < per_ke ? u : per_ke;
1028 asprintf(&tmp, "0x%lx", args[sc->offset]);
1035 if (get_struct(pid, (void *)args[sc->offset], &st, sizeof(st)) != -1) {
1037 strmode(st.st_mode, mode);
1038 asprintf(&tmp, "{ mode=%s,inode=%jd,size=%jd,blksize=%ld }",
1040 (intmax_t)st.st_ino,(intmax_t)st.st_size,(long)st.st_blksize);
1042 asprintf(&tmp, "0x%lx", args[sc->offset]);
1048 if (get_struct(pid, (void *)args[sc->offset], &ru, sizeof(ru)) != -1) {
1049 asprintf(&tmp, "{ u=%ld.%06ld,s=%ld.%06ld,in=%ld,out=%ld }",
1050 (long)ru.ru_utime.tv_sec, ru.ru_utime.tv_usec,
1051 (long)ru.ru_stime.tv_sec, ru.ru_stime.tv_usec,
1052 ru.ru_inblock, ru.ru_oublock);
1054 asprintf(&tmp, "0x%lx", args[sc->offset]);
1060 if (get_struct(pid, (void *)args[sc->offset], &rl, sizeof(rl)) != -1) {
1061 asprintf(&tmp, "{ cur=%ju,max=%ju }",
1062 rl.rlim_cur, rl.rlim_max);
1064 asprintf(&tmp, "0x%lx", args[sc->offset]);
1069 errx(1, "Invalid argument type %d\n", sc->type & ARG_MASK);
1076 * Print (to outfile) the system call and its arguments. Note that
1077 * nargs is the number of arguments (not the number of words; this is
1078 * potentially confusing, I know).
1082 print_syscall(struct trussinfo *trussinfo, const char *name, int nargs, char **s_args)
1086 struct timespec timediff;
1088 if (trussinfo->flags & FOLLOWFORKS)
1089 len += fprintf(trussinfo->outfile, "%5d: ", trussinfo->pid);
1091 if (name != NULL && (!strcmp(name, "execve") || !strcmp(name, "exit"))) {
1092 clock_gettime(CLOCK_REALTIME, &trussinfo->after);
1095 if (trussinfo->flags & ABSOLUTETIMESTAMPS) {
1096 timespecsubt(&trussinfo->after, &trussinfo->start_time, &timediff);
1097 len += fprintf(trussinfo->outfile, "%ld.%09ld ",
1098 (long)timediff.tv_sec, timediff.tv_nsec);
1101 if (trussinfo->flags & RELATIVETIMESTAMPS) {
1102 timespecsubt(&trussinfo->after, &trussinfo->before, &timediff);
1103 len += fprintf(trussinfo->outfile, "%ld.%09ld ",
1104 (long)timediff.tv_sec, timediff.tv_nsec);
1107 len += fprintf(trussinfo->outfile, "%s(", name);
1109 for (i = 0; i < nargs; i++) {
1111 len += fprintf(trussinfo->outfile, "%s", s_args[i]);
1113 len += fprintf(trussinfo->outfile, "<missing argument>");
1114 len += fprintf(trussinfo->outfile, "%s", i < (nargs - 1) ? "," : "");
1116 len += fprintf(trussinfo->outfile, ")");
1117 for (i = 0; i < 6 - (len / 8); i++)
1118 fprintf(trussinfo->outfile, "\t");
1122 print_syscall_ret(struct trussinfo *trussinfo, const char *name, int nargs,
1123 char **s_args, int errorp, long retval, struct syscall *sc)
1125 struct timespec timediff;
1127 if (trussinfo->flags & COUNTONLY) {
1130 clock_gettime(CLOCK_REALTIME, &trussinfo->after);
1131 timespecsubt(&trussinfo->after, &trussinfo->before, &timediff);
1132 timespecadd(&sc->time, &timediff, &sc->time);
1139 print_syscall(trussinfo, name, nargs, s_args);
1140 fflush(trussinfo->outfile);
1142 fprintf(trussinfo->outfile, " ERR#%ld '%s'\n", retval, strerror(retval));
1145 * Because pipe(2) has a special assembly glue to provide the
1146 * libc API, we have to adjust retval.
1148 if (name != NULL && !strcmp(name, "pipe"))
1150 fprintf(trussinfo->outfile, " = %ld (0x%lx)\n", retval, retval);
1155 print_summary(struct trussinfo *trussinfo)
1158 struct timespec total = {0, 0};
1161 fprintf(trussinfo->outfile, "%-20s%15s%8s%8s\n",
1162 "syscall", "seconds", "calls", "errors");
1164 for (sc = syscalls; sc->name != NULL; sc++)
1166 fprintf(trussinfo->outfile, "%-20s%5jd.%09ld%8d%8d\n",
1167 sc->name, (intmax_t)sc->time.tv_sec,
1168 sc->time.tv_nsec, sc->ncalls, sc->nerror);
1169 timespecadd(&total, &sc->time, &total);
1170 ncall += sc->ncalls;
1171 nerror += sc->nerror;
1173 fprintf(trussinfo->outfile, "%20s%15s%8s%8s\n",
1174 "", "-------------", "-------", "-------");
1175 fprintf(trussinfo->outfile, "%-20s%5jd.%09ld%8d%8d\n",
1176 "", (intmax_t)total.tv_sec, total.tv_nsec, ncall, nerror);