{"id":21744075,"url":"https://github.com/phpce/systemtap","last_synced_at":"2026-05-10T16:34:08.712Z","repository":{"id":256572740,"uuid":"146876651","full_name":"phpce/systemtap","owner":"phpce","description":null,"archived":false,"fork":false,"pushed_at":"2018-08-31T10:29:48.000Z","size":4670,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-28T08:45:24.293Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phpce.png","metadata":{"files":{"readme":"README","changelog":"NEWS","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-08-31T10:20:09.000Z","updated_at":"2018-08-31T10:29:55.000Z","dependencies_parsed_at":"2024-09-11T21:09:12.754Z","dependency_job_id":null,"html_url":"https://github.com/phpce/systemtap","commit_stats":null,"previous_names":["phpce/systemtap"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/phpce/systemtap","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpce%2Fsystemtap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpce%2Fsystemtap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpce%2Fsystemtap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpce%2Fsystemtap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phpce","download_url":"https://codeload.github.com/phpce/systemtap/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phpce%2Fsystemtap/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32863785,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"ssl_error","status_checked_at":"2026-05-10T13:40:02.145Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-26T07:09:55.810Z","updated_at":"2026-05-10T16:34:08.687Z","avatar_url":"https://github.com/phpce.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"systemtap: a linux trace/probe tool\n\nVisit the project web site at \u003chttp://sourceware.org/systemtap\u003e,\nfor documentation and mailing lists for developers and users.\n\nThis is free software.\nSee the COPYING file for redistribution/modification terms.\nSee the INSTALL file for generic build instructions.\nSee the HACKING file for contribution advice.\n\nPrerequisites:\n\n- linux kernel\n- kernel module build environment (kernel-devel rpm) and/or dyninst\n- optionally, debugging information for kernel/user-space being instrumented\n- C compiler (same as what kernel was compiled with), to build kernel modules\n- C++11 compiler such as gcc 4.8+, to build systemtap itself\n- elfutils 0.151+ with libdwfl for debugging information parsing\n- root privileges\n\nInstallation steps:\n\n- Install any debuginfo packages you need, for kernel and/or userspace.\n  On modern Fedora, # debuginfo-install kernel [...]\n  (Beware of confusion between kernel vs. kernel-debug vs kernel-PAE etc.\n  variants.  Each likely has a corresponding development and debuginfo\n  package.)\n\n- Install the systemtap package.\n  On modern Fedora, # yum install systemtap systemtap-runtime\n\nBuild steps:\n\n- Consider installing the kernel-debuginfo, kernel-devel, gcc and\n  dependent packages (or see below if you are building your own\n  kernels from source).  If using only the pure-userspace dyninst\n  backend, install gcc and dyninst-devel.\n  \n- If available, install your distribution's copy of elfutils and its\n  development headers/libraries.\n  Or if desired, download an elfutils source release to build in\n  \"bundled mode\" (below), and untar it into some new directory.\n  Or if desired, build elfutils separately one time, and install\n  it to /usr/local.\n  See http://elfutils.org/\n  Version 0.151 is recommended for i386 hosts probing prelinked programs.\n  (PR12141)\n\n- On modern Fedora, install general optional build-requisites:\n  # yum-builddep systemtap\n  On modern Debian/Ubuntu, similarly:\n  # apt-get build-dep systemtap\n\n- Download systemtap sources:\n  http://sourceware.org/systemtap/ftp/releases/\n  http://sourceware.org/systemtap/ftp/snapshots/\n  (or)\n  git clone git://sourceware.org/git/systemtap.git\n      (or) http://sourceware.org/git/systemtap.git\n\n- Build systemtap normally:\n  % .../configure [other autoconf options]\n  Or, with build it with a bundled internal copy of elfutils:\n  % .../configure --with-elfutils=ELFUTILS-SOURCE-DIR [other autoconf options]\n  (Ensure decompression library headers/libraries are installed for elfutils' use.)\n\n  Consider configuring with \"--enable-dejazilla\" to automatically\n  contribute to our public test result database.\n\n  Consider configuring with \"--prefix=DIRECTORY\" to specify an\n  installation directory other than /usr/local.  It can be an ordinary\n  personal directory.\n\n  % make all\n  # make install\n\n  To uninstall systemtap:\n  # make uninstall\n\n- Run systemtap:\n\n  To run systemtap after installation, add $prefix/bin to your $PATH, or\n  refer to $prefix/bin/stap directly.  If you keep your build tree\n  around, you can also use the \"stap\" binary there.  \n\n  Some samples should be available under $prefix/share/doc/systemtap/examples.\n\n  For the normal linux-kernel-module based backend, run \"stap\" as\n  root.  If desired, create \"stapdev\" and \"stapusr\" entries in\n  /etc/groups.  Any users in \"stapdev\"+\"stapusr\" will be able to run\n  systemtap as if with root privileges.  Users in \"stapusr\" only may\n  launch (with \"staprun\") pre-compiled probe modules (created by \"stap\n  -p4 ...\") that a system administrator copied under\n  /lib/modules/`uname -r`/systemtap.  \"stapusr\" may also be permitted\n  to create arbitrary unprivileged systemtap scripts of their own.\n  See README.unprivileged for additional setup instructions.\n\n  To run a simple test.\n  # stap -v -e 'probe vfs.read {printf(\"read performed\\n\"); exit()}'\n\n  To run the full test suite from the build tree, install dejagnu,\n  then run with root privileges:\n  # make installcheck\n\n  For the prototype dyninst pure-userspace backend, run \"stap\" as any user.\n  % stap --runtime=dyninst -e 'probe process.function(\"*\") { \n                               println(pn(), \":\", $$parms) }' -c 'ls'\n\n  For the prototype bpf backend, run \"stap\" as \"root\"\n  # stap --runtime=bpf -e 'probe kernel.function(\"do_exit\") {\n                                 printf(\"bye %d\\n\", pid()) }'\n\n\n\nTips:\n\n- By default, systemtap looks for the debug info in these locations:\n  /boot/vmlinux-`uname -r`\n  /usr/lib/debug/lib/modules/`uname -r`/vmlinux\n  /lib/modules/`uname -r`/vmlinux\n  /lib/modules/`uname -r`/build/vmlinux\n\n\nBuilding a kernel.org kernel:\n\n- Consider applying the utrace kernel patches, if you wish to probe\n  user-space applications.  http://sourceware.org/systemtap/wiki/utrace\n  Or if your kernel is near 3.5, apply the uprobes and related patches\n  (see NEWS).  Or if your kernel is \u003e= 3.5, enjoy the built-in uprobes.\n\n- Build the kernel using your normal procedures.  Enable\n  CONFIG_DEBUG_INFO, CONFIG_KPROBES, CONFIG_RELAY, CONFIG_DEBUG_FS,\n  CONFIG_MODULES, CONFIG_MODULE_UNLOAD, CONFIG_UTRACE if able\n- % make modules_install install headers_install\n- Boot into the kernel.\n\n- If you wish to leave the kernel build tree in place, simply run\n  % stap -r /path/to/kernel/build/tree [...]\n  You're done.\n\n- Or else, if you wish to install the kernel build/debuginfo data into\n  a place where systemtap will find it without the \"-r\" option:\n  % ln -s /path/to/kernel/build/tree /lib/modules/RELEASE/build \n\n- Instead of using the \"-r\" option, you can also use the environment \n  variable SYSTEMTAP_RELEASE to direct systemtap to the kernel data.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphpce%2Fsystemtap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphpce%2Fsystemtap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphpce%2Fsystemtap/lists"}