Skip to content

Security: trentas/ptop

Security

SECURITY.md

Security policy

Threat model

ptop runs as root (or with CAP_BPF + CAP_PERFMON) and loads eBPF programs into the kernel. Bugs in this code path can affect the host kernel directly — we treat security reports accordingly.

Reporting a vulnerability

Do not open a public issue for security reports.

Please use GitHub's private vulnerability reporting:

  1. Go to https://github.com/trentas/ptop/security/advisories/new
  2. Provide:
    • the affected version (commit hash if from main)
    • kernel version (uname -r) and distro
    • reproduction steps and impact
    • suggested mitigation, if you have one

You should receive an acknowledgement within 5 business days. Once a fix is ready, we coordinate disclosure with you (typically a 30–90 day window depending on severity).

If GitHub Security Advisories aren't an option for you, email the maintainer listed in go.mod / LICENSE.

Scope

In scope:

  • Memory corruption, panics, or kernel issues triggered by ptop's eBPF programs or loader.
  • Privilege escalation paths (e.g. an unprivileged process exploiting ptop while it's running with elevated caps).
  • Snapshot/export files containing data the user didn't expect (sensitive paths, credentials in command lines, etc.).
  • Supply chain: tampered release artifacts, compromised dependencies.

Out of scope:

  • Running ptop with --pid against a process the operator can't legitimately inspect — that's an OS permission question, not a ptop bug.
  • Information disclosure inherent to having CAP_BPF — by design, ptop exposes data that requires that capability.
  • Denial of service via resource exhaustion when monitoring an extremely busy process; please open a regular issue instead.

Hardening recommendations for operators

  • Prefer setcap cap_bpf,cap_perfmon+ep ./bin/ptop over running as root.
  • Don't run ptop binaries from untrusted sources. Verify release archives with the published SHA256SUMS.
  • The release binaries are built with CGO_ENABLED=0 and no dynamic linking — your distro's package manager should not see ptop pulling in extra shared libraries.

There aren't any published security advisories