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.
39 /* The libc headers do not define this constant since it should only be
40 used by the implementation. So we define it here. */
42 # ifdef ASM_SA_RESTORER
43 # define SA_RESTORER ASM_SA_RESTORER
48 * Some architectures define SA_RESTORER in their headers,
49 * but do not actually have sa_restorer.
51 * Some architectures, otherwise, do not define SA_RESTORER in their headers,
52 * but actually have sa_restorer.
55 # if defined HPPA || defined IA64
56 # define HAVE_SA_RESTORER 0
58 # define HAVE_SA_RESTORER 1
60 #else /* !SA_RESTORER */
61 # if defined SPARC || defined SPARC64 || defined M68K
62 # define HAVE_SA_RESTORER 1
64 # define HAVE_SA_RESTORER 0
68 #include "xlat/sa_handler_values.h"
69 #include "xlat/sigact_flags.h"
70 #include "xlat/sigprocmaskcmds.h"
72 /* Anonymous realtime signals. */
74 /* Linux kernel >= 3.18 defines SIGRTMIN to 32 on all architectures. */
75 # define ASM_SIGRTMIN 32
78 /* Under glibc 2.1, SIGRTMAX et al are functions, but __SIGRTMAX is a
79 constant. This is what we want. Otherwise, just use SIGRTMAX. */
82 # define __SIGRTMAX SIGRTMAX
86 # define ASM_SIGRTMAX __SIGRTMAX
90 /* Note on the size of sigset_t:
92 * In glibc, sigset_t is an array with space for 1024 bits (!),
93 * even though all arches supported by Linux have only 64 signals
94 * except MIPS, which has 128. IOW, it is 128 bytes long.
96 * In-kernel sigset_t is sized correctly (it is either 64 or 128 bit long).
97 * However, some old syscall return only 32 lower bits (one word).
98 * Example: sys_sigpending vs sys_rt_sigpending.
100 * Be aware of this fact when you try to
101 * memcpy(&tcp->u_arg[1], &something, sizeof(sigset_t))
102 * - sizeof(sigset_t) is much bigger than you think,
103 * it may overflow tcp->u_arg[] array, and it may try to copy more data
104 * than is really available in <something>.
106 * umoven(tcp, addr, sizeof(sigset_t), &sigset)
107 * may be a bad idea: it'll try to read much more data than needed
108 * to fetch a sigset_t.
109 * Use NSIG_BYTES as a size instead.
113 get_sa_handler_str(kernel_ulong_t handler)
115 return xlookup(sa_handler_values, handler);
119 print_sa_handler(kernel_ulong_t handler)
121 const char *sa_handler_str = get_sa_handler_str(handler);
124 tprints(sa_handler_str);
130 signame(const int sig)
132 static char buf[sizeof("SIGRT_%u") + sizeof(int)*3];
135 const unsigned int s = sig;
140 if (s >= ASM_SIGRTMIN && s <= (unsigned int) ASM_SIGRTMAX) {
141 xsprintf(buf, "SIGRT_%u", s - ASM_SIGRTMIN);
146 xsprintf(buf, "%d", sig);
151 popcount32(const uint32_t *a, unsigned int size)
153 unsigned int count = 0;
155 for (; size; ++a, --size) {
158 #ifdef HAVE___BUILTIN_POPCOUNT
159 count += __builtin_popcount(x);
170 sprintsigmask_n(const char *prefix, const void *sig_mask, unsigned int bytes)
173 * The maximum number of signal names to be printed
174 * is NSIG_BYTES * 8 * 2 / 3.
175 * Most of signal names have length 7,
176 * average length of signal names is less than 7.
177 * The length of prefix string does not exceed 16.
179 static char outstr[128 + 8 * (NSIG_BYTES * 8 * 2 / 3)];
182 const uint32_t *mask;
183 uint32_t inverted_mask[NSIG_BYTES / 4];
188 s = stpcpy(outstr, prefix);
191 /* length of signal mask in 4-byte words */
192 size = (bytes >= NSIG_BYTES) ? NSIG_BYTES / 4 : (bytes + 3) / 4;
194 /* check whether 2/3 or more bits are set */
195 if (popcount32(mask, size) >= size * (4 * 8) * 2 / 3) {
196 /* show those signals that are NOT in the mask */
198 for (j = 0; j < size; ++j)
199 inverted_mask[j] = ~mask[j];
200 mask = inverted_mask;
205 for (i = 0; (i = next_set_bit(mask, i, size * (4 * 8))) >= 0; ) {
208 if ((unsigned) i < nsignals) {
209 s = stpcpy(s, signalent[i] + 3);
212 else if (i >= ASM_SIGRTMIN && i <= ASM_SIGRTMAX) {
213 s += xsnprintf(s, sizeof(outstr) - (s - outstr),
214 "RT_%u", i - ASM_SIGRTMIN);
218 s += xsnprintf(s, sizeof(outstr) - (s - outstr),
230 #define sprintsigmask_val(prefix, mask) \
231 sprintsigmask_n((prefix), &(mask), sizeof(mask))
233 #define tprintsigmask_val(prefix, mask) \
234 tprints(sprintsigmask_n((prefix), &(mask), sizeof(mask)))
237 sprint_old_sigmask_val(const char *const prefix, const unsigned long mask)
239 #if defined(current_wordsize) || !defined(WORDS_BIGENDIAN)
240 return sprintsigmask_n(prefix, &mask, current_wordsize);
241 #else /* !current_wordsize && WORDS_BIGENDIAN */
242 if (current_wordsize == sizeof(mask)) {
243 return sprintsigmask_val(prefix, mask);
245 uint32_t mask32 = mask;
246 return sprintsigmask_val(prefix, mask32);
251 #define tprint_old_sigmask_val(prefix, mask) \
252 tprints(sprint_old_sigmask_val((prefix), (mask)))
257 tprints(signame(nr));
261 print_sigset_addr_len_limit(struct tcb *const tcp, const kernel_ulong_t addr,
262 const kernel_ulong_t len, const unsigned int min_len)
265 * Here len is usually equal to NSIG_BYTES or current_wordsize.
266 * But we code this defensively:
268 if (len < min_len || len > NSIG_BYTES) {
272 int mask[NSIG_BYTES / sizeof(int)] = {};
273 if (umoven_or_printaddr(tcp, addr, len, mask))
275 tprints(sprintsigmask_n("", mask, len));
279 print_sigset_addr_len(struct tcb *const tcp, const kernel_ulong_t addr,
280 const kernel_ulong_t len)
282 print_sigset_addr_len_limit(tcp, addr, len, current_wordsize);
286 print_sigset_addr(struct tcb *const tcp, const kernel_ulong_t addr)
288 print_sigset_addr_len_limit(tcp, addr, NSIG_BYTES, NSIG_BYTES);
294 tprint_old_sigmask_val("", (unsigned) tcp->u_arg[0]);
295 } else if (!syserror(tcp)) {
296 tcp->auxstr = sprint_old_sigmask_val("old mask ",
297 (unsigned) tcp->u_rval);
298 return RVAL_HEX | RVAL_STR;
303 struct old_sigaction {
304 /* sa_handler may be a libc #define, need to use other name: */
306 unsigned int sa_flags;
307 unsigned long sa_handler__;
308 unsigned long sa_mask;
310 unsigned long sa_handler__;
311 unsigned long sa_mask;
312 unsigned int sa_flags;
314 unsigned long sa_handler__;
315 unsigned long sa_mask;
316 unsigned long sa_flags;
317 unsigned long sa_restorer;
326 decode_old_sigaction(struct tcb *const tcp, const kernel_ulong_t addr)
328 struct old_sigaction sa;
330 #ifndef current_wordsize
331 if (current_wordsize < sizeof(sa.sa_handler__)) {
332 struct old_sigaction32 {
333 uint32_t sa_handler__;
336 uint32_t sa_restorer;
339 if (umove_or_printaddr(tcp, addr, &sa32))
342 memset(&sa, 0, sizeof(sa));
343 sa.sa_handler__ = sa32.sa_handler__;
344 sa.sa_flags = sa32.sa_flags;
345 sa.sa_restorer = sa32.sa_restorer;
346 sa.sa_mask = sa32.sa_mask;
349 if (umove_or_printaddr(tcp, addr, &sa))
352 tprints("{sa_handler=");
353 print_sa_handler(sa.sa_handler__);
354 tprints(", sa_mask=");
355 tprint_old_sigmask_val("", sa.sa_mask);
356 tprints(", sa_flags=");
357 printflags(sigact_flags, sa.sa_flags, "SA_???");
358 #if !(defined ALPHA || defined MIPS)
359 if (sa.sa_flags & 0x04000000U) {
360 tprints(", sa_restorer=");
361 printaddr(sa.sa_restorer);
370 int signo = tcp->u_arg[0];
371 #if defined SPARC || defined SPARC64
379 decode_old_sigaction(tcp, tcp->u_arg[1]);
382 decode_old_sigaction(tcp, tcp->u_arg[2]);
389 printsignal(tcp->u_arg[0]);
391 print_sa_handler(tcp->u_arg[1]);
393 } else if (!syserror(tcp)) {
394 tcp->auxstr = get_sa_handler_str(tcp->u_rval);
395 return RVAL_HEX | RVAL_STR;
402 if (exiting(tcp) && !syserror(tcp)) {
403 tcp->auxstr = sprint_old_sigmask_val("mask ", tcp->u_rval);
404 return RVAL_HEX | RVAL_STR;
412 print_sigset_addr_len(tcp, tcp->u_arg[tcp->s_ent->nargs - 1],
415 tprint_old_sigmask_val("", tcp->u_arg[tcp->s_ent->nargs - 1]);
423 * The OSF/1 sigprocmask is different: it doesn't pass in two pointers,
424 * but rather passes in the new bitmask as an argument and then returns
425 * the old bitmask. This "works" because we only have 64 signals to worry
426 * about. If you want more, use of the rt_sigprocmask syscall is required.
429 * old = osf_sigprocmask(how, new);
431 * ret = sigprocmask(how, &new, &old, ...);
433 SYS_FUNC(osf_sigprocmask)
436 printxval(sigprocmaskcmds, tcp->u_arg[0], "SIG_???");
437 tprintsigmask_val(", ", tcp->u_arg[1]);
438 } else if (!syserror(tcp)) {
439 tcp->auxstr = sprintsigmask_val("old mask ", tcp->u_rval);
440 return RVAL_HEX | RVAL_STR;
447 /* "Old" sigprocmask, which operates with word-sized signal masks */
448 SYS_FUNC(sigprocmask)
451 printxval(sigprocmaskcmds, tcp->u_arg[0], "SIG_???");
453 print_sigset_addr_len(tcp, tcp->u_arg[1], current_wordsize);
456 print_sigset_addr_len(tcp, tcp->u_arg[2], current_wordsize);
466 signame(tcp->u_arg[1]));
473 tprintf("%d, %d, %s",
476 signame(tcp->u_arg[2]));
484 print_sigset_addr_len(tcp, tcp->u_arg[0], current_wordsize);
488 SYS_FUNC(rt_sigprocmask)
490 /* Note: arg[3] is the length of the sigset. Kernel requires NSIG_BYTES */
492 printxval(sigprocmaskcmds, tcp->u_arg[0], "SIG_???");
494 print_sigset_addr_len(tcp, tcp->u_arg[1], tcp->u_arg[3]);
497 print_sigset_addr_len(tcp, tcp->u_arg[2], tcp->u_arg[3]);
498 tprintf(", %" PRI_klu, tcp->u_arg[3]);
503 /* Structure describing the action to be taken when a signal arrives. */
504 struct new_sigaction {
505 /* sa_handler may be a libc #define, need to use other name: */
507 unsigned int sa_flags;
508 unsigned long sa_handler__;
510 unsigned long sa_handler__;
511 unsigned long sa_flags;
514 unsigned long sa_restorer;
516 /* Kernel treats sa_mask as an array of longs. */
517 unsigned long sa_mask[NSIG / sizeof(long)];
519 /* Same for i386-on-x86_64 and similar cases */
520 struct new_sigaction32 {
521 uint32_t sa_handler__;
524 uint32_t sa_restorer;
526 uint32_t sa_mask[2 * (NSIG / sizeof(long))];
530 decode_new_sigaction(struct tcb *const tcp, const kernel_ulong_t addr)
532 struct new_sigaction sa;
534 #ifndef current_wordsize
535 if (current_wordsize < sizeof(sa.sa_handler__)) {
536 struct new_sigaction32 sa32;
538 if (umove_or_printaddr(tcp, addr, &sa32))
541 memset(&sa, 0, sizeof(sa));
542 sa.sa_handler__ = sa32.sa_handler__;
543 sa.sa_flags = sa32.sa_flags;
544 #if HAVE_SA_RESTORER && defined SA_RESTORER
545 sa.sa_restorer = sa32.sa_restorer;
547 /* Kernel treats sa_mask as an array of longs.
548 * For 32-bit process, "long" is uint32_t, thus, for example,
549 * 32th bit in sa_mask will end up as bit 0 in sa_mask[1].
550 * But for (64-bit) kernel, 32th bit in sa_mask is
551 * 32th bit in 0th (64-bit) long!
552 * For little-endian, it's the same.
553 * For big-endian, we swap 32-bit words.
555 sa.sa_mask[0] = ULONG_LONG(sa32.sa_mask[0], sa32.sa_mask[1]);
558 if (umove_or_printaddr(tcp, addr, &sa))
561 tprints("{sa_handler=");
562 print_sa_handler(sa.sa_handler__);
563 tprints(", sa_mask=");
565 * Sigset size is in tcp->u_arg[4] (SPARC)
566 * or in tcp->u_arg[3] (all other),
567 * but kernel won't handle sys_rt_sigaction
568 * with wrong sigset size (just returns EINVAL instead).
569 * We just fetch the right size, which is NSIG_BYTES.
571 tprintsigmask_val("", sa.sa_mask);
572 tprints(", sa_flags=");
574 printflags(sigact_flags, sa.sa_flags, "SA_???");
575 #if HAVE_SA_RESTORER && defined SA_RESTORER
576 if (sa.sa_flags & SA_RESTORER) {
577 tprints(", sa_restorer=");
578 printaddr(sa.sa_restorer);
584 SYS_FUNC(rt_sigaction)
587 printsignal(tcp->u_arg[0]);
589 decode_new_sigaction(tcp, tcp->u_arg[1]);
592 decode_new_sigaction(tcp, tcp->u_arg[2]);
593 #if defined(SPARC) || defined(SPARC64)
594 tprintf(", %#" PRI_klx ", %" PRI_klu, tcp->u_arg[3], tcp->u_arg[4]);
596 tprintf(", %" PRI_klu ", %#" PRI_klx, tcp->u_arg[3], tcp->u_arg[4]);
598 tprintf(", %" PRI_klu, tcp->u_arg[3]);
604 SYS_FUNC(rt_sigpending)
608 * One of the few syscalls where sigset size (arg[1])
609 * is allowed to be <= NSIG_BYTES, not strictly ==.
610 * This allows non-rt sigpending() syscall
611 * to reuse rt_sigpending() code in kernel.
613 print_sigset_addr_len_limit(tcp, tcp->u_arg[0],
615 tprintf(", %" PRI_klu, tcp->u_arg[1]);
620 SYS_FUNC(rt_sigsuspend)
622 /* NB: kernel requires arg[1] == NSIG_BYTES */
623 print_sigset_addr_len(tcp, tcp->u_arg[0], tcp->u_arg[1]);
624 tprintf(", %" PRI_klu, tcp->u_arg[1]);
630 print_sigqueueinfo(struct tcb *const tcp, const int sig,
631 const kernel_ulong_t addr)
635 printsiginfo_at(tcp, addr);
638 SYS_FUNC(rt_sigqueueinfo)
640 tprintf("%d, ", (int) tcp->u_arg[0]);
641 print_sigqueueinfo(tcp, tcp->u_arg[1], tcp->u_arg[2]);
646 SYS_FUNC(rt_tgsigqueueinfo)
648 tprintf("%d, %d, ", (int) tcp->u_arg[0], (int) tcp->u_arg[1]);
649 print_sigqueueinfo(tcp, tcp->u_arg[2], tcp->u_arg[3]);
654 SYS_FUNC(rt_sigtimedwait)
656 /* NB: kernel requires arg[3] == NSIG_BYTES */
658 print_sigset_addr_len(tcp, tcp->u_arg[0], tcp->u_arg[3]);
660 if (!(tcp->u_arg[1] && verbose(tcp))) {
662 * This is the only "return" parameter,
663 * if we are not going to fetch it on exit,
664 * decode all parameters on entry.
666 printaddr(tcp->u_arg[1]);
668 print_timespec(tcp, tcp->u_arg[2]);
669 tprintf(", %" PRI_klu, tcp->u_arg[3]);
671 char *sts = xstrdup(sprint_timespec(tcp, tcp->u_arg[2]));
672 set_tcb_priv_data(tcp, sts, free);
675 if (tcp->u_arg[1] && verbose(tcp)) {
676 printsiginfo_at(tcp, tcp->u_arg[1]);
678 tprints(get_tcb_priv_data(tcp));
679 tprintf(", %" PRI_klu, tcp->u_arg[3]);
682 if (!syserror(tcp) && tcp->u_rval) {
683 tcp->auxstr = signame(tcp->u_rval);
690 SYS_FUNC(restart_syscall)
692 tprintf("<... resuming interrupted %s ...>",
693 tcp->s_prev_ent ? tcp->s_prev_ent->sys_name : "system call");