{"id":15003685,"url":"https://github.com/lttng/lttng-tools","last_synced_at":"2026-02-12T22:08:27.097Z","repository":{"id":16169509,"uuid":"18915743","full_name":"lttng/lttng-tools","owner":"lttng","description":"The lttng-tools project provides a session daemon (lttng-sessiond) that acts as a tracing registry, the \"lttng\" command line for tracing control, a lttng-ctl library for tracing control and a lttng-relayd for network streaming.","archived":false,"fork":false,"pushed_at":"2026-01-27T22:56:54.000Z","size":30584,"stargazers_count":338,"open_issues_count":6,"forks_count":80,"subscribers_count":21,"default_branch":"master","last_synced_at":"2026-01-28T11:20:48.611Z","etag":null,"topics":["linux-kernel","lttng","monitoring","tracing"],"latest_commit_sha":null,"homepage":"https://lttng.org/","language":"C++","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lttng.png","metadata":{"files":{"readme":"README.adoc","changelog":"ChangeLog","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-04-18T14:45:45.000Z","updated_at":"2026-01-27T22:55:57.000Z","dependencies_parsed_at":"2023-10-02T19:36:42.537Z","dependency_job_id":"51f19d7d-7eae-4bc9-a9f3-b2a5b59a5775","html_url":"https://github.com/lttng/lttng-tools","commit_stats":{"total_commits":7113,"total_committers":87,"mean_commits":81.75862068965517,"dds":0.6867707015324054,"last_synced_commit":"8120a16d3132c3649c9a6084f202f29e70659bf4"},"previous_names":[],"tags_count":195,"template":false,"template_full_name":null,"purl":"pkg:github/lttng/lttng-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lttng%2Flttng-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lttng%2Flttng-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lttng%2Flttng-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lttng%2Flttng-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lttng","download_url":"https://codeload.github.com/lttng/lttng-tools/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lttng%2Flttng-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29382992,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T22:07:52.078Z","status":"ssl_error","status_checked_at":"2026-02-12T22:07:49.026Z","response_time":55,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["linux-kernel","lttng","monitoring","tracing"],"created_at":"2024-09-24T19:00:20.040Z","updated_at":"2026-02-12T22:08:27.093Z","avatar_url":"https://github.com/lttng.png","language":"C++","readme":"// Render with Asciidoctor\n\n:nbh: \u0026#8209;\n:lt: LTTng{nbh}tools\n:lib: liblttng{nbh}ctl\n\nifdef::env-github[]\n:toc: macro\nendif::env-github[]\n\nifndef::env-github[]\n:toc: left\nendif::env-github[]\n\n= {lt}\n5 May 2020\n\n[.normal]\nhttps://ci.lttng.org/job/lttng-tools_master_linuxbuild/[image:https://img.shields.io/jenkins/build.svg?jobUrl=https://ci.lttng.org/job/lttng-tools_master_linuxbuild/[Jenkins, title=\"Jenkins\"]]\nhttps://scan.coverity.com/projects/lttng-tools[image:https://img.shields.io/coverity/scan/lttng-tools.svg[Coverity, title=\"Coverity\"]]\n\n[.lead]\n_**{lt}**_ is a set of components to control https://lttng.org/[LTTng]\ntracing.\n\nThe project includes:\n\n* The LTTng https://lttng.org/man/8/lttng-sessiond/[session daemon].\n\n* The LTTng consumer daemon.\n\n* The LTTng https://lttng.org/man/8/lttng-relayd/[relay daemon].\n\n* {lib}, a library with a C{nbsp}API used to communicate with\n  the session daemon.\n\n* Python{nbsp}3 bindings of liblttng{nbh}ctl.\n\n* https://lttng.org/man/1/lttng/[`lttng`], a command-line tool over\n  {lib}.\n\n* https://lttng.org/man/1/lttng-crash/[`lttng{nbh}crash`], a command-line\n  tool to recover and view LTTng{nbsp}2 trace buffers in the event of a\n  crash.\n\nifdef::env-github[]\ntoc::[]\nendif::env-github[]\n\n== Required and optional dependencies\n\nYou need the following dependencies to build and run the {lt}\ncomponents:\n\n* **Linux kernel{nbsp}≥{nbsp}4.4.0**\n\n* **http://www.liburcu.org/[Userspace{nbsp}RCU]{nbsp}≥{nbsp}0.14.0**.\n+\nDebian/Ubuntu package: `liburcu{nbh}dev`.\n\n* **popt{nbsp}≥{nbsp}1.13**\n+\nDebian/Ubuntu package: `libpopt{nbh}dev`.\n\n* **http://xmlsoft.org/[Libxml2]{nbsp}≥{nbsp}2.7.6**\n+\nDebian/Ubuntu package: `libxml2{nbh}dev`\n\nThe following dependencies are optional:\n\n* **https://babeltrace.org/[Babeltrace{nbsp}≥{nbsp}2.1]**: default\n  viewer of the https://lttng.org/man/1/lttng-view/[`lttng view`]\n  command, `make{nbsp}check` and tests.\n+\nDebian/Ubuntu package: `babeltrace2 libbabeltrace2-dev`\n\n* **https://lttng.org/[LTTng{nbh}UST]** (same minor version as {lt}):\n  LTTng user space tracing (applications and libraries).\n+\nDebian/Ubuntu package: `liblttng{nbh}ust{nbh}dev`\n\n* **https://www.python.org/[Python]{nbsp}≥{nbsp}3.5**:\n  `make{nbsp}check` and tests.\n+\nDebian/Ubuntu package: `python3`\n\n* **http://www.swig.org/[SWIG]{nbsp}≥{nbsp}2.0** and\n  **Python{nbsp}3 development headers**: Python bindings\n  (enabled at \u003c\u003cconfigure,build configuration\u003e\u003e time with the\n  `{nbh}{nbh}enable{nbh}python{nbh}bindings` option).\n+\nDebian/Ubuntu packages: `swig2.0` and `python3{nbh}dev`\n\n* **modprobe** and/or\n  **https://git.kernel.org/pub/scm/utils/kernel/kmod/kmod.git/[kmod]{nbsp}≥{nbsp}22**:\n  automatic LTTng kernel modules loading (kernel tracing).\n\n* **Bash**: `make{nbsp}check`.\n\n* **http://man7.org/linux/man-pages/man1/man.1.html[`man`]**\n  (manual pager): view `lttng` command manual\n  pages with the `{nbh}{nbh}help` option or with the\n  https://lttng.org/man/1/lttng-help/[`lttng{nbsp}help`] command.\n+\nNOTE: You can use the \u003c\u003cconfigure,build configuration\u003e\u003e option\n`{nbh}{nbh}enable{nbh}embedded{nbh}help` to embed the manual pages into\nthe `lttng`, `lttng{nbh}sessiond`, `lttng{nbh}relayd`, and\n`lttng{nbh}crash` programs so that you don't need `man` to view them.\n\n* **http://perfmon2.sourceforge.net/[libpfm]{nbsp}≥{nbsp}4.0**:\n  perf regression test suite.\n+\nDebian/Ubuntu package: `libpfm4-dev`\n\n* **xxd**: `make{nbsp}check` and certain tests.\n+\nDebian/Ubuntu package: `xxd`\n\n* **lcov**: `make{nbsp}check-code-coverage`\n+\nDebian/Ubuntu package: `lcov`\n\n{lt} supports both the LTTng Linux kernel tracer and LTTng user space\ntracer sharing the same _minor_ version. While some minor releases do\nnot change the tracer ABIs and _could_ work, no testing is performed to\nensure that cross-version compatibility is maintained.\n\nYou don't need to rebuild or modify applications instrumented with older\nversions of the LTTng{nbh}UST project to make them work with the\ncomponents of the latest {lt} release.\n\nSee the https://lttng.org/docs/[LTTng Documentation] for more\ninformation on versioning.\n\n== Build from source\n\n=== Dependencies\n\nYou need the following tools to build {lt}:\n\n* **https://www.gnu.org/software/automake/manual/html_node/Autotools-Introduction.html[GNU{nbsp}Autotools]**\n  (**Automake{nbsp}≥{nbsp}1.12**,\n  **Autoconf{nbsp}≥{nbsp}2.64**, and **Autoheader{nbsp}≥{nbsp}2.50**)\n\n* **http://www.gnu.org/software/autoconf/[GNU{nbsp}Libtool]{nbsp}≥{nbsp}2.2**\n\n* **https://www.gnu.org/software/make/[GNU{nbsp}Make]**\n\n* **https://github.com/westes/flex/[Flex]{nbsp}≥{nbsp}2.5.35**\n\n* **https://www.gnu.org/software/bison/[Bison]{nbsp}≥{nbsp}2.4**\n\n* **https://www.freedesktop.org/wiki/Software/pkg-config/[pkg{nbh}config]** or similiar drop-in replacement\n\nTo build the {lt} manual pages:\n\n* **https://asciidoc.org/[AsciiDoc]{nbsp}≥{nbsp}8.4.5**\n+\nNOTE: Previous versions could work, but were not tested.\n\n* **https://pagure.io/xmlto[xmlto]{nbsp}≥{nbsp}0.0.21**\n+\nNOTE: Previous versions could work, but were not tested.\n\nIf you use GNU{nbsp}gold, which is _not_ mandatory:\n\n* **GNU{nbsp}gold{nbsp}≥{nbsp}2.22**\n\nNOTE: With GNU{nbsp}gold, you might need to add\n`-L/usr/local/lib` to the `LDFLAGS` environment variable.\n\n=== Build steps\n\n. **If you have the {lt} Git source**, run:\n+\n----\n$ ./bootstrap\n----\n+\nThis script creates the `configure` script.\n\n. [[configure]]Configure the build:\n+\n--\n----\n$ ./configure\n----\n\nIf you want the {lib} Python bindings, use the\n`{nbh}{nbh}enable{nbh}python{nbh}bindings` option. See also the `PYTHON`\nand `PYTHON_CONFIG` environment variables in\n`./configure{nbsp}{nbh}{nbh}help`.\n\nIf you don't want to build the manual pages, use the\n`{nbh}{nbh}disable{nbh}man{nbh}pages` option.\n\nIf you want to embed the manual pages into the `lttng`,\n`lttng{nbh}sessiond`, `lttng{nbh}relayd`, and `lttng{nbh}crash` programs\nso that you don't need `man` to view them, use the\n`{nbh}{nbh}enable{nbh}embedded{nbh}help` option.\n\nThis build configuration script finds LTTng{nbh}UST with\nhttps://www.freedesktop.org/wiki/Software/pkg-config/[pkg{nbh}config]:\nset the `PKG_CONFIG_PATH` environment variable accordingly if\npkg{nbh}config cannot find the `lttng{nbh}ust` package information.\n\nSee `./configure{nbsp}{nbh}{nbh}help` for the complete list of options.\n--\n\n. Build the project:\n+\n----\n$ make\n----\n\n. Install the project:\n+\n----\n$ sudo make install\n$ sudo ldconfig\n----\n\n== Tests\n\nTo run all the tests:\n\n----\n$ make check\n----\n\n== Usage\n\nSee the https://lttng.org/docs/#doc-controlling-tracing[Tracing control]\nsection of the LTTng Documentation to learn how to use the {lt}\ncomponents.\n\nSee also the https://lttng.org/man/[LTTng manual pages] (all\nsection{nbsp}1 and{nbsp}8 pages).\n\nAs there's no official {lib} Python bindings yet, see\nlink:doc/python-howto.txt[`doc/python-howto.txt`] to understand how to\nuse them.\n\n== Supported versions\n\nThe LTTng project supports the last two released stable versions\n(e.g. stable-2.13 and stable-2.12).\n\nFixes are backported from the master branch to the last stable version unless\nthose fixes would break the ABI or API. Those fixes may be backported to the\nsecond-last stable version, depending on complexity and ABI/API compatibility.\n\nSecurity fixes are backported from the master branch to both of the last stable\nversion and the second-last stable version.\n\nNew features are integrated into the master branch and not backported to the\nlast stable branch.\n\n== Community\n\nMailing list::\n    https://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev[lttng-dev]\n    (mailto:lttng-dev@lists.lttng.org[lttng-dev@lists.lttng.org])\n\nIRC channel::\n    irc://irc.oftc.net/lttng[`#lttng`] on the OFTC network\n\nMastodon::\n    https://mastodon.social/@lttng[lttng]\n\nBug tracker::\n    https://bugs.lttng.org/projects/lttng-tools[{lt} bug tracker]\n\nGitHub project::\n    https://github.com/lttng/lttng-tools/[lttng/lttng{nbh}tools]\n\nContinuous integration::\n    https://ci.lttng.org/job/lttng-tools_master_linuxbuild/[{lt}'s master build]\n    on LTTng's CI\n\nCode review::\n    https://review.lttng.org/q/project:lttng-tools[_lttng{nbh}tools_ project]\n    on LTTng Review\n\nContributor's guide::\n    https://github.com/lttng/lttng-tools/blob/master/CONTRIBUTING.md\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flttng%2Flttng-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flttng%2Flttng-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flttng%2Flttng-tools/lists"}