# procutils-common
Shared utilities used by the `procutils` workspace. This crate is a
support library, not an end-user tool — it exists to keep parsing and
formatting logic in one place across the procutils binaries (`free`,
`pgrep`, `top`, `w`, etc.).
## Modules
| `fmt` | Human-readable size formatting (`format_kb`, `format_bytes`) -- the `K`/`M`/`G`/`T` rendering used in `top`, `hugetop`, `ps`, etc. |
| `procmatch` | Process selection logic shared by `pgrep`, `pkill`, `skill`, `snice` -- regex matching against `comm`/`cmdline`, plus filters on uid, gid, parent, session, tty, run-state, etc. |
| `signal` | Canonical signal-number/name table and the shared `parse_signal` helper used by `kill`, `pkill`, and `skill` |
| `uid` | UID-to-username lookup with a small cache, sourced from `/etc/passwd` |
| `utmp` | Reader for the `utmp(5)` binary file format used by `/var/run/utmp`. Stride is computed from `libc::utmpx`, which keeps the parser correct across glibc architectures (entries are 384 bytes on x86_64, 400 bytes on aarch64) |
## Stability
The API is **not stable** and may change without notice between
releases. This crate is intended for internal use by the procutils
workspace only.
## License
MIT.