mirror of
https://github.com/DragonOS-Community/DragonOS.git
synced 2025-06-23 08:03:22 +00:00
6b581d4dd8
* feat: support tracepoint-based ebpf programs Signed-off-by: Godones <chenlinfeng25@outlook.com> * remove licenses Signed-off-by: Godones <chenlinfeng25@outlook.com> * feat: Supplement tracepoint related files fix some warnings add docs for tracepoint Signed-off-by: Godones <chenlinfeng25@outlook.com> --------- Signed-off-by: Godones <chenlinfeng25@outlook.com> Co-authored-by: longjin <longjin@DragonOS.org>
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
# mytrace
|
|
|
|
## Prerequisites
|
|
|
|
1. stable rust toolchains: `rustup toolchain install stable`
|
|
1. nightly rust toolchains: `rustup toolchain install nightly --component rust-src`
|
|
1. (if cross-compiling) rustup target: `rustup target add ${ARCH}-unknown-linux-musl`
|
|
1. (if cross-compiling) LLVM: (e.g.) `brew install llvm` (on macOS)
|
|
1. (if cross-compiling) C toolchain: (e.g.) [`brew install filosottile/musl-cross/musl-cross`](https://github.com/FiloSottile/homebrew-musl-cross) (on macOS)
|
|
1. bpf-linker: `cargo install bpf-linker` (`--no-default-features` on macOS)
|
|
|
|
## Build & Run
|
|
|
|
Use `cargo build`, `cargo check`, etc. as normal. Run your program with:
|
|
|
|
```shell
|
|
cargo run --release --config 'target."cfg(all())".runner="sudo -E"'
|
|
```
|
|
|
|
Cargo build scripts are used to automatically build the eBPF correctly and include it in the
|
|
program.
|
|
|
|
## Cross-compiling on macOS
|
|
|
|
Cross compilation should work on both Intel and Apple Silicon Macs.
|
|
|
|
```shell
|
|
CC=${ARCH}-linux-musl-gcc cargo build --package mytrace --release \
|
|
--target=${ARCH}-unknown-linux-musl \
|
|
--config=target.${ARCH}-unknown-linux-musl.linker=\"${ARCH}-linux-musl-gcc\"
|
|
```
|
|
The cross-compiled program `target/${ARCH}-unknown-linux-musl/release/mytrace` can be
|
|
copied to a Linux server or VM and run there.
|
|
|
|
## License
|
|
|
|
With the exception of eBPF code, mytrace is distributed under the terms
|
|
of either the [MIT license] or the [Apache License] (version 2.0), at your
|
|
option.
|
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
for inclusion in this crate by you, as defined in the Apache-2.0 license, shall
|
|
be dual licensed as above, without any additional terms or conditions.
|
|
|
|
### eBPF
|
|
|
|
All eBPF code is distributed under either the terms of the
|
|
[GNU General Public License, Version 2] or the [MIT license], at your
|
|
option.
|
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
for inclusion in this project by you, as defined in the GPL-2 license, shall be
|
|
dual licensed as above, without any additional terms or conditions.
|
|
|
|
[Apache license]: LICENSE-APACHE
|
|
[MIT license]: LICENSE-MIT
|
|
[GNU General Public License, Version 2]: LICENSE-GPL2
|