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>
9 * Copyright (c) 2001-2017 The strace developers.
10 * All rights reserved.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
20 * 3. The name of the author may not be used to endorse or promote products
21 * derived from this software without specific prior written permission.
23 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
24 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
25 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
27 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
28 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
32 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38 /* The libc headers do not define this constant since it should only be
39 used by the implementation. So we define it here. */
41 # ifdef ASM_SA_RESTORER
42 # define SA_RESTORER ASM_SA_RESTORER
47 * Some architectures define SA_RESTORER in their headers,
48 * but do not actually have sa_restorer.
50 * Some architectures, otherwise, do not define SA_RESTORER in their headers,
51 * but actually have sa_restorer.
54 # if defined HPPA || defined IA64
55 # define HAVE_SA_RESTORER 0
57 # define HAVE_SA_RESTORER 1
59 #else /* !SA_RESTORER */
60 # if defined SPARC || defined SPARC64 || defined M68K
61 # define HAVE_SA_RESTORER 1
63 # define HAVE_SA_RESTORER 0
67 #include "xlat/sa_handler_values.h"
68 #include "xlat/sigact_flags.h"
69 #include "xlat/sigprocmaskcmds.h"
71 /* Anonymous realtime signals. */
73 /* Linux kernel >= 3.18 defines SIGRTMIN to 32 on all architectures. */
74 # define ASM_SIGRTMIN 32
77 /* Under glibc 2.1, SIGRTMAX et al are functions, but __SIGRTMAX is a
78 constant. This is what we want. Otherwise, just use SIGRTMAX. */
81 # define __SIGRTMAX SIGRTMAX
85 # define ASM_SIGRTMAX __SIGRTMAX
89 /* Note on the size of sigset_t:
91 * In glibc, sigset_t is an array with space for 1024 bits (!),
92 * even though all arches supported by Linux have only 64 signals
93 * except MIPS, which has 128. IOW, it is 128 bytes long.
95 * In-kernel sigset_t is sized correctly (it is either 64 or 128 bit long).
96 * However, some old syscall return only 32 lower bits (one word).
97 * Example: sys_sigpending vs sys_rt_sigpending.
99 * Be aware of this fact when you try to
100 * memcpy(&tcp->u_arg[1], &something, sizeof(sigset_t))
101 * - sizeof(sigset_t) is much bigger than you think,
102 * it may overflow tcp->u_arg[] array, and it may try to copy more data
103 * than is really available in <something>.
105 * umoven(tcp, addr, sizeof(sigset_t), &sigset)
106 * may be a bad idea: it'll try to read much more data than needed
107 * to fetch a sigset_t.
108 * Use NSIG_BYTES as a size instead.
112 get_sa_handler_str(kernel_ulong_t handler)
114 return xlookup(sa_handler_values, handler);
118 print_sa_handler(kernel_ulong_t handler)
120 const char *sa_handler_str = get_sa_handler_str(handler);
123 tprints(sa_handler_str);
129 signame(const int sig)
131 static char buf[sizeof("SIGRT_%u") + sizeof(int)*3];
134 const unsigned int s = sig;
139 if (s >= ASM_SIGRTMIN && s <= (unsigned int) ASM_SIGRTMAX) {
140 sprintf(buf, "SIGRT_%u", s - ASM_SIGRTMIN);
145 sprintf(buf, "%d", sig);
150 popcount32(const uint32_t *a, unsigned int size)
152 unsigned int count = 0;
154 for (; size; ++a, --size) {
157 #ifdef HAVE___BUILTIN_POPCOUNT
158 count += __builtin_popcount(x);
169 sprintsigmask_n(const char *prefix, const void *sig_mask, unsigned int bytes)
172 * The maximum number of signal names to be printed
173 * is NSIG_BYTES * 8 * 2 / 3.
174 * Most of signal names have length 7,
175 * average length of signal names is less than 7.
176 * The length of prefix string does not exceed 16.
178 static char outstr[128 + 8 * (NSIG_BYTES * 8 * 2 / 3)];
181 const uint32_t *mask;
182 uint32_t inverted_mask[NSIG_BYTES / 4];
187 s = stpcpy(outstr, prefix);
190 /* length of signal mask in 4-byte words */
191 size = (bytes >= NSIG_BYTES) ? NSIG_BYTES / 4 : (bytes + 3) / 4;
193 /* check whether 2/3 or more bits are set */
194 if (popcount32(mask, size) >= size * (4 * 8) * 2 / 3) {
195 /* show those signals that are NOT in the mask */
197 for (j = 0; j < size; ++j)
198 inverted_mask[j] = ~mask[j];
199 mask = inverted_mask;
204 for (i = 0; (i = next_set_bit(mask, i, size * (4 * 8))) >= 0; ) {
207 if ((unsigned) i < nsignals) {
208 s = stpcpy(s, signalent[i] + 3);
211 else if (i >= ASM_SIGRTMIN && i <= ASM_SIGRTMAX) {
212 s += sprintf(s, "RT_%u", i - ASM_SIGRTMIN);
216 s += sprintf(s, "%u", i);
227 #define sprintsigmask_val(prefix, mask) \
228 sprintsigmask_n((prefix), &(mask), sizeof(mask))
230 #define tprintsigmask_val(prefix, mask) \
231 tprints(sprintsigmask_n((prefix), &(mask), sizeof(mask)))
234 sprint_old_sigmask_val(const char *const prefix, const unsigned long mask)
236 #if defined(current_wordsize) || !defined(WORDS_BIGENDIAN)
237 return sprintsigmask_n(prefix, &mask, current_wordsize);
238 #else /* !current_wordsize && WORDS_BIGENDIAN */
239 if (current_wordsize == sizeof(mask)) {
240 return sprintsigmask_val(prefix, mask);
242 uint32_t mask32 = mask;
243 return sprintsigmask_val(prefix, mask32);
248 #define tprint_old_sigmask_val(prefix, mask) \
249 tprints(sprint_old_sigmask_val((prefix), (mask)))
254 tprints(signame(nr));
258 print_sigset_addr_len_limit(struct tcb *const tcp, const kernel_ulong_t addr,
259 const kernel_ulong_t len, const unsigned int min_len)
262 * Here len is usually equal to NSIG_BYTES or current_wordsize.
263 * But we code this defensively:
265 if (len < min_len || len > NSIG_BYTES) {
269 int mask[NSIG_BYTES / sizeof(int)] = {};
270 if (umoven_or_printaddr(tcp, addr, len, mask))
272 tprints(sprintsigmask_n("", mask, len));
276 print_sigset_addr_len(struct tcb *const tcp, const kernel_ulong_t addr,
277 const kernel_ulong_t len)
279 print_sigset_addr_len_limit(tcp, addr, len, current_wordsize);
283 print_sigset_addr(struct tcb *const tcp, const kernel_ulong_t addr)
285 print_sigset_addr_len_limit(tcp, addr, NSIG_BYTES, NSIG_BYTES);
291 tprint_old_sigmask_val("", (unsigned) tcp->u_arg[0]);
292 } else if (!syserror(tcp)) {
293 tcp->auxstr = sprint_old_sigmask_val("old mask ",
294 (unsigned) tcp->u_rval);
295 return RVAL_HEX | RVAL_STR;
300 struct old_sigaction {
301 /* sa_handler may be a libc #define, need to use other name: */
303 unsigned int sa_flags;
304 unsigned long sa_handler__;
305 unsigned long sa_mask;
307 unsigned long sa_handler__;
308 unsigned long sa_mask;
309 unsigned int sa_flags;
311 unsigned long sa_handler__;
312 unsigned long sa_mask;
313 unsigned long sa_flags;
314 unsigned long sa_restorer;
323 decode_old_sigaction(struct tcb *const tcp, const kernel_ulong_t addr)
325 struct old_sigaction sa;
327 #ifndef current_wordsize
328 if (current_wordsize < sizeof(sa.sa_handler__)) {
329 struct old_sigaction32 {
330 uint32_t sa_handler__;
333 uint32_t sa_restorer;
336 if (umove_or_printaddr(tcp, addr, &sa32))
339 memset(&sa, 0, sizeof(sa));
340 sa.sa_handler__ = sa32.sa_handler__;
341 sa.sa_flags = sa32.sa_flags;
342 sa.sa_restorer = sa32.sa_restorer;
343 sa.sa_mask = sa32.sa_mask;
346 if (umove_or_printaddr(tcp, addr, &sa))
349 tprints("{sa_handler=");
350 print_sa_handler(sa.sa_handler__);
351 tprints(", sa_mask=");
352 tprint_old_sigmask_val("", sa.sa_mask);
353 tprints(", sa_flags=");
354 printflags(sigact_flags, sa.sa_flags, "SA_???");
355 #if !(defined ALPHA || defined MIPS)
356 if (sa.sa_flags & 0x04000000U) {
357 tprints(", sa_restorer=");
358 printaddr(sa.sa_restorer);
367 int signo = tcp->u_arg[0];
368 #if defined SPARC || defined SPARC64
376 decode_old_sigaction(tcp, tcp->u_arg[1]);
379 decode_old_sigaction(tcp, tcp->u_arg[2]);
386 printsignal(tcp->u_arg[0]);
388 print_sa_handler(tcp->u_arg[1]);
390 } else if (!syserror(tcp)) {
391 tcp->auxstr = get_sa_handler_str(tcp->u_rval);
392 return RVAL_HEX | RVAL_STR;
399 if (exiting(tcp) && !syserror(tcp)) {
400 tcp->auxstr = sprint_old_sigmask_val("mask ", tcp->u_rval);
401 return RVAL_HEX | RVAL_STR;
409 print_sigset_addr_len(tcp, tcp->u_arg[tcp->s_ent->nargs - 1],
412 tprint_old_sigmask_val("", tcp->u_arg[tcp->s_ent->nargs - 1]);
420 * The OSF/1 sigprocmask is different: it doesn't pass in two pointers,
421 * but rather passes in the new bitmask as an argument and then returns
422 * the old bitmask. This "works" because we only have 64 signals to worry
423 * about. If you want more, use of the rt_sigprocmask syscall is required.
426 * old = osf_sigprocmask(how, new);
428 * ret = sigprocmask(how, &new, &old, ...);
430 SYS_FUNC(osf_sigprocmask)
433 printxval(sigprocmaskcmds, tcp->u_arg[0], "SIG_???");
434 tprintsigmask_val(", ", tcp->u_arg[1]);
435 } else if (!syserror(tcp)) {
436 tcp->auxstr = sprintsigmask_val("old mask ", tcp->u_rval);
437 return RVAL_HEX | RVAL_STR;
444 /* "Old" sigprocmask, which operates with word-sized signal masks */
445 SYS_FUNC(sigprocmask)
448 printxval(sigprocmaskcmds, tcp->u_arg[0], "SIG_???");
450 print_sigset_addr_len(tcp, tcp->u_arg[1], current_wordsize);
453 print_sigset_addr_len(tcp, tcp->u_arg[2], current_wordsize);
463 signame(tcp->u_arg[1]));
470 tprintf("%d, %d, %s",
473 signame(tcp->u_arg[2]));
481 print_sigset_addr_len(tcp, tcp->u_arg[0], current_wordsize);
485 SYS_FUNC(rt_sigprocmask)
487 /* Note: arg[3] is the length of the sigset. Kernel requires NSIG_BYTES */
489 printxval(sigprocmaskcmds, tcp->u_arg[0], "SIG_???");
491 print_sigset_addr_len(tcp, tcp->u_arg[1], tcp->u_arg[3]);
494 print_sigset_addr_len(tcp, tcp->u_arg[2], tcp->u_arg[3]);
495 tprintf(", %" PRI_klu, tcp->u_arg[3]);
500 /* Structure describing the action to be taken when a signal arrives. */
501 struct new_sigaction {
502 /* sa_handler may be a libc #define, need to use other name: */
504 unsigned int sa_flags;
505 unsigned long sa_handler__;
507 unsigned long sa_handler__;
508 unsigned long sa_flags;
511 unsigned long sa_restorer;
513 /* Kernel treats sa_mask as an array of longs. */
514 unsigned long sa_mask[NSIG / sizeof(long)];
516 /* Same for i386-on-x86_64 and similar cases */
517 struct new_sigaction32 {
518 uint32_t sa_handler__;
521 uint32_t sa_restorer;
523 uint32_t sa_mask[2 * (NSIG / sizeof(long))];
527 decode_new_sigaction(struct tcb *const tcp, const kernel_ulong_t addr)
529 struct new_sigaction sa;
531 #ifndef current_wordsize
532 if (current_wordsize < sizeof(sa.sa_handler__)) {
533 struct new_sigaction32 sa32;
535 if (umove_or_printaddr(tcp, addr, &sa32))
538 memset(&sa, 0, sizeof(sa));
539 sa.sa_handler__ = sa32.sa_handler__;
540 sa.sa_flags = sa32.sa_flags;
541 #if HAVE_SA_RESTORER && defined SA_RESTORER
542 sa.sa_restorer = sa32.sa_restorer;
544 /* Kernel treats sa_mask as an array of longs.
545 * For 32-bit process, "long" is uint32_t, thus, for example,
546 * 32th bit in sa_mask will end up as bit 0 in sa_mask[1].
547 * But for (64-bit) kernel, 32th bit in sa_mask is
548 * 32th bit in 0th (64-bit) long!
549 * For little-endian, it's the same.
550 * For big-endian, we swap 32-bit words.
552 sa.sa_mask[0] = ULONG_LONG(sa32.sa_mask[0], sa32.sa_mask[1]);
555 if (umove_or_printaddr(tcp, addr, &sa))
558 tprints("{sa_handler=");
559 print_sa_handler(sa.sa_handler__);
560 tprints(", sa_mask=");
562 * Sigset size is in tcp->u_arg[4] (SPARC)
563 * or in tcp->u_arg[3] (all other),
564 * but kernel won't handle sys_rt_sigaction
565 * with wrong sigset size (just returns EINVAL instead).
566 * We just fetch the right size, which is NSIG_BYTES.
568 tprintsigmask_val("", sa.sa_mask);
569 tprints(", sa_flags=");
571 printflags(sigact_flags, sa.sa_flags, "SA_???");
572 #if HAVE_SA_RESTORER && defined SA_RESTORER
573 if (sa.sa_flags & SA_RESTORER) {
574 tprints(", sa_restorer=");
575 printaddr(sa.sa_restorer);
581 SYS_FUNC(rt_sigaction)
584 printsignal(tcp->u_arg[0]);
586 decode_new_sigaction(tcp, tcp->u_arg[1]);
589 decode_new_sigaction(tcp, tcp->u_arg[2]);
590 #if defined(SPARC) || defined(SPARC64)
591 tprintf(", %#" PRI_klx ", %" PRI_klu, tcp->u_arg[3], tcp->u_arg[4]);
593 tprintf(", %" PRI_klu ", %#" PRI_klx, tcp->u_arg[3], tcp->u_arg[4]);
595 tprintf(", %" PRI_klu, tcp->u_arg[3]);
601 SYS_FUNC(rt_sigpending)
605 * One of the few syscalls where sigset size (arg[1])
606 * is allowed to be <= NSIG_BYTES, not strictly ==.
607 * This allows non-rt sigpending() syscall
608 * to reuse rt_sigpending() code in kernel.
610 print_sigset_addr_len_limit(tcp, tcp->u_arg[0],
612 tprintf(", %" PRI_klu, tcp->u_arg[1]);
617 SYS_FUNC(rt_sigsuspend)
619 /* NB: kernel requires arg[1] == NSIG_BYTES */
620 print_sigset_addr_len(tcp, tcp->u_arg[0], tcp->u_arg[1]);
621 tprintf(", %" PRI_klu, tcp->u_arg[1]);
627 print_sigqueueinfo(struct tcb *const tcp, const int sig,
628 const kernel_ulong_t addr)
632 printsiginfo_at(tcp, addr);
635 SYS_FUNC(rt_sigqueueinfo)
637 tprintf("%d, ", (int) tcp->u_arg[0]);
638 print_sigqueueinfo(tcp, tcp->u_arg[1], tcp->u_arg[2]);
643 SYS_FUNC(rt_tgsigqueueinfo)
645 tprintf("%d, %d, ", (int) tcp->u_arg[0], (int) tcp->u_arg[1]);
646 print_sigqueueinfo(tcp, tcp->u_arg[2], tcp->u_arg[3]);
651 SYS_FUNC(rt_sigtimedwait)
653 /* NB: kernel requires arg[3] == NSIG_BYTES */
655 print_sigset_addr_len(tcp, tcp->u_arg[0], tcp->u_arg[3]);
657 if (!(tcp->u_arg[1] && verbose(tcp))) {
659 * This is the only "return" parameter,
660 * if we are not going to fetch it on exit,
661 * decode all parameters on entry.
663 printaddr(tcp->u_arg[1]);
665 print_timespec(tcp, tcp->u_arg[2]);
666 tprintf(", %" PRI_klu, tcp->u_arg[3]);
668 char *sts = xstrdup(sprint_timespec(tcp, tcp->u_arg[2]));
669 set_tcb_priv_data(tcp, sts, free);
672 if (tcp->u_arg[1] && verbose(tcp)) {
673 printsiginfo_at(tcp, tcp->u_arg[1]);
675 tprints(get_tcb_priv_data(tcp));
676 tprintf(", %" PRI_klu, tcp->u_arg[3]);
679 if (!syserror(tcp) && tcp->u_rval) {
680 tcp->auxstr = signame(tcp->u_rval);
687 SYS_FUNC(restart_syscall)
689 tprintf("<... resuming interrupted %s ...>",
690 tcp->s_prev_ent ? tcp->s_prev_ent->sys_name : "system call");