An open API service indexing awesome lists of open source software.

https://github.com/cppcoffee/c-oncpu

perf event process
https://github.com/cppcoffee/c-oncpu

aya aya-ebpf ebpf rust

Last synced: about 1 month ago
JSON representation

perf event process

Awesome Lists containing this project

README

          

# c-oncpu

## 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

```shell
$ AYA_BUILD_EBPF=true cargo build --release
```

or

```shell
$ make
```

## Cross-compiling on macOS

Cross compilation should work on both Intel and Apple Silicon Macs.

```shell
CC=${ARCH}-linux-musl-gcc cargo build --package c-oncpu --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/c-oncpu` can be
copied to a Linux server or VM and run there.

## Usage

```shell
Usage: c-oncpu [OPTIONS] --pid

Options:
-p, --pid pid of the process
-t, --timeout timeout in seconds [default: 30]
-o, --output output file [default: /tmp/output.out]
-v, --verbose verbose mode
-k, --kernel-threads-only Kernel threads only (no user threads)
-f, --frequency sample frequency [default: 1000]
-h, --help Print help
```

### Example:

```shell
# ./target/release/c-oncpu --pid 58102
```

Generating flame graphs:

```shell
# ./FlameGraph/flamegraph.pl /tmp/output.out > /tmp/1.svg
```