Debian Codegraph @

tests/linux_kernel/helpers/test_timekeeping.py

raw
1 # Copyright (c) Meta Platforms, Inc. and affiliates.
2 # SPDX-License-Identifier: LGPL-2.1-or-later
3
4 from pathlib import Path
5 import time
6
7 from drgn import cast
8 from drgn.helpers.linux.timekeeping import (
9 ktime_get_boottime_seconds,
10 ktime_get_clocktai_seconds,
11 ktime_get_coarse_boottime_ns,
12 ktime_get_coarse_clocktai_ns,
13 ktime_get_coarse_ns,
14 ktime_get_coarse_real_ns,
15 ktime_get_real_seconds,
16 ktime_get_seconds,
17 ktime_to_ns,
18 uptime,
19 uptime_pretty,
20 )
21 from tests.linux_kernel import LinuxKernelTestCase, skip_unless_have_test_kmod
22
23 # These aren't available in the time module as of Python 3.14.
24 CLOCK_REALTIME_COARSE = getattr(time, "CLOCK_REALTIME_COARSE", 5)
25 CLOCK_MONOTONIC_COARSE = getattr(time, "CLOCK_MONOTONIC_COARSE", 6)
26
27
28 class TestTimekeeping(LinuxKernelTestCase):
29 def assert_in_range(self, a, b, c):
30 self.assertTrue(a <= b <= c, f"{b} is not in range [{a}, {c}]")
31
32 @skip_unless_have_test_kmod
33 def test_ktime_to_ns(self):
34 self.assertEqual(
35 ktime_to_ns(self.prog["drgn_test_ktime"]), self.prog["drgn_test_ktime_ns"]
36 )
37
38 def test_ktime_get_seconds(self):
39 t1 = int(time.clock_gettime(CLOCK_MONOTONIC_COARSE))
40 t2 = ktime_get_seconds(self.prog)
41 t3 = int(time.clock_gettime(CLOCK_MONOTONIC_COARSE))
42
43 self.assert_in_range(t1, t2.value_(), t3)
44 self.assertIdentical(t2, cast("time64_t", t2))
45
46 def test_ktime_get_coarse_ns(self):
47 t1 = time.clock_gettime_ns(CLOCK_MONOTONIC_COARSE)
48 t2 = ktime_get_coarse_ns(self.prog)
49 t3 = time.clock_gettime_ns(CLOCK_MONOTONIC_COARSE)
50
51 self.assert_in_range(t1, t2.value_(), t3)
52 self.assertIdentical(t2, cast("u64", t2))
53
54 def test_ktime_get_real_seconds(self):
55 t1 = int(time.clock_gettime(CLOCK_REALTIME_COARSE))
56 t2 = ktime_get_real_seconds(self.prog)
57 t3 = int(time.clock_gettime(CLOCK_REALTIME_COARSE))
58
59 self.assert_in_range(t1, t2.value_(), t3)
60 self.assertIdentical(t2, cast("time64_t", t2))
61
62 def test_ktime_get_coarse_real_ns(self):
63 t1 = time.clock_gettime_ns(CLOCK_REALTIME_COARSE)
64 t2 = ktime_get_coarse_real_ns(self.prog)
65 t3 = time.clock_gettime_ns(CLOCK_REALTIME_COARSE)
66
67 self.assert_in_range(t1, t2.value_(), t3)
68 self.assertIdentical(t2, cast("u64", t2))
69
70 @skip_unless_have_test_kmod
71 def test_ktime_get_boottime_seconds(self):
72 # There is no CLOCK_BOOTTIME_COARSE, so the test module exposes it in
73 # sysfs.
74 path = Path("/sys/kernel/drgn_test/boottime_seconds")
75
76 t1 = int(path.read_text())
77 t2 = ktime_get_boottime_seconds(self.prog)
78 t3 = int(path.read_text())
79
80 self.assert_in_range(t1, t2.value_(), t3)
81 self.assertIdentical(t2, cast("time64_t", t2))
82
83 @skip_unless_have_test_kmod
84 def test_ktime_get_coarse_boottime_ns(self):
85 # There is no CLOCK_BOOTTIME_COARSE, so the test module exposes it in
86 # sysfs.
87 path = Path("/sys/kernel/drgn_test/coarse_boottime_ns")
88
89 t1 = int(path.read_text())
90 t2 = ktime_get_coarse_boottime_ns(self.prog)
91 t3 = int(path.read_text())
92
93 self.assert_in_range(t1, t2.value_(), t3)
94 self.assertIdentical(t2, cast("u64", t2))
95
96 @skip_unless_have_test_kmod
97 def test_ktime_get_clocktai_seconds(self):
98 # There is no CLOCK_TAI_COARSE, so the test module exposes it in sysfs.
99 path = Path("/sys/kernel/drgn_test/clocktai_seconds")
100
101 t1 = int(path.read_text())
102 t2 = ktime_get_clocktai_seconds(self.prog)
103 t3 = int(path.read_text())
104
105 self.assert_in_range(t1, t2.value_(), t3)
106 self.assertIdentical(t2, cast("time64_t", t2))
107
108 @skip_unless_have_test_kmod
109 def test_ktime_get_coarse_clocktai_ns(self):
110 # There is no CLOCK_TAI_COARSE, so the test module exposes it in sysfs.
111 path = Path("/sys/kernel/drgn_test/coarse_clocktai_ns")
112
113 t1 = int(path.read_text())
114 t2 = ktime_get_coarse_clocktai_ns(self.prog)
115 t3 = int(path.read_text())
116
117 self.assert_in_range(t1, t2.value_(), t3)
118 self.assertIdentical(t2, cast("u64", t2))
119
120 @skip_unless_have_test_kmod
121 def test_uptime(self):
122 # There is no CLOCK_BOOTTIME_COARSE, so the test module exposes it in
123 # sysfs.
124 path = Path("/sys/kernel/drgn_test/coarse_boottime_ns")
125
126 t1 = int(path.read_text())
127 t2 = uptime(self.prog)
128 t3 = int(path.read_text())
129
130 self.assert_in_range(t1 / 1e9, t2, t3 / 1e9)
131 self.assertIsInstance(t2, float)
132
133 def test_uptime_pretty(self):
134 # Just test that it succeeds.
135 uptime_pretty(self.prog)