scripts/timer_migration_tree.py
Source file repositories/reference/linux-study-clean/scripts/timer_migration_tree.py
File Facts
- System
- Linux kernel
- Corpus path
scripts/timer_migration_tree.py- Extension
.py- Size
- 3542 bytes
- Lines
- 123
- Domain
- Support Tooling And Documentation
- Bucket
- scripts
- Inferred role
- Support Tooling And Documentation: scripts
- Status
- atlas-only
Why This File Exists
Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
Dependency Surface
- No C-style include directives detected by the generator.
Detected Declarations
- No top-level syscall, struct, function, initcall, or export declaration detected by the generator.
Annotated Snippet
#!/usr/bin/env python3
# SPDX-License-Identifier: GPL-2.0
"""
Draw the timer migration tree.
1) Boot with trace_event==tmigr_connect_cpu_parent,tmigr_connect_child_parent
2) ./timer_migration_tree.py < /sys/kernel/tracing/trace
"""
import re, sys
from ete3 import Tree
class Node:
def __init__(self, group):
self.group = group
self.children = []
self.parent = None
self.num_children = 0
self.groupmask = 0
self.lvl = -1
def set_groupmask(self, groupmask):
self.groupmask = groupmask
def set_parent(self, parent):
self.parent = parent
def add_child(self, child):
self.children.append(child)
def set_lvl(self, lvl):
self.lvl = lvl
def set_numa(self, numa):
self.numa = numa
def set_num_children(self, num_children):
self.num_children = num_children
def __repr__(self):
if self.parent:
parent_grp = self.parent.group
else:
parent_grp = "-"
return "Group: %s mask: %s parent: %s lvl: %d numa: %d num_children: %d" % (self.group, self.groupmask, parent_grp, self.lvl, self.numa, self.num_children)
hierarchies = { }
def get_hierarchy(capacity):
if capacity not in hierarchies:
hierarchies[capacity] = {}
return hierarchies[capacity]
def get_node(capacity, group):
hier = get_hierarchy(capacity)
if group in hier:
return hier[group]
else:
n = Node(group)
hier[group] = n
return n
def tmigr_connect_cpu_parent(ts, line):
s = re.search("tmigr_connect_cpu_parent: cpu=([0-9]+) groupmask=([0-9a-zA-Z]+) parent=([0-9a-zA-Z]+) lvl=([0-9]+) numa=([-]?[0-9]+) capacity=([-]?[0-9]+) num_children=([0-9]+)", line)
if s is None:
return False
(cpu, groupmask, parent, lvl, numa, capacity, num_children) = (int(s.group(1)), s.group(2), s.group(3), int(s.group(4)), int(s.group(5)), int(s.group(6)), int(s.group(7)))
n = get_node(capacity, cpu)
p = get_node(capacity, parent)
Annotation
- Atlas domain: Support Tooling And Documentation / scripts.
- Implementation status: atlas-only.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.