tobert/pcstat

Health v2 · maintenance only

Adoption not part of the score

1310 stars · 153 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

pcstat is a small Go command-line utility that reports Linux page cache statistics for individual files using the mincore(2) syscall. It shows file size, page count, cached pages, and cache percentage, with human-readable, terse, JSON, and histogram output modes.

Use cases

• check if linux is caching my file
• see which database files are in page cache
• page cache statistics for files on linux
• verify sstable caching for cassandra
• diagnose why my database reads are hitting disk
• scriptable cache usage report per file

When to choose

• you are tuning a database like Cassandra or another IO-intensive app on Linux and need to confirm whether the kernel is caching your data files
• you want a quick point-in-time per-file cache report from the shell
• you need machine-readable output (terse or JSON) to feed into scripts or monitoring

When to avoid

• you are on a non-Linux platform, since the tool targets the Linux page cache and mincore syscall
• you need continuous, long-term cache metrics collection rather than on-demand snapshots
• you need per-process memory or cache accounting instead of per-file cache status

Facets

cli-tool · maturity stable

cli monitoring developer-tools developer-tools performance databases operating-systems go cli page-cache mincore linux-kernel io-tuning database-tuning cassandra filesystem system-administration performance-diagnostics json-output command-line linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tobert/pcstat")