Debian Codegraph @

tests/linux_kernel/helpers/test_signal.py

raw
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 )