1. Article Purpose[edit source]
This article provides basic information to start using the Linux kernel tool: SystemTap[1] with stap command line tool.
2. Introduction[edit source]
The following table provides a brief description of the tool, as well as its availability depending on the software packages:
: this tool is either present (ready to use or to be activated), or can be integrated and activated on the software package.
: this tool is not present and cannot be integrated, or it is present but cannot be activated on the software package.
Tool | STM32MPU Embedded Software distribution | STM32MPU Embedded Software distribution for Android™ | ||||||
---|---|---|---|---|---|---|---|---|
Name | Category | Purpose | Starter Package | Developer Package | Distribution Package | Starter Package | Developer Package | Distribution Package |
SystemTap | Monitoring tools | SystemTap[1] provides stap target command line tool. SystemTap provides free software (GPL) infrastructure to simplify the gathering of information about the running Linux system. This assists diagnosis of a performance or functional problem. |
SystemTap provides a simple command line interface and scripting language for writing instrumentation for a live running kernel plus user-space applications. We are publishing samples, as well as enlarging the internal "tapset" script library to aid reuse and abstraction.
Among other tracing/probing tools, SystemTap is the tool of choice for complex tasks that may require live analysis, programmable on-line response, and whole-system symbolic access. SystemTap can also handle simple tracing jobs.
3. Installing the trace and debug tool on your target board[edit source]
3.1. Using STM32MPU Embedded Software distribution[edit source]
stap from systemtap is installed by default and ready to be used with all STM32MPU Embedded Software Packages.
which stap /usr/bin/stap
systemtap is integrated in weston image distribution through through meta-st package: meta-st/meta-st-openstlinux/recipes-st/packagegroups/packagegroup-framework-tools.bb
.
RDEPENDS_packagegroup-framework-tools-core = "\
grep \
util-linux \
util-linux-lscpu \
procps \
kbd \
file \
bc \
e2fsprogs \
e2fsprogs-resize2fs \
sysstat \
minicom \
ntp \
systemtap \
gptfdisk \
lsb-openstlinux \
"
4. Getting started[edit source]
Check to introduce basic commands and examples for using dtrace and stap |
5. To go further[edit source]
Coming soon |
6. References[edit source]
Document link | Document Type | Description |
---|---|---|
SystemTap beginner guide | User Guide | sourceware.org |
SystemTap Wiki | Wiki | sourceware.org |
SystemTap Wiki | Wiki | Wikipedia |
SystemTap documentation | User guide | sourceware.org |
stap manpage | Standard | linux.die.net |
dtrace manpage | Standard | linux.die.net |