Difference between revisions of "SystemTap"

From ArchWiki
Jump to: navigation, search
(easy and efficient build method)
 
m (modify config: 3.5.4)
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{i18n|Help:Systemtap}}
+
[[Category:Kernel]]
 
+
[[zh-CN:Systemtap]]
 
[http://sourceware.org/systemtap/ Systemtap] provides free software (GPL)
 
[http://sourceware.org/systemtap/ Systemtap] provides free software (GPL)
 
infrastructure to simplify the gathering of information about the running Linux system.
 
infrastructure to simplify the gathering of information about the running Linux system.
 
  
 
==Easy and fast==
 
==Easy and fast==
Officially it is recommanded to build a ''linux-custom'' package to run systemtap.
+
Officially, it is recommended to build a ''linux-custom'' package to run systemtap, but rebuilding the original {{Pkg|linux}} package can be very easy and efficient.
But rebuild the original {{Pkg|linux}} package can be very easy and efficient.
+
  
 
===Prepare===
 
===Prepare===
 
You can run {{ic|sudo abs; cp -r /var/abs/core/linux .}} to get the original kernel build files.
 
You can run {{ic|sudo abs; cp -r /var/abs/core/linux .}} to get the original kernel build files.
  
Edit '''config''' (for 32-bit system) or '''config.x86_64''' (for 64-bit system), turn on this options:
+
===modify config===
 +
Edit '''config''' (for 32-bit systems) or '''config.x86_64''' (for 64-bit systems), turn on these options:
 
* CONFIG_DEBUG_INFO=y
 
* CONFIG_DEBUG_INFO=y
 
* CONFIG_KPROBES=y
 
* CONFIG_KPROBES=y
Line 20: Line 19:
 
* CONFIG_MODULE_UNLOAD=y
 
* CONFIG_MODULE_UNLOAD=y
 
* CONFIG_UTRACE=y
 
* CONFIG_UTRACE=y
By default only ''CONFIG_DEBUG_INFO'' and ''CONFIG_KPROBES'' is not set.
+
By default only ''CONFIG_DEBUG_INFO'' and ''CONFIG_KPROBES'' are not set.
  
Suppose you just modified '''config.x86_64''', now save and close it.
+
With current core/linux (3.5.4) you can simply append these lines into config[.x86_64]:
Run {{ic|md5sum config.x86_64}} to get a new md5-sum.
+
{{hc|x86_64|
 +
<nowiki>
 +
echo '
 +
CONFIG_UTRACE=y
 +
CONFIG_KPROBES=y
 +
CONFIG_KPROBES_SANITY_TEST=n
 +
CONFIG_KPROBE_EVENT=y
 +
CONFIG_NET_DCCPPROBE=m
 +
CONFIG_NET_SCTPPROBE=m
 +
CONFIG_NET_TCPPROBE=y
 +
CONFIG_DEBUG_INFO=y
 +
CONFIG_DEBUG_INFO_REDUCED=n
 +
CONFIG_X86_DECODER_SELFTEST=n
 +
' >> config.x86_64
 +
</nowiki>
 +
}}
  
In '''PKGBUILD''' file, the {{ic|<nowiki>md5sums=('sum-of-first' ... 'sum-of-last')</nowiki>}} in the end has the same order with
+
===update checksum===
{{ic|<nowiki>source=('first-source' ... 'last-source')</nowiki>}}, put your new md5sum in the write place.
+
Run {{ic|md5sum config[.x86_64]}} to get a new md5sum.
 +
 
 +
In '''PKGBUILD''' file, the {{ic|<nowiki>md5sums=('sum-of-first' ... 'sum-of-last')</nowiki>}} has the same order with
 +
{{ic|<nowiki>source=('first-source' ... 'last-source')</nowiki>}}, put your new md5sum in the right place.
  
 
===Build and Install===
 
===Build and Install===
Line 36: Line 53:
 
{{Pkg|linux}} and {{Pkg|linux-headers}} should be reinstalled, {{Pkg|linux-docs}} does not matter.
 
{{Pkg|linux}} and {{Pkg|linux-headers}} should be reinstalled, {{Pkg|linux-docs}} does not matter.
  
Via this method, external modules (e.g. {{Pkg|nvidia}} and {{Pkg|virtualbox}}) don't need to be rebuild.
+
Via this method, external modules (e.g. {{Pkg|nvidia}} and {{Pkg|virtualbox}}) don't need to be rebuilt.
  
 
===Systemtap===
 
===Systemtap===
simply install systemtap for [[AUR]]: {{AUR|systemtap}}, all done.
+
Simply install systemtap from [[AUR]]: {{AUR|systemtap}}, all done.
 
+
  
 
==Build custom kernel==
 
==Build custom kernel==
 
Please reference this [http://sourceware.org/git/?p=systemtap.git;a=blob_plain;f=README;hb=HEAD README]
 
Please reference this [http://sourceware.org/git/?p=systemtap.git;a=blob_plain;f=README;hb=HEAD README]

Revision as of 08:20, 26 September 2012

Systemtap provides free software (GPL) infrastructure to simplify the gathering of information about the running Linux system.

Easy and fast

Officially, it is recommended to build a linux-custom package to run systemtap, but rebuilding the original linux package can be very easy and efficient.

Prepare

You can run sudo abs; cp -r /var/abs/core/linux . to get the original kernel build files.

modify config

Edit config (for 32-bit systems) or config.x86_64 (for 64-bit systems), turn on these options:

  • CONFIG_DEBUG_INFO=y
  • CONFIG_KPROBES=y
  • CONFIG_RELAY=y
  • CONFIG_DEBUG_FS=y
  • CONFIG_MODULES=y
  • CONFIG_MODULE_UNLOAD=y
  • CONFIG_UTRACE=y

By default only CONFIG_DEBUG_INFO and CONFIG_KPROBES are not set.

With current core/linux (3.5.4) you can simply append these lines into config[.x86_64]:

x86_64

echo '
CONFIG_UTRACE=y
CONFIG_KPROBES=y
CONFIG_KPROBES_SANITY_TEST=n
CONFIG_KPROBE_EVENT=y
CONFIG_NET_DCCPPROBE=m
CONFIG_NET_SCTPPROBE=m
CONFIG_NET_TCPPROBE=y
CONFIG_DEBUG_INFO=y
CONFIG_DEBUG_INFO_REDUCED=n
CONFIG_X86_DECODER_SELFTEST=n
' >> config.x86_64

update checksum

Run md5sum config[.x86_64] to get a new md5sum.

In PKGBUILD file, the md5sums=('sum-of-first' ... 'sum-of-last') has the same order with source=('first-source' ... 'last-source'), put your new md5sum in the right place.

Build and Install

Optional: you can set MAKEFLAGS="-j16" in /etc/makepkg.conf to speed up the compilation.

Run makepkg to compile, then simply sudo pacman -U *.pkg.tar.gz to install the packages. pacman will tell you reinstall, That's great!

linux and linux-headers should be reinstalled, linux-docs does not matter.

Via this method, external modules (e.g. nvidia and virtualbox) don't need to be rebuilt.

Systemtap

Simply install systemtap from AUR: systemtapAUR, all done.

Build custom kernel

Please reference this README