Skip to content

Commit

Permalink
add osinfo and minor fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
itaysk committed Oct 27, 2023
1 parent 56fa776 commit 637e1c6
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 1 deletion.
File renamed without changes.
12 changes: 11 additions & 1 deletion docs/docs/install/prerequisites.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ In addition to upstream kernels, most distributions long-term supported kernels
In order to properly instrument the kernel, Tracee needs low-level type information about the running kernel. Most modern Linux distributions ship with the [BTF](https://www.kernel.org/doc/html/latest/bpf/btf.html) feature that exposes this information.
To test if your linux has BFT enabled, look for a file under `/sys/kernel/btf/vmlinux`. If you don't have BTF, you might need to upgrade to a newer OS version, or contact your OS provider.

# Kernel symbols
## Kernel symbols

Some Tracee events needs access to the Kernel Symbols Table. Most Linux distributions ship with this feature enabled.
To test if your Linux supports it, look for a file under `/proc/kallsyms`. If your don't have it, you might contact your OS provider.
Expand All @@ -21,6 +21,14 @@ Alternatively you can disable the following events which depends on kallsyms:

- TODO

## OS information

In order to properly instrument the kernel, Tracee is probing the running OS and kernel to detect available capabilities.
For Os information please make sure the file `/etc/os-release` is available.
For Kernel information please make sure on of the files `/boot/config-$(uname-r)` OR `/proc/config.gz` is available.

For more information and advanced configuration of OS info files please see [here](../deep-dive/os-info.md)

## Process capabilities

In order to properly instrument the kernel, Tracee needs sufficient capabilities. The easiest way is run Tracee as "privileged" or "root".
Expand All @@ -38,6 +46,8 @@ If you want to run Tracee with "least privileges", here are the required capabil
* On cgroup v1 environments, `CAP_SYS_ADMIN` is recommended if running from a
container in order to allow tracee to mount the cpuset cgroup controller.

For more information and advanced configuration of process capabilities please see [here](../deep-dive/dropping-capabilities.md)

## Processor architecture

Tracee supports x86 and arm64 processors.

0 comments on commit 637e1c6

Please sign in to comment.