|
NAME | DESCRIPTION | SEE ALSO | COLOPHON |
ERROR::PASS4(7stap) ERROR::PASS4(7stap)
error::pass4 - systemtap pass-4 errors
Errors that occur during pass 4 (compilation) have generally only a
few causes:
kernel or OS version changes
The systemtap runtime and embedded-C fragments in the tapset
library are designed to be portable across a wide range of OS
versions. However, incompatibilities can occur when some OS
changes occur, such as kernel modifications that change
functions, types, or macros referenced by systemtap. Upstream
(git://sourceware.org/git/systemtap.git) builds of systemtap
are often quickly updated to include relevant fixes, so try
getting or making an updated build. Reworded: build systemtap
from git for use with very young kernels. If the issue
persists, report the problem to the systemtap developers.
buggy embedded-C code
Embedded-C code in your own guru-mode script cannot be checked
by systemtap, and is passed through verbatim to the compiler.
Errors in such snippets of code may be found during the pass-4
compiler invocation, though may be hard to identify by the
compiler errors.
incompatible embedded-C code
The interface standards between systemtap-generated code and
embedded-C code occasionally change. For example, before
version 1.8, arguments were passed using macros THIS->foo and
THIS->__retvalue but from version 1.8 onward, using
STAP_ARG_foo and STAP_RETVALUE. Adjust your embedded-C code
to current standards, or use the stap --compatible=VERSION
option to make systemtap use a different one.
compiler bugs and mysteries
Messages such as "internal compiler error" suggest compiler
problems. These should be reported to the compiler developers
in the form of a preprocessed .i file, plus the compiler
command line. To gather relevant information, run
stap -k --vp 0003 -p4 ....
Systemtap will report the saved temporary directory, and the
compiler command line it attempted. Go to the directory to
find he main generated file stap_NNNNN_src.c. Force the com‐
piler to produce a preprocessed file with:
make -C /lib/modules/`uname -r`/build M=`pwd` stap_NNNNN_src.i
(note the .i suffix), and the compiler command line should be
in the file .stap_NNNNN_src.i.cmd.
stap(1),
error::reporting(7stap)
This page is part of the systemtap (a tracing and live-system
analysis tool) project. Information about the project can be found
at ⟨https://sourceware.org/systemtap/⟩. If you have a bug report for
this manual page, send it to systemtap@sourceware.org. This page was
obtained from the project's upstream Git repository
⟨git://sourceware.org/git/systemtap.git⟩ on 2017-07-05. If you dis‐
cover any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page, or
you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a mail
to man-pages@man7.org
ERROR::PASS4(7stap)