| 1 |
# Copyright (c) Meta Platforms, Inc. and affiliates. |
| 2 |
# SPDX-License-Identifier: LGPL-2.1-or-later |
| 3 |
|
| 4 |
import os |
| 5 |
from pathlib import Path |
| 6 |
import re |
| 7 |
import signal |
| 8 |
|
| 9 |
from drgn import Object |
| 10 |
from drgn.helpers.linux.pid import find_task |
| 11 |
from drgn.helpers.linux.signal import ( |
| 12 |
decode_sigset, |
| 13 |
sigaction_flags, |
| 14 |
signal_names, |
| 15 |
signal_numbers, |
| 16 |
sigpending_for_each, |
| 17 |
sigset_to_hex, |
| 18 |
) |
| 19 |
from tests.linux_kernel import LinuxKernelTestCase, fork_and_stop |
| 20 |
|
| 21 |
|
| 22 |
class TestSignal(LinuxKernelTestCase): |
| 23 |
def test_sigpending_for_each(self): |
| 24 |
with fork_and_stop( |
| 25 |
signal.pthread_sigmask, signal.SIG_BLOCK, {signal.SIGUSR1, signal.SIGUSR2} |
| 26 |
) as (pid, _): |
| 27 |
os.kill(pid, signal.SIGUSR1) |
| 28 |
os.kill(pid, signal.SIGUSR2) |
| 29 |
task = find_task(self.prog, pid) |
| 30 |
self.assertLessEqual( |
| 31 |
{signal.SIGUSR1, signal.SIGUSR2}, |
| 32 |
{ |
| 33 |
sigqueue.info.si_signo.value_() |
| 34 |
for sigqueue in sigpending_for_each( |
| 35 |
task.signal.shared_pending.address_of_() |
| 36 |
) |
| 37 |
}, |
| 38 |
) |
| 39 |
|
| 40 |
def test_signal_names(self): |
| 41 |
for name, number in signal_names(self.prog).items(): |
| 42 |
try: |
| 43 |
expected = getattr(signal, name) |
| 44 |
except AttributeError: |
| 45 |
continue |
| 46 |
if name == "SIGRTMIN": |
| 47 |
# glibc uses some real-time signals internally and adjusts |
| 48 |
# SIGRTMIN accordingly. |
| 49 |
self.assertLessEqual(number, expected) |
| 50 |
else: |
| 51 |
self.assertEqual(number, expected) |
| 52 |
|
| 53 |
def test_signal_numbers(self): |
| 54 |
number_to_names = signal_numbers(self.prog) |
| 55 |
for name, number in signal_names(self.prog).items(): |
| 56 |
self.assertIn(name, number_to_names[number]) |
| 57 |
|
| 58 |
def test_sigaction_flags(self): |
| 59 |
# We don't have a good way to validate the values from Python, so just |
| 60 |
# sanity check the dictionary. |
| 61 |
for flag, value in sigaction_flags(self.prog).items(): |
| 62 |
self.assertRegex(flag, r"^SA_") |
| 63 |
self.assertIsInstance(value, int) |
| 64 |
|
| 65 |
def test_decode_sigset(self): |
| 66 |
with fork_and_stop( |
| 67 |
signal.pthread_sigmask, signal.SIG_BLOCK, {signal.SIGUSR1, signal.SIGUSR2} |
| 68 |
) as (pid, _): |
| 69 |
os.kill(pid, signal.SIGUSR1) |
| 70 |
os.kill(pid, signal.SIGUSR2) |
| 71 |
task = find_task(self.prog, pid) |
| 72 |
sigset = task.signal.shared_pending.signal |
| 73 |
self.assertRegex(decode_sigset(sigset), r"^\{.*\bSIGUSR1,SIGUSR2\b.*\}$") |
| 74 |
self.assertRegex( |
| 75 |
decode_sigset(sigset.address_of_()), r"^\{.*\bSIGUSR1,SIGUSR2\b.*\}$" |
| 76 |
) |
| 77 |
|
| 78 |
def test_decode_sigset_value(self): |
| 79 |
self.assertEqual( |
| 80 |
decode_sigset( |
| 81 |
self.prog, (1 << (signal.SIGHUP - 1)) | (1 << (signal.SIGTERM - 1)) |
| 82 |
), |
| 83 |
"{SIGHUP,SIGTERM}", |
| 84 |
) |
| 85 |
|
| 86 |
def test_decode_sigset_integer_object(self): |
| 87 |
self.assertEqual( |
| 88 |
decode_sigset( |
| 89 |
self.prog, |
| 90 |
Object( |
| 91 |
self.prog, |
| 92 |
"unsigned long", |
| 93 |
(1 << (signal.SIGHUP - 1)) | (1 << (signal.SIGTERM - 1)), |
| 94 |
), |
| 95 |
), |
| 96 |
"{SIGHUP,SIGTERM}", |
| 97 |
) |
| 98 |
|
| 99 |
def test_sigset_to_hex(self): |
| 100 |
with fork_and_stop( |
| 101 |
signal.pthread_sigmask, signal.SIG_BLOCK, {signal.SIGUSR1, signal.SIGUSR2} |
| 102 |
) as (pid, _): |
| 103 |
os.kill(pid, signal.SIGUSR1) |
| 104 |
os.kill(pid, signal.SIGUSR2) |
| 105 |
task = find_task(self.prog, pid) |
| 106 |
expected = re.search( |
| 107 |
r"^ShdPnd:\s*([0-9a-f]+)", |
| 108 |
Path(f"/proc/{pid}/status").read_text(), |
| 109 |
flags=re.M, |
| 110 |
).group(1) |
| 111 |
self.assertEqual( |
| 112 |
sigset_to_hex(task.signal.shared_pending.signal.address_of_()), expected |
| 113 |
) |