procinfo

Un ispettore di processi portabile per Linux e macOS. Ottieni dettagli su qualsiasi processo in esecuzione all'istante!

Vedi anche procinfo_minimal.sh - implementazione pura in sh di procinfo.

Installazione

curl -fsSL https://raw.githubusercontent.com/wenekar/procinfo/main/procinfo.sh -o procinfo
chmod +x procinfo
sudo mv procinfo /usr/local/bin/

Oppure copia semplicemente lo script. È uno script bash senza dipendenze oltre agli strumenti Unix standard (ps, lsof, pgrep). O ancora meglio, copiane parti, combinale, crea uno script che soddisfi le tue esigenze specifiche!

Caratteristiche

• Cross-platform - Funziona su Linux e macOS (no Windows?)
• Zero dipendenze - A parte bash e gli strumenti Unix standard, e forse un sistema operativo.
• Albero dei processi - Vedi tutti i genitori di un dato processo. (sconvolgente!)
• Ispezione dell'ambiente - Vedi le variabili d'ambiente per un dato processo (-V o --env)
• Integrazione con systemd - Se un processo appartiene a un .service, mostra il percorso di quel file .service.
• Integrazione SSH - Vedi immediatamente l'utente@IP della sessione ssh che ha avviato il processo.
• Integrazione git - Il processo appartiene a un repository git? Vedi il branch e l'URL remoto direttamente nell'output.
• Consapevole di Docker - Rileva container, compose, container-id, nome immagine, binding delle porte... Potrebbe aggiungere altre informazioni in futuro.
• Informazioni di rete - Mostra tutte le porte in ascolto per un processo.
• Elenco porte - Un bell'output ss -tunlp per tutti!
• Rilevamento lock - Mostra i file di lock e i file aperti del processo.
• Formati multipli - Leggibile dall'uomo, one-liner breve o JSON
• Case-insensitive - procinfo nginx corrisponde a Nginx, NGINX, ecc.
• Modalità TUI con fzf - A quanto pare, fzf è piuttosto fantastico! Attenzione, non è un sostituto di top, è pensato per vedere le porte aperte, non tutti i processi.

Requisiti

procinfo:

• Un sistema UNIX-like
• bash
• ps
• lsof
• pgrep

Dipendenze opzionali:

• docker
• git
• systemctl
• whatis (incluso con man)
• jq (supporto output JSON)
• fzf (modalità TUI)

procinfo_minimal:

• sh

Utilizzo

# Modalità TUI interattiva (richiede fzf)
procinfo --tui

# Per nome processo
procinfo nginx

# Per porta
procinfo --port 3306

# Per PID
procinfo --pid 1234

# Output a una riga
procinfo --short nginx

# Output JSON (richiede jq)
procinfo --json nginx

Output di esempio

Target      : godot

Process     : godot.linuxbsd. (pid 234167)
User        : wenekar
Command     : ./bin/godot.linuxbsd.editor.x86_64 --verbose
Started at  : Wed Dec 31 19:12:10 2025
Running for : 1 minute, 6 seconds
RSS Memory  : 330 MB

Process tree:
  systemd (pid 1) → systemd (pid 1141) → konsole (pid 1725) → fish (pid 233851) → godot.linuxbsd. (pid 234167)

Source      : interactive fish shell
git info    : godot (fix-libdecor-ssd-fallback) - [email protected]:wenekar/godot.git
Working Dir : /mnt/Sandisk480/GitHub/godot
Open files  : /memfd:kwin-xkb-keymap-shared
              /memfd:wayland-cursor

Container Docker

Quando si ispeziona una porta associata a un container Docker:

Target      : port 6379

Process     : docker-proxy (pid 31782)
User        : root
Command     : /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 6379 -container-ip 172.18.0.2 -container-port 6379 -use-listen-fd
Started at  : Wed Dec 31 01:45:01 2025
Running for : 17 hours, 28 minutes, 39 seconds
RSS Memory  : 6 MB

Process tree:
  systemd (pid 1) → dockerd (pid 25817) → docker-proxy (pid 31782)

Source      : container runtime
git info    : not found
Working Dir : /
Listening   : *:6379

Docker info :
  Container : redis (463ab2f88502)
  Image     : redis
  Compose   : backend_test (/home/wenekar/backend_test/docker-compose.yml)
  Internal  : 172.18.0.2:6379

Docker cheatsheet:
  docker logs redis
  docker exec -it redis sh
  docker top redis
  docker ps //see all containers

Opzioni

Perché?

Ho visto una pubblicità su TikTok su un progetto chiamato witr, link al video TikTok. Poi ho pensato tra me e me, chi è l'utente target? Per chi è quel binario? Non è solo un wrapper bash di ps -p?

Così è nato procinfo, a quanto pare, io sono quell'utente target. Vedi anche issue 32.

Licenza

MIT