root/tests/lib/libc/sys/t_ptrace_siginfo_wait.h
/*      $NetBSD: t_ptrace_siginfo_wait.h,v 1.2 2025/05/02 02:24:32 riastradh Exp $      */

/*-
 * Copyright (c) 2016, 2017, 2018, 2019, 2020 The NetBSD Foundation, Inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

static void
ptrace_siginfo(bool faked, void (*sah)(int a, siginfo_t *b, void *c),
    int *signal_caught)
{
        const int exitval = 5;
        const int sigval = SIGINT;
        const int sigfaked = SIGTRAP;
        const int sicodefaked = TRAP_BRKPT;
        pid_t child, wpid;
        struct sigaction sa;
#if defined(TWAIT_HAVE_STATUS)
        int status;
#endif
        struct ptrace_siginfo info;
        memset(&info, 0, sizeof(info));

        DPRINTF("Before forking process PID=%d\n", getpid());
        SYSCALL_REQUIRE((child = fork()) != -1);
        if (child == 0) {
                DPRINTF("Before calling PT_TRACE_ME from child %d\n", getpid());
                FORKEE_ASSERT(ptrace(PT_TRACE_ME, 0, NULL, 0) != -1);

                sa.sa_sigaction = sah;
                sa.sa_flags = SA_SIGINFO;
                sigemptyset(&sa.sa_mask);

                FORKEE_ASSERT(sigaction(faked ? sigfaked : sigval, &sa, NULL)
                    != -1);

                DPRINTF("Before raising %s from child\n", strsignal(sigval));
                FORKEE_ASSERT(raise(sigval) == 0);

                FORKEE_ASSERT_EQ(*signal_caught, 1);

                DPRINTF("Before exiting of the child process\n");
                _exit(exitval);
        }
        DPRINTF("Parent process PID=%d, child's PID=%d\n", getpid(), child);

        DPRINTF("Before calling %s() for the child\n", TWAIT_FNAME);
        TWAIT_REQUIRE_SUCCESS(wpid = TWAIT_GENERIC(child, &status, 0), child);

        validate_status_stopped(status, sigval);

        DPRINTF("Before calling ptrace(2) with PT_GET_SIGINFO for child\n");
        SYSCALL_REQUIRE(
            ptrace(PT_GET_SIGINFO, child, &info, sizeof(info)) != -1);

        DPRINTF("Signal traced to lwpid=%d\n", info.psi_lwpid);
        DPRINTF("Signal properties: si_signo=%#x si_code=%#x si_errno=%#x\n",
            info.psi_siginfo.si_signo, info.psi_siginfo.si_code,
            info.psi_siginfo.si_errno);

        if (faked) {
                DPRINTF("Before setting new faked signal to signo=%d "
                    "si_code=%d\n", sigfaked, sicodefaked);
                info.psi_siginfo.si_signo = sigfaked;
                info.psi_siginfo.si_code = sicodefaked;
        }

        DPRINTF("Before calling ptrace(2) with PT_SET_SIGINFO for child\n");
        SYSCALL_REQUIRE(
            ptrace(PT_SET_SIGINFO, child, &info, sizeof(info)) != -1);

        if (faked) {
                DPRINTF("Before calling ptrace(2) with PT_GET_SIGINFO for "
                    "child\n");
                SYSCALL_REQUIRE(ptrace(PT_GET_SIGINFO, child, &info,
                    sizeof(info)) != -1);

                DPRINTF("Before checking siginfo_t\n");
                ATF_REQUIRE_EQ(info.psi_siginfo.si_signo, sigfaked);
                ATF_REQUIRE_EQ(info.psi_siginfo.si_code, sicodefaked);
        }

        DPRINTF("Before resuming the child process where it left off and "
            "without signal to be sent\n");
        SYSCALL_REQUIRE(ptrace(PT_CONTINUE, child, (void *)1,
            faked ? sigfaked : sigval) != -1);

        DPRINTF("Before calling %s() for the child\n", TWAIT_FNAME);
        TWAIT_REQUIRE_SUCCESS(wpid = TWAIT_GENERIC(child, &status, 0), child);

        validate_status_exited(status, exitval);

        DPRINTF("Before calling %s() for the child\n", TWAIT_FNAME);
        TWAIT_REQUIRE_FAILURE(ECHILD, wpid = TWAIT_GENERIC(child, &status, 0));
}

#define PTRACE_SIGINFO(test, faked)                                     \
ATF_TC(test);                                                           \
ATF_TC_HEAD(test, tc)                                                   \
{                                                                       \
        atf_tc_set_md_var(tc, "descr",                                  \
            "Verify basic PT_GET_SIGINFO and PT_SET_SIGINFO calls"      \
            "with%s setting signal to new value", faked ? "" : "out");  \
}                                                                       \
                                                                        \
static int test##_caught = 0;                                           \
                                                                        \
static void                                                             \
test##_sighandler(int sig, siginfo_t *info, void *ctx)                  \
{                                                                       \
        if (faked) {                                                    \
                FORKEE_ASSERT_EQ(sig, SIGTRAP);                         \
                FORKEE_ASSERT_EQ(info->si_signo, SIGTRAP);              \
                FORKEE_ASSERT_EQ(info->si_code, TRAP_BRKPT);            \
        } else {                                                        \
                FORKEE_ASSERT_EQ(sig, SIGINT);                          \
                FORKEE_ASSERT_EQ(info->si_signo, SIGINT);               \
                FORKEE_ASSERT_EQ(info->si_code, SI_LWP);                \
        }                                                               \
                                                                        \
        ++ test##_caught;                                               \
}                                                                       \
                                                                        \
ATF_TC_BODY(test, tc)                                                   \
{                                                                       \
                                                                        \
        ptrace_siginfo(faked, test##_sighandler, & test##_caught);      \
}

PTRACE_SIGINFO(siginfo_set_unmodified, false)
PTRACE_SIGINFO(siginfo_set_faked, true)

#define ATF_TP_ADD_TCS_PTRACE_WAIT_SIGINFO() \
        ATF_TP_ADD_TC(tp, siginfo_set_unmodified); \
        ATF_TP_ADD_TC(tp, siginfo_set_faked);