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 * Copyright (c) 1996-1999 Wichert Akkerman <wichert@cistron.nl>
6 * Copyright (c) 1999 IBM Deutschland Entwicklung GmbH, IBM Corporation
7 * Linux for s390 port by D.J. Barrow
8 * <barrow_dj@mail.yahoo.com,djbarrow@de.ibm.com>
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 * 3. The name of the author may not be used to endorse or promote products
20 * derived from this software without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
35 #include <sys/param.h>
37 /* for struct iovec */
44 # undef PTRACE_GETREGS
45 # define PTRACE_GETREGS PTRACE_GETREGS64
46 # undef PTRACE_SETREGS
47 # define PTRACE_SETREGS PTRACE_SETREGS64
51 # include <asm/psrcompat.h>
61 # define NT_PRSTATUS 1
65 # warning: NSIG is not defined, using 32
71 /* Define these shorthand notations to simplify the syscallent files. */
75 #define TN TRACE_NETWORK
76 #define TP TRACE_PROCESS
77 #define TS TRACE_SIGNAL
78 #define TM TRACE_MEMORY
79 #define NF SYSCALL_NEVER_FAILS
81 #define SI STACKTRACE_INVALIDATE_CACHE
82 #define SE STACKTRACE_CAPTURE_ON_ENTER
84 const struct_sysent sysent0[] = {
85 #include "syscallent.h"
88 #if SUPPORTED_PERSONALITIES > 1
89 static const struct_sysent sysent1[] = {
90 # include "syscallent1.h"
94 #if SUPPORTED_PERSONALITIES > 2
95 static const struct_sysent sysent2[] = {
96 # include "syscallent2.h"
100 /* Now undef them since short defines cause wicked namespace pollution. */
114 * `ioctlent[012].h' files are automatically generated by the auxiliary
115 * program `ioctlsort', such that the list is sorted by the `code' field.
116 * This has the side-effect of resolving the _IO.. macros into
117 * plain integers, eliminating the need to include here everything
121 const char *const errnoent0[] = {
122 #include "errnoent.h"
124 const char *const signalent0[] = {
125 #include "signalent.h"
127 const struct_ioctlent ioctlent0[] = {
128 #include "ioctlent0.h"
131 #if SUPPORTED_PERSONALITIES > 1
132 static const char *const errnoent1[] = {
133 # include "errnoent1.h"
135 static const char *const signalent1[] = {
136 # include "signalent1.h"
138 static const struct_ioctlent ioctlent1[] = {
139 # include "ioctlent1.h"
143 #if SUPPORTED_PERSONALITIES > 2
144 static const char *const errnoent2[] = {
145 # include "errnoent2.h"
147 static const char *const signalent2[] = {
148 # include "signalent2.h"
150 static const struct_ioctlent ioctlent2[] = {
151 # include "ioctlent2.h"
156 nsyscalls0 = ARRAY_SIZE(sysent0)
157 #if SUPPORTED_PERSONALITIES > 1
158 , nsyscalls1 = ARRAY_SIZE(sysent1)
159 # if SUPPORTED_PERSONALITIES > 2
160 , nsyscalls2 = ARRAY_SIZE(sysent2)
166 nerrnos0 = ARRAY_SIZE(errnoent0)
167 #if SUPPORTED_PERSONALITIES > 1
168 , nerrnos1 = ARRAY_SIZE(errnoent1)
169 # if SUPPORTED_PERSONALITIES > 2
170 , nerrnos2 = ARRAY_SIZE(errnoent2)
176 nsignals0 = ARRAY_SIZE(signalent0)
177 #if SUPPORTED_PERSONALITIES > 1
178 , nsignals1 = ARRAY_SIZE(signalent1)
179 # if SUPPORTED_PERSONALITIES > 2
180 , nsignals2 = ARRAY_SIZE(signalent2)
186 nioctlents0 = ARRAY_SIZE(ioctlent0)
187 #if SUPPORTED_PERSONALITIES > 1
188 , nioctlents1 = ARRAY_SIZE(ioctlent1)
189 # if SUPPORTED_PERSONALITIES > 2
190 , nioctlents2 = ARRAY_SIZE(ioctlent2)
195 #if SUPPORTED_PERSONALITIES > 1
196 const struct_sysent *sysent = sysent0;
197 const char *const *errnoent = errnoent0;
198 const char *const *signalent = signalent0;
199 const struct_ioctlent *ioctlent = ioctlent0;
201 unsigned nsyscalls = nsyscalls0;
202 unsigned nerrnos = nerrnos0;
203 unsigned nsignals = nsignals0;
204 unsigned nioctlents = nioctlents0;
207 qualbits_t *qual_vec[SUPPORTED_PERSONALITIES];
209 static const unsigned nsyscall_vec[SUPPORTED_PERSONALITIES] = {
211 #if SUPPORTED_PERSONALITIES > 1
214 #if SUPPORTED_PERSONALITIES > 2
218 static const struct_sysent *const sysent_vec[SUPPORTED_PERSONALITIES] = {
220 #if SUPPORTED_PERSONALITIES > 1
223 #if SUPPORTED_PERSONALITIES > 2
229 MAX_NSYSCALLS1 = (nsyscalls0
230 #if SUPPORTED_PERSONALITIES > 1
231 > nsyscalls1 ? nsyscalls0 : nsyscalls1
234 MAX_NSYSCALLS2 = (MAX_NSYSCALLS1
235 #if SUPPORTED_PERSONALITIES > 2
236 > nsyscalls2 ? MAX_NSYSCALLS1 : nsyscalls2
239 MAX_NSYSCALLS = MAX_NSYSCALLS2,
240 /* We are ready for arches with up to 255 signals,
241 * even though the largest known signo is on MIPS and it is 128.
242 * The number of existing syscalls on all arches is
243 * larger that 255 anyway, so it is just a pedantic matter.
245 MIN_QUALS = MAX_NSYSCALLS > 255 ? MAX_NSYSCALLS : 255
248 #if SUPPORTED_PERSONALITIES > 1
249 unsigned current_personality;
251 # ifndef current_wordsize
252 unsigned current_wordsize;
253 static const int personality_wordsize[SUPPORTED_PERSONALITIES] = {
254 PERSONALITY0_WORDSIZE,
255 PERSONALITY1_WORDSIZE,
256 # if SUPPORTED_PERSONALITIES > 2
257 PERSONALITY2_WORDSIZE,
263 set_personality(int personality)
265 nsyscalls = nsyscall_vec[personality];
266 sysent = sysent_vec[personality];
268 switch (personality) {
270 errnoent = errnoent0;
272 ioctlent = ioctlent0;
273 nioctlents = nioctlents0;
274 signalent = signalent0;
275 nsignals = nsignals0;
279 errnoent = errnoent1;
281 ioctlent = ioctlent1;
282 nioctlents = nioctlents1;
283 signalent = signalent1;
284 nsignals = nsignals1;
287 # if SUPPORTED_PERSONALITIES > 2
289 errnoent = errnoent2;
291 ioctlent = ioctlent2;
292 nioctlents = nioctlents2;
293 signalent = signalent2;
294 nsignals = nsignals2;
299 current_personality = personality;
300 # ifndef current_wordsize
301 current_wordsize = personality_wordsize[personality];
306 update_personality(struct tcb *tcp, unsigned int personality)
308 if (personality == current_personality)
310 set_personality(personality);
312 if (personality == tcp->currpers)
314 tcp->currpers = personality;
316 # if defined(POWERPC64)
318 static const char *const names[] = {"64 bit", "32 bit"};
319 fprintf(stderr, "[ Process PID=%d runs in %s mode. ]\n",
320 tcp->pid, names[personality]);
322 # elif defined(X86_64)
324 static const char *const names[] = {"64 bit", "32 bit", "x32"};
325 fprintf(stderr, "[ Process PID=%d runs in %s mode. ]\n",
326 tcp->pid, names[personality]);
330 static const char *const names[] = {"x32", "32 bit"};
331 fprintf(stderr, "[ Process PID=%d runs in %s mode. ]\n",
332 tcp->pid, names[personality]);
334 # elif defined(AARCH64)
336 static const char *const names[] = {"32-bit", "AArch64"};
337 fprintf(stderr, "[ Process PID=%d runs in %s mode. ]\n",
338 tcp->pid, names[personality]);
342 static const char *const names[] = {"64-bit", "32-bit"};
343 fprintf(stderr, "[ Process PID=%d runs in %s mode. ]\n",
344 tcp->pid, names[personality]);
350 static int qual_syscall(), qual_signal(), qual_desc();
352 static const struct qual_options {
353 unsigned int bitflag;
354 const char *option_name;
355 int (*qualify)(const char *, int, int);
356 const char *argument_name;
358 { QUAL_TRACE, "trace", qual_syscall, "system call" },
359 { QUAL_TRACE, "t", qual_syscall, "system call" },
360 { QUAL_ABBREV, "abbrev", qual_syscall, "system call" },
361 { QUAL_ABBREV, "a", qual_syscall, "system call" },
362 { QUAL_VERBOSE, "verbose", qual_syscall, "system call" },
363 { QUAL_VERBOSE, "v", qual_syscall, "system call" },
364 { QUAL_RAW, "raw", qual_syscall, "system call" },
365 { QUAL_RAW, "x", qual_syscall, "system call" },
366 { QUAL_SIGNAL, "signal", qual_signal, "signal" },
367 { QUAL_SIGNAL, "signals", qual_signal, "signal" },
368 { QUAL_SIGNAL, "s", qual_signal, "signal" },
369 { QUAL_READ, "read", qual_desc, "descriptor" },
370 { QUAL_READ, "reads", qual_desc, "descriptor" },
371 { QUAL_READ, "r", qual_desc, "descriptor" },
372 { QUAL_WRITE, "write", qual_desc, "descriptor" },
373 { QUAL_WRITE, "writes", qual_desc, "descriptor" },
374 { QUAL_WRITE, "w", qual_desc, "descriptor" },
375 { 0, NULL, NULL, NULL },
379 reallocate_qual(const unsigned int n)
383 for (p = 0; p < SUPPORTED_PERSONALITIES; p++) {
384 qp = qual_vec[p] = realloc(qual_vec[p], n * sizeof(qualbits_t));
387 memset(&qp[num_quals], 0, (n - num_quals) * sizeof(qualbits_t));
393 qualify_one(const unsigned int n, unsigned int bitflag, const int not, const int pers)
398 reallocate_qual(n + 1);
400 for (p = 0; p < SUPPORTED_PERSONALITIES; p++) {
401 if (pers == p || pers < 0) {
403 qual_vec[p][n] &= ~bitflag;
405 qual_vec[p][n] |= bitflag;
411 qual_syscall(const char *s, const unsigned int bitflag, const int not)
417 if (*s >= '0' && *s <= '9') {
418 i = string_to_uint(s);
419 if (i >= MAX_NSYSCALLS)
421 qualify_one(i, bitflag, not, -1);
425 for (p = 0; p < SUPPORTED_PERSONALITIES; p++) {
426 for (i = 0; i < nsyscall_vec[p]; i++) {
427 if (sysent_vec[p][i].sys_name
428 && strcmp(s, sysent_vec[p][i].sys_name) == 0
430 qualify_one(i, bitflag, not, p);
440 qual_signal(const char *s, const unsigned int bitflag, const int not)
444 if (*s >= '0' && *s <= '9') {
445 int signo = string_to_uint(s);
446 if (signo < 0 || signo > 255)
448 qualify_one(signo, bitflag, not, -1);
451 if (strncasecmp(s, "SIG", 3) == 0)
453 for (i = 0; i <= NSIG; i++) {
454 if (strcasecmp(s, signame(i) + 3) == 0) {
455 qualify_one(i, bitflag, not, -1);
463 qual_desc(const char *s, const unsigned int bitflag, const int not)
465 if (*s >= '0' && *s <= '9') {
466 int desc = string_to_uint(s);
467 if (desc < 0 || desc > 0x7fff) /* paranoia */
469 qualify_one(desc, bitflag, not, -1);
476 lookup_class(const char *s)
478 if (strcmp(s, "file") == 0)
480 if (strcmp(s, "ipc") == 0)
482 if (strcmp(s, "network") == 0)
483 return TRACE_NETWORK;
484 if (strcmp(s, "process") == 0)
485 return TRACE_PROCESS;
486 if (strcmp(s, "signal") == 0)
488 if (strcmp(s, "desc") == 0)
490 if (strcmp(s, "memory") == 0)
496 qualify(const char *s)
498 const struct qual_options *opt;
505 reallocate_qual(MIN_QUALS);
507 opt = &qual_options[0];
508 for (i = 0; (p = qual_options[i].option_name); i++) {
509 unsigned int len = strlen(p);
510 if (strncmp(s, p, len) == 0 && s[len] == '=') {
511 opt = &qual_options[i];
521 if (strcmp(s, "none") == 0) {
525 if (strcmp(s, "all") == 0) {
526 for (i = 0; i < num_quals; i++) {
527 qualify_one(i, opt->bitflag, not, -1);
531 for (i = 0; i < num_quals; i++) {
532 qualify_one(i, opt->bitflag, !not, -1);
537 for (p = strtok(copy, ","); p; p = strtok(NULL, ",")) {
539 if (opt->bitflag == QUAL_TRACE && (n = lookup_class(p)) > 0) {
541 for (pers = 0; pers < SUPPORTED_PERSONALITIES; pers++) {
542 for (i = 0; i < nsyscall_vec[pers]; i++)
543 if (sysent_vec[pers][i].sys_flags & n)
544 qualify_one(i, opt->bitflag, not, pers);
548 if (opt->qualify(p, opt->bitflag, not)) {
549 error_msg_and_die("invalid %s '%s'",
550 opt->argument_name, p);
557 #ifdef SYS_socket_subcall
559 decode_socket_subcall(struct tcb *tcp)
564 if (tcp->u_arg[0] < 0 || tcp->u_arg[0] >= SYS_socket_nsubcalls)
567 tcp->scno = SYS_socket_subcall + tcp->u_arg[0];
568 tcp->qual_flg = qual_flags[tcp->scno];
569 tcp->s_ent = &sysent[tcp->scno];
570 addr = tcp->u_arg[1];
571 n = tcp->s_ent->nargs;
572 if (sizeof(tcp->u_arg[0]) == current_wordsize) {
573 memset(tcp->u_arg, 0, n * sizeof(tcp->u_arg[0]));
574 (void) umoven(tcp, addr, n * sizeof(tcp->u_arg[0]), tcp->u_arg);
576 unsigned int args[n];
579 memset(args, 0, sizeof(args));
580 (void) umove(tcp, addr, &args);
581 for (i = 0; i < n; ++i)
582 tcp->u_arg[i] = args[i];
587 #ifdef SYS_ipc_subcall
589 decode_ipc_subcall(struct tcb *tcp)
593 if (tcp->u_arg[0] < 0 || tcp->u_arg[0] >= SYS_ipc_nsubcalls)
596 tcp->scno = SYS_ipc_subcall + tcp->u_arg[0];
597 tcp->qual_flg = qual_flags[tcp->scno];
598 tcp->s_ent = &sysent[tcp->scno];
599 n = tcp->s_ent->nargs;
600 for (i = 0; i < n; i++)
601 tcp->u_arg[i] = tcp->u_arg[i + 1];
607 decode_mips_subcall(struct tcb *tcp)
609 if (!SCNO_IS_VALID(tcp->u_arg[0]))
611 tcp->scno = tcp->u_arg[0];
612 tcp->qual_flg = qual_flags[tcp->scno];
613 tcp->s_ent = &sysent[tcp->scno];
614 memmove(&tcp->u_arg[0], &tcp->u_arg[1],
615 sizeof(tcp->u_arg) - sizeof(tcp->u_arg[0]));
617 * Fetching the last arg of 7-arg syscalls (fadvise64_64
618 * and sync_file_range) would require additional code,
619 * see linux/mips/get_syscall_args.c
625 return printargs(tcp);
630 printargs(struct tcb *tcp)
634 int n = tcp->s_ent->nargs;
635 for (i = 0; i < n; i++)
636 tprintf("%s%#lx", i ? ", " : "", tcp->u_arg[i]);
642 printargs_lu(struct tcb *tcp)
646 int n = tcp->s_ent->nargs;
647 for (i = 0; i < n; i++)
648 tprintf("%s%lu", i ? ", " : "", tcp->u_arg[i]);
654 printargs_ld(struct tcb *tcp)
658 int n = tcp->s_ent->nargs;
659 for (i = 0; i < n; i++)
660 tprintf("%s%ld", i ? ", " : "", tcp->u_arg[i]);
666 dumpio(struct tcb *tcp)
672 if ((unsigned long) tcp->u_arg[0] >= num_quals)
674 func = tcp->s_ent->sys_func;
675 if (func == printargs)
677 if (qual_flags[tcp->u_arg[0]] & QUAL_READ) {
678 if (func == sys_read ||
681 func == sys_recvfrom) {
682 dumpstr(tcp, tcp->u_arg[1], tcp->u_rval);
684 } else if (func == sys_readv) {
685 dumpiov(tcp, tcp->u_arg[2], tcp->u_arg[1]);
688 } else if (func == sys_recvmsg) {
689 dumpiov_in_msghdr(tcp, tcp->u_arg[1]);
691 } else if (func == sys_recvmmsg) {
692 dumpiov_in_mmsghdr(tcp, tcp->u_arg[1]);
697 if (qual_flags[tcp->u_arg[0]] & QUAL_WRITE) {
698 if (func == sys_write ||
699 func == sys_pwrite ||
702 dumpstr(tcp, tcp->u_arg[1], tcp->u_arg[2]);
703 else if (func == sys_writev)
704 dumpiov(tcp, tcp->u_arg[2], tcp->u_arg[1]);
706 else if (func == sys_sendmsg)
707 dumpiov_in_msghdr(tcp, tcp->u_arg[1]);
708 else if (func == sys_sendmmsg)
709 dumpiov_in_mmsghdr(tcp, tcp->u_arg[1]);
715 * Shuffle syscall numbers so that we don't have huge gaps in syscall table.
716 * The shuffling should be an involution: shuffle_scno(shuffle_scno(n)) == n.
718 #if defined(ARM) || defined(AARCH64) /* So far only 32-bit ARM needs this */
720 shuffle_scno(unsigned long scno)
722 if (scno < ARM_FIRST_SHUFFLED_SYSCALL)
725 /* __ARM_NR_cmpxchg? Swap with LAST_ORDINARY+1 */
726 if (scno == ARM_FIRST_SHUFFLED_SYSCALL)
728 if (scno == 0x000ffff0)
729 return ARM_FIRST_SHUFFLED_SYSCALL;
731 #define ARM_SECOND_SHUFFLED_SYSCALL (ARM_FIRST_SHUFFLED_SYSCALL + 1)
733 * Is it ARM specific syscall?
734 * Swap [0x000f0000, 0x000f0000 + LAST_SPECIAL] range
735 * with [SECOND_SHUFFLED, SECOND_SHUFFLED + LAST_SPECIAL] range.
737 if (scno >= 0x000f0000 &&
738 scno <= 0x000f0000 + ARM_LAST_SPECIAL_SYSCALL) {
739 return scno - 0x000f0000 + ARM_SECOND_SHUFFLED_SYSCALL;
741 if (scno <= ARM_SECOND_SHUFFLED_SYSCALL + ARM_LAST_SPECIAL_SYSCALL) {
742 return scno + 0x000f0000 - ARM_SECOND_SHUFFLED_SYSCALL;
748 # define shuffle_scno(scno) ((long)(scno))
752 undefined_scno_name(struct tcb *tcp)
754 static char buf[sizeof("syscall_%lu") + sizeof(long)*3];
756 sprintf(buf, "syscall_%lu", shuffle_scno(tcp->scno));
760 static long get_regs_error;
768 static int get_syscall_args(struct tcb *);
769 static int get_syscall_result(struct tcb *);
772 trace_syscall_entering(struct tcb *tcp)
776 scno_good = res = get_scno(tcp);
780 res = get_syscall_args(tcp);
785 tprints("????" /* anti-trigraph gap */ "(");
786 else if (tcp->qual_flg & UNDEFINED_SCNO)
787 tprintf("%s(", undefined_scno_name(tcp));
789 tprintf("%s(", tcp->s_ent->sys_name);
791 * " <unavailable>" will be added later by the code which
792 * detects ptrace errors.
798 if (sys_syscall == tcp->s_ent->sys_func)
799 decode_mips_subcall(tcp);
802 if ( sys_execve == tcp->s_ent->sys_func
803 # if defined(SPARC) || defined(SPARC64)
804 || sys_execv == tcp->s_ent->sys_func
807 hide_log_until_execve = 0;
810 #if defined(SYS_socket_subcall) || defined(SYS_ipc_subcall)
812 # ifdef SYS_socket_subcall
813 if (tcp->s_ent->sys_func == sys_socketcall) {
814 decode_socket_subcall(tcp);
818 # ifdef SYS_ipc_subcall
819 if (tcp->s_ent->sys_func == sys_ipc) {
820 decode_ipc_subcall(tcp);
828 if (!(tcp->qual_flg & QUAL_TRACE)
829 || (tracing_paths && !pathtrace_match(tcp))
831 tcp->flags |= TCB_INSYSCALL | TCB_FILTERED;
835 tcp->flags &= ~TCB_FILTERED;
837 if (cflag == CFLAG_ONLY_STATS || hide_log_until_execve) {
843 if (stack_trace_enabled) {
844 if (tcp->s_ent->sys_flags & STACKTRACE_CAPTURE_ON_ENTER)
845 unwind_capture_stacktrace(tcp);
850 if (tcp->qual_flg & UNDEFINED_SCNO)
851 tprintf("%s(", undefined_scno_name(tcp));
853 tprintf("%s(", tcp->s_ent->sys_name);
854 if ((tcp->qual_flg & QUAL_RAW) && tcp->s_ent->sys_func != sys_exit)
855 res = printargs(tcp);
857 res = tcp->s_ent->sys_func(tcp);
861 tcp->flags |= TCB_INSYSCALL;
862 /* Measure the entrance time as late as possible to avoid errors. */
864 gettimeofday(&tcp->etime, NULL);
869 trace_syscall_exiting(struct tcb *tcp)
876 /* Measure the exit time as early as possible to avoid errors. */
878 gettimeofday(&tv, NULL);
881 if (stack_trace_enabled) {
882 if (tcp->s_ent->sys_flags & STACKTRACE_INVALIDATE_CACHE)
883 unwind_cache_invalidate(tcp);
887 #if SUPPORTED_PERSONALITIES > 1
888 update_personality(tcp, tcp->currpers);
890 res = (get_regs_error ? -1 : get_syscall_result(tcp));
892 if (filtered(tcp) || hide_log_until_execve)
897 count_syscall(tcp, &tv);
898 if (cflag == CFLAG_ONLY_STATS) {
903 /* If not in -ff mode, and printing_tcp != tcp,
904 * then the log currently does not end with output
905 * of _our syscall entry_, but with something else.
906 * We need to say which syscall's return is this.
908 * Forced reprinting via TCB_REPRINT is used only by
909 * "strace -ff -oLOG test/threaded_execve" corner case.
910 * It's the only case when -ff mode needs reprinting.
912 if ((followfork < 2 && printing_tcp != tcp) || (tcp->flags & TCB_REPRINT)) {
913 tcp->flags &= ~TCB_REPRINT;
915 if (tcp->qual_flg & UNDEFINED_SCNO)
916 tprintf("<... %s resumed> ", undefined_scno_name(tcp));
918 tprintf("<... %s resumed> ", tcp->s_ent->sys_name);
922 tcp->s_prev_ent = NULL;
924 /* There was error in one of prior ptrace ops */
927 tprints("= ? <unavailable>\n");
929 tcp->flags &= ~TCB_INSYSCALL;
932 tcp->s_prev_ent = tcp->s_ent;
935 if (tcp->qual_flg & QUAL_RAW) {
936 /* sys_res = printargs(tcp); - but it's nop on sysexit */
938 /* FIXME: not_failing_only (IOW, option -z) is broken:
939 * failure of syscall is known only after syscall return.
940 * Thus we end up with something like this on, say, ENOENT:
941 * open("doesnt_exist", O_RDONLY <unfinished ...>
942 * {next syscall decode}
943 * whereas the intended result is that open(...) line
944 * is not shown at all.
946 if (not_failing_only && tcp->u_error)
947 goto ret; /* ignore failed syscalls */
948 sys_res = tcp->s_ent->sys_func(tcp);
953 u_error = tcp->u_error;
954 if (tcp->qual_flg & QUAL_RAW) {
956 tprintf("= -1 (errno %ld)", u_error);
958 tprintf("= %#lx", tcp->u_rval);
960 else if (!(sys_res & RVAL_NONE) && u_error) {
962 /* Blocked signals do not interrupt any syscalls.
963 * In this case syscalls don't return ERESTARTfoo codes.
965 * Deadly signals set to SIG_DFL interrupt syscalls
966 * and kill the process regardless of which of the codes below
967 * is returned by the interrupted syscall.
968 * In some cases, kernel forces a kernel-generated deadly
969 * signal to be unblocked and set to SIG_DFL (and thus cause
970 * death) if it is blocked or SIG_IGNed: for example, SIGSEGV
971 * or SIGILL. (The alternative is to leave process spinning
972 * forever on the faulty instruction - not useful).
974 * SIG_IGNed signals and non-deadly signals set to SIG_DFL
975 * (for example, SIGCHLD, SIGWINCH) interrupt syscalls,
976 * but kernel will always restart them.
979 /* Most common type of signal-interrupted syscall exit code.
980 * The system call will be restarted with the same arguments
981 * if SA_RESTART is set; otherwise, it will fail with EINTR.
983 tprints("= ? ERESTARTSYS (To be restarted if SA_RESTART is set)");
986 /* Rare. For example, fork() returns this if interrupted.
987 * SA_RESTART is ignored (assumed set): the restart is unconditional.
989 tprints("= ? ERESTARTNOINTR (To be restarted)");
992 /* pause(), rt_sigsuspend() etc use this code.
993 * SA_RESTART is ignored (assumed not set):
994 * syscall won't restart (will return EINTR instead)
995 * even after signal with SA_RESTART set. However,
996 * after SIG_IGN or SIG_DFL signal it will restart
997 * (thus the name "restart only if has no handler").
999 tprints("= ? ERESTARTNOHAND (To be restarted if no handler)");
1001 case ERESTART_RESTARTBLOCK:
1002 /* Syscalls like nanosleep(), poll() which can't be
1003 * restarted with their original arguments use this
1004 * code. Kernel will execute restart_syscall() instead,
1005 * which changes arguments before restarting syscall.
1006 * SA_RESTART is ignored (assumed not set) similarly
1007 * to ERESTARTNOHAND. (Kernel can't honor SA_RESTART
1008 * since restart data is saved in "restart block"
1009 * in task struct, and if signal handler uses a syscall
1010 * which in turn saves another such restart block,
1011 * old data is lost and restart becomes impossible)
1013 tprints("= ? ERESTART_RESTARTBLOCK (Interrupted by signal)");
1016 if ((unsigned long) u_error < nerrnos
1017 && errnoent[u_error])
1018 tprintf("= -1 %s (%s)", errnoent[u_error],
1021 tprintf("= -1 ERRNO_%lu (%s)", u_error,
1025 if ((sys_res & RVAL_STR) && tcp->auxstr)
1026 tprintf(" (%s)", tcp->auxstr);
1029 if (sys_res & RVAL_NONE)
1032 switch (sys_res & RVAL_MASK) {
1034 #if SUPPORTED_PERSONALITIES > 1
1035 if (current_wordsize < sizeof(long))
1037 (unsigned int) tcp->u_rval);
1040 tprintf("= %#lx", tcp->u_rval);
1043 tprintf("= %#lo", tcp->u_rval);
1046 tprintf("= %lu", tcp->u_rval);
1049 tprintf("= %ld", tcp->u_rval);
1054 printfd(tcp, tcp->u_rval);
1057 tprintf("= %ld", tcp->u_rval);
1059 #if defined(LINUX_MIPSN32) || defined(X32)
1062 tprintf("= %#llx", tcp->u_lrval);
1065 tprintf("= %#llo", tcp->u_lrval);
1068 case RVAL_LUDECIMAL:
1069 tprintf("= %llu", tcp->u_lrval);
1073 tprintf("= %lld", tcp->u_lrval);
1079 "invalid rval format\n");
1083 if ((sys_res & RVAL_STR) && tcp->auxstr)
1084 tprintf(" (%s)", tcp->auxstr);
1087 tv_sub(&tv, &tv, &tcp->etime);
1088 tprintf(" <%ld.%06ld>",
1089 (long) tv.tv_sec, (long) tv.tv_usec);
1095 #ifdef USE_LIBUNWIND
1096 if (stack_trace_enabled)
1097 unwind_print_stacktrace(tcp);
1101 tcp->flags &= ~TCB_INSYSCALL;
1106 trace_syscall(struct tcb *tcp)
1108 return exiting(tcp) ?
1109 trace_syscall_exiting(tcp) : trace_syscall_entering(tcp);
1113 * Cannot rely on __kernel_[u]long_t being defined,
1114 * it is quite a recent feature of <asm/posix_types.h>.
1116 #ifdef __kernel_long_t
1117 typedef __kernel_long_t kernel_long_t;
1118 typedef __kernel_ulong_t kernel_ulong_t;
1121 typedef long long kernel_long_t;
1122 typedef unsigned long long kernel_ulong_t;
1124 typedef long kernel_long_t;
1125 typedef unsigned long kernel_ulong_t;
1130 * Check the syscall return value register value for whether it is
1131 * a negated errno code indicating an error, or a success return value.
1134 is_negated_errno(kernel_ulong_t val)
1136 /* Linux kernel defines MAX_ERRNO to 4095. */
1137 kernel_ulong_t max = -(kernel_long_t) 4095;
1139 #if SUPPORTED_PERSONALITIES > 1 && SIZEOF_LONG > 4
1140 if (current_wordsize < sizeof(val)) {
1141 val = (uint32_t) val;
1142 max = (uint32_t) max;
1146 * current_wordsize is 4 even in personality 0 (native X32)
1147 * but truncation _must not_ be done in it.
1148 * can't check current_wordsize here!
1150 if (current_personality != 0) {
1151 val = (uint32_t) val;
1152 max = (uint32_t) max;
1159 #include "arch_regs.c"
1161 #ifdef HAVE_GETRVAL2
1162 # include "arch_getrval2.c"
1166 print_pc(struct tcb *tcp)
1171 #ifdef current_wordsize
1172 # define pc_wordsize current_wordsize
1174 # define pc_wordsize personality_wordsize[tcp->currpers]
1177 if (pc_wordsize == 4) {
1179 bad = "[????????] ";
1182 bad = "[????????????????] ";
1186 #define PRINTBADPC tprints(bad)
1188 if (get_regs_error) {
1193 #include "print_pc.c"
1196 #if defined X86_64 || defined POWERPC
1197 # include "getregs_old.c"
1200 #if defined ARCH_REGS_FOR_GETREGSET
1202 get_regset(pid_t pid)
1204 # ifdef ARCH_IOVEC_FOR_GETREGSET
1205 /* variable iovec */
1206 ARCH_IOVEC_FOR_GETREGSET.iov_len = sizeof(ARCH_REGS_FOR_GETREGSET);
1207 return ptrace(PTRACE_GETREGSET, pid, NT_PRSTATUS,
1208 &ARCH_IOVEC_FOR_GETREGSET);
1210 /* constant iovec */
1211 static struct iovec io = {
1212 .iov_base = &ARCH_REGS_FOR_GETREGSET,
1213 .iov_len = sizeof(ARCH_REGS_FOR_GETREGSET)
1215 return ptrace(PTRACE_GETREGSET, pid, NT_PRSTATUS, &io);
1219 #endif /* ARCH_REGS_FOR_GETREGSET */
1224 #ifdef ARCH_REGS_FOR_GETREGSET
1226 /* Try PTRACE_GETREGSET first, fallback to PTRACE_GETREGS. */
1227 static int getregset_support;
1229 if (getregset_support >= 0) {
1230 get_regs_error = get_regset(pid);
1231 if (getregset_support > 0)
1233 if (get_regs_error >= 0) {
1234 getregset_support = 1;
1237 if (errno == EPERM || errno == ESRCH)
1239 getregset_support = -1;
1242 # else /* !X86_64 */
1243 /* Assume that PTRACE_GETREGSET works. */
1244 get_regs_error = get_regset(pid);
1246 #elif defined ARCH_REGS_FOR_GETREGS
1247 # if defined SPARC || defined SPARC64
1248 /* SPARC systems have the meaning of data and addr reversed */
1249 get_regs_error = ptrace(PTRACE_GETREGS, pid, (char *)&ARCH_REGS_FOR_GETREGS, 0);
1250 # elif defined POWERPC
1251 static bool old_kernel = 0;
1254 get_regs_error = ptrace(PTRACE_GETREGS, pid, NULL, &ARCH_REGS_FOR_GETREGS);
1255 if (get_regs_error && errno == EIO) {
1258 get_regs_error = getregs_old(pid);
1261 /* Assume that PTRACE_GETREGS works. */
1262 get_regs_error = ptrace(PTRACE_GETREGS, pid, NULL, &ARCH_REGS_FOR_GETREGS);
1265 #else /* !ARCH_REGS_FOR_GETREGSET && !ARCH_REGS_FOR_GETREGS */
1266 # warning get_regs is not implemented for this architecture yet
1272 * 0: "ignore this ptrace stop", bail out of trace_syscall_entering() silently.
1273 * 1: ok, continue in trace_syscall_entering().
1274 * other: error, trace_syscall_entering() should print error indicator
1275 * ("????" etc) and bail out.
1278 get_scno(struct tcb *tcp)
1285 #include "get_scno.c"
1288 if (SCNO_IS_VALID(tcp->scno)) {
1289 tcp->s_ent = &sysent[scno];
1290 tcp->qual_flg = qual_flags[scno];
1292 static const struct_sysent unknown = {
1295 .sys_func = printargs,
1296 .sys_name = "system call",
1298 tcp->s_ent = &unknown;
1299 tcp->qual_flg = UNDEFINED_SCNO | QUAL_RAW | DEFAULT_QUAL_FLAGS;
1301 fprintf(stderr, "pid %d invalid syscall %ld\n",
1307 /* Return -1 on error or 1 on success (never 0!) */
1309 get_syscall_args(struct tcb *tcp)
1311 #include "get_syscall_args.c"
1316 get_error(struct tcb *tcp)
1318 const bool check_errno = !(tcp->s_ent->sys_flags & SYSCALL_NEVER_FAILS);
1321 #include "get_error.c"
1325 * 1: ok, continue in trace_syscall_exiting().
1326 * -1: error, trace_syscall_exiting() should print error indicator
1327 * ("????" etc) and bail out.
1330 get_syscall_result(struct tcb *tcp)
1332 #if defined ARCH_REGS_FOR_GETREGSET || defined ARCH_REGS_FOR_GETREGS
1333 /* already done by get_regs */
1335 # include "get_syscall_result.c"