{"id":22308662,"url":"https://github.com/lemonrock/intel-seapi","last_synced_at":"2025-07-29T06:30:54.575Z","repository":{"id":62440969,"uuid":"154661161","full_name":"lemonrock/intel-seapi","owner":"lemonrock","description":"Rust FFI bindings to Intel SEAPI, including ittnotify","archived":false,"fork":false,"pushed_at":"2020-02-07T21:27:53.000Z","size":77,"stargazers_count":4,"open_issues_count":2,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-09T00:56:05.793Z","etag":null,"topics":["intel-seapi","musl","rust","rust-bindings","rust-crate","wrapper"],"latest_commit_sha":null,"homepage":"https://github.com/lemonrocj/intel-seapi","language":"Rust","has_issues":true,"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/lemonrock.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-10-25T11:41:32.000Z","updated_at":"2023-01-19T08:04:35.000Z","dependencies_parsed_at":"2022-11-01T22:15:22.424Z","dependency_job_id":null,"html_url":"https://github.com/lemonrock/intel-seapi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lemonrock/intel-seapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lemonrock%2Fintel-seapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lemonrock%2Fintel-seapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lemonrock%2Fintel-seapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lemonrock%2Fintel-seapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lemonrock","download_url":"https://codeload.github.com/lemonrock/intel-seapi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lemonrock%2Fintel-seapi/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267639569,"owners_count":24119780,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["intel-seapi","musl","rust","rust-bindings","rust-crate","wrapper"],"created_at":"2024-12-03T20:14:52.863Z","updated_at":"2025-07-29T06:30:54.061Z","avatar_url":"https://github.com/lemonrock.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# intel-seapi\n\n[intel-seapi] is a FFI wrapper for the Intel Single Event API (SEAPI, also known as [IntelSEAPI]) and `ittnotify`, as used by Intel VTune. ITT stands for 'Instrumentation and Tracing Technology'. ***This particular wrapper uses a fork of [IntelSEAPI] because the upstream code base doesn't support cross-compilation or the MUSL C library.***\n\nIt provides a static link and generates Rust FFI bindings to the `libittnotify.a/.obj` library, and also compiles , but does not link or generate Rust bindings for, the`libIntelSEAPI.dylib/.so/.dll` dynamic library (this is because it is only ever built dynamically and because it is designed to be used from C++).\n\nDownstream crates can use the generated build variables `cargo:include`, `cargo:libdir` and `cargo:root`.\n\n\n## Limitations\n\n* Does not currently work on Windows, as a completely different set of APIs (ending in `A` and `W`) are built for Windows by `libittnotify`.\n* The dynamic library `IntelSEAPI` is built but not linked and no bindings are generated for it.\n* Bindgen does not generate correct bindings for most of `libittnotify` because the C headers' function declarations do not reflect the actual managled names created. Consequently only a small subset of bindings is provided; additional bindings generated but not yet corrected are in `BindingsAsGeneratedByBingen.rs`.\n\n\n## Cross-Compilation\n\nThis is brittle, and may fail, mostly because the underlying software uses a mixture of CMake, a C++ toolchain with Rust bindings and wrappers, and [IntelSEAPI] is not cross-compile friendly. We use a forked version to fix some cross-compilation mistakes in their `CMakeLists.txt` files, generation of fat Mac OS X object archives with architectures independent of target or host, etc.\n\nFor example, when compiling for MUSL targets, Rust's `cc` crate assumes the C compiler is `musl-gcc` and the C++ compiler if `musl-g++`. Since the `cc` crate is managed by the `cmake` crate, this is something we can't easy change. This crate attempts to set the environment variable `CROSS_COMPILE` if not set already when cross-compiling using a MUSL target.\n\n\n### Known cross-compilations that work.\n\n* On Mac OS X, with filo-sottie's foked musl homebrew keg installed (`lemonrock/musl-cross/musl-cross`), `cargo build --target x86_64-unknown-linux-musl`.\n\n\n## Licensing\n\nThe license for this project is MIT.\n\n[intel-seapi]: https://github.com/lemonrock/intel-seapi \"intel-seapi GitHub page\"\n[IntelSEAPI]: https:://gtihub.com/intel/IntelSEAPI \"IntelSEAPI GitHub page\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flemonrock%2Fintel-seapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flemonrock%2Fintel-seapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flemonrock%2Fintel-seapi/lists"}