CACHESTATS(1)

📦 version 1.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💾 CACHESTATS 💾

okay bestie, so cachestats is literally the tool that tells you how much of your file is chillin' in the cache versus how much of it is out there fighting for its life on disk. it prints the number of cached vs. not-cached pages. that's the whole vibe. no cap. ✨

🌸 SYNOPSIS 🌸

cachestats [-qv] file

🦋 DESCRIPTION 🦋

so basically, it prints the number of cached pages versus the pages that are not cached. that's it, that's the tea. your file's cache status, served fresh. 💅

✨ OPTIONS ✨

  • -v "Verbose mode" — turns on the verbose cache map, where every page that's actually present in the cache gets marked with an x. a whole lil grid of x's, it's giving spreadsheet but make it iconic. 🎀
  • -q "Quiet mode" — the exit status is 0 (success) if the file is fully cached. lowkey the perfect vibe check for scripting, iykyk. 🫶

👑 EXAMPLE 👑

$ cachestats -v ~/somefile.mp3
pages in cache: 85/114 (74.6%)  [filesize=453.5K, pagesize=4K]

cache map:
     0: |x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|
    32: |x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|
    64: |x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x|x| | | | | | | | | | | | |
    96: | | | | | | | | | | | | | | | | | |x|

look at all those x's going hard for the first 85 pages, and then the empty slots just... sitting there. the gap at the end of line 64 and most of line 96 is not the moment, fr fr. 😭 but hey, 74.6% cached is still eating. 🔥

🌈 SEE ALSO 🌈

Also, you can use vmstat 1 to view cache statistics. a little bonus bestie, go check it out. ⭐

and that's the whole page, mwah. this one's cachestats, from March 2013 — go forth and cache-check your faves. 🧚💜

📦 where this page comes from