Systemtap

Revision as of 14:45, 8 January 2021 by Registered User


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:

Yes: this tool is either present (ready to use or to be activated), or can be integrated and activated on the software package.

No: 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™
Warning white.png Warning
STM32MPU Embedded Software distribution for Android™ is no more supported by ST. You can contact our ST partner, Witekio, who can help you to port and maintain it on STM32MP15 platform.
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.

No Yes Yes No No No

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]

Under construction.png Check to introduce basic commands and examples for using dtrace and stap

5. To go further[edit source]

Under construction.png Coming soon


6. References[edit source]

"External links"
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