Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions BUILDING.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Requirements

- Go 1.24 or newer
- Go 1.26 or newer
- Linux (kernel 5.8+ with BTF for runtime)
- clang with BPF target support (only when refreshing the committed eBPF object)
- llvm-strip (optional, when refreshing the committed eBPF object)
Expand Down Expand Up @@ -91,7 +91,7 @@ targets (amd64, arm64).
### Debian / Kali / Parrot

```bash
# Build-Depends: debhelper-compat (= 13), golang-go
# Build-Depends: debhelper-compat (= 13), golang-go (>= 2:1.26~)
dpkg-buildpackage -us -uc -b
```

Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ Thank you for your interest in improving `procscope`! As a security-focused proj
1. **Fork the repository** on GitHub.
2. **Clone your fork** locally: `git clone https://github.com/YOUR-USERNAME/procscope.git`
3. **Create a new branch** for your feature or fix: `git checkout -b feature/your-feature-name`
4. **Install dependencies**: Ensure you have Go 1.24+ and the BPF toolchain (`clang`, `llvm`, `libbpf-dev`) installed.
4. **Install dependencies**: Ensure you have Go 1.26+ and the BPF toolchain (`clang`, `llvm`, `libbpf-dev`) installed.

## Development Workflow

Expand Down
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# procscope — Makefile
# Requires: Go 1.25+
# Requires: Go 1.26+
# Optional for refreshing the committed BPF object: clang, llvm-strip, bpftool

BINARY := procscope
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Launch a command under observation — or attach to an existing process — and

[![Try it in the Browser](https://img.shields.io/badge/Try_in_Browser-Killercoda-23C13F?style=flat-square&logoColor=white)](https://killercoda.com/mutasem04/scenario/procscope-scenario)

### 1-Minute Install (Go 1.24+)
### 1-Minute Install (Go 1.26+)
```bash
go install github.com/Mutasem-mk4/procscope/cmd/procscope@latest
sudo procscope -- ./suspicious-binary
Expand All @@ -66,7 +66,7 @@ sudo procscope -- ./suspicious-binary

## Tech Stack & Requirements

- **Runtime:** Go 1.24+
- **Build from source:** Go 1.26+
- **Observation:** eBPF (CO-RE)
- **Linux kernel 5.8+** with BTF support.
- **Root** privileges or specific eBPF capabilities.
Expand Down
8 changes: 5 additions & 3 deletions debian/changelog
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
procscope (0.1.0-1) unstable; urgency=medium
procscope (1.1.0-1) unstable; urgency=medium

* Initial release.
* Initial release for Parrot and Debian packaging.
* Align the package version with upstream v1.1.0.
* Require Go 1.26, matching the module and direct dependencies.
* Process lifecycle tracing (exec, fork, exit)
* File activity tracing (openat, rename, unlink, chmod, chown)
* Network activity tracing (connect, accept, bind, listen)
Expand All @@ -9,4 +11,4 @@ procscope (0.1.0-1) unstable; urgency=medium
* Evidence bundle and Markdown report generation
* JSONL event stream output

-- Mutasem-mk4 <140179052+Mutasem-mk4@users.noreply.github.com> Wed, 16 Apr 2026 12:00:00 +0000
-- Mutasem Kharma <kharma.mutasem@gmail.com> Fri, 24 Jul 2026 14:00:00 +0300
2 changes: 1 addition & 1 deletion debian/control
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Priority: optional
Maintainer: Mutasem-mk4 <140179052+Mutasem-mk4@users.noreply.github.com>
Build-Depends:
debhelper-compat (= 13),
golang-go (>= 2:1.24~),
golang-go (>= 2:1.26~),
Rules-Requires-Root: no
Standards-Version: 4.7.0
Homepage: https://github.com/Mutasem-mk4/procscope
Expand Down
4 changes: 2 additions & 2 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ brew tap Mutasem-mk4/kharma
brew install procscope
```

## 2. Go Install (Requires Go 1.24+)
## 2. Go Install (Requires Go 1.26+)

```bash
go install github.com/Mutasem-mk4/procscope/cmd/procscope@latest
Expand All @@ -29,7 +29,7 @@ Available assets include:

## 4. Build from Source

Ensure you have Go 1.24+ and `make` installed.
Ensure you have Go 1.26+ and `make` installed.

```bash
git clone https://github.com/Mutasem-mk4/procscope.git
Expand Down
Loading