RRDFLUSHCACHED(1)

✨ RRDFLUSHCACHED 💅

ok so this is the rrdtool girlies' guide to rrdflushcached — one of the little rrdtool subcommands, and honestly? she's giving niche but essential. sit down, bestie, we're flushing cache 🫶

---

🌸 NAME 🌸

rrdflushcached — flush the values for a specific RRD file from memory. that's it, that's the whole vibe. memory says "I gotchu", disk says "where's my data", and this little icon steps in 💖

---

🎀 SYNOPSIS 🎀

rrdtool flushcached [--daemon|-d address] filename [filename ...]

literally the whole thing. that's her. no cap ✨

---

🦋 DESCRIPTION 🦋

okay so picture this: the flushcached function connects to rrdcached — that's the RRD caching daemon, the backstage crew of this whole operation — and it issues a "flush" command for the files you hand it. and when it says flush, it means flush.

the daemon will put the files at the head of the update queue so they get written "soon" — yes, the manpage puts "soon" in quotes, and honestly? iconic of them to be that honest about it 😭

and here's the part that lowkey matters most: the status will be returned only after the files' pending updates have actually been written to disk. so like, you don't get a "k cool done" until it's actually done done. no cap, that's the whole point 🔥

• filename — the name(s) of the RRD file(s) that are to be written to disk. plural, bestie, you can pass more than one, she's flexible like that 💅
• --daemon, -d address — the address of the rrdcached daemon. if you don't specify it, the RRDCACHED_ADDRESS environment variable must be set (see below, I gotchu 🫶). for the full list of accepted formats, go look at the -l option in the rrdcached manual — that's where the format lore lives.

and here's a lil example straight from the source, copy it exactly, don't @ me:

rrdtool flushcached --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd

look at her go 😌 unix socket, one RRD file, flushed, slayed 🎀

ngl, if you forget --daemon and forget to set RRDCACHED_ADDRESS, she literally cannot find the daemon and that's a you problem. set your env var, bestie 💀

---

🌈 ENVIRONMENT VARIABLES 🌈

the following environment variables may be used to change the behavior of "rrdtool flushcached":

• RRDCACHED_ADDRESS — if this environment variable is set, it will have the same effect as specifying the --daemon option on the command line. and if both are present? the command line argument takes precedence. queen behavior, honestly — command line always wins 👑

---

👑 AUTHOR 👑

Florian Forster <octo at verplant.org> — thank you for your service, legend 🫡💜

---

ok that's the whole page, you're a rrdflushcached expert now, go forth and flush responsibly 💖✨

this lil masterpiece is from rrdtool version 1.11.0, dated 2026-10-17 — screenshot the date, she's a whole timestamp 🎀🦋