RRDLIST(1)

📦
version 1.11.0 · 13 versions
, in arch rolling

⭐ RRDLIST(1) ⭐

okay bestie, so this is the rrdlist page from the rrdtool manual — yes, lowercase rrdlist, that's literally the name, don't come for me 💅

🌸 NAME 🌸

rrdlist — the girlies who list directories and rrd databases. that's it, that's the whole job. iconic behavior tbh 🎀

✨ SYNOPSIS ✨

rrdtool list [--daemon|-d address] [--noflush|-F] [--recursive|-r] path

like, that's the shape of it. flags first, path at the end. slay 🫶

💖 DESCRIPTION 💖

the list function is giving you an 'ls-like' interface — yes, like ls, but make it rrd — for traversing and listing the whole rrd database tree. no cap, that's its entire vibe. 🦋

when you use the --daemon option, list connects to rrdcached, the RRD caching daemon, and issues a "list" command for the path you gave it. literally just handing the question off to the daemon. lowkey efficient. 🔥

  • path — the path, and it starts with /, where / is the rrdcached base_dir. so like, / here is the daemon's home base, not your whole filesystem. important distinction bestie, don't get it twisted 🙈
  • --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 a list of accepted formats, go peek at the -l option in the rrdcached manual — that's where the format lore lives.

example, copy it exactly, no improv:

rrdtool list --daemon 127.0.0.1:42218 /cluster/nodes/node1
  • --noflush, -F — when you're using a daemon, "rrdtool list" will usually flush its cache to the disk before doing its operations. this option disables cache flushing. so it's like… "no thank you, keep the cache, we're moving fast" 😌
  • --recursive, -r — makes the list of rrd databases recursive. it goes deeper. main character energy, honestly 🌀

🌈 ENVIRONMENT VARIABLES 🌈

these lil environment variables can change the behavior of "rrdtool list":

  • RRDCACHED_ADDRESS — if this environment variable is set, it has the same effect as specifying the "--daemon" option on the command line. but heads up 👑: if both are present, the command line argument takes precedence. the CLI always wins, periodt.

👑 AUTHOR 👑

Sebastien Dugue <sebastien.dugue@atos.net> — ty for this king, we are obsessed 💐

and that's the whole page bestie, go forth and list responsibly ✨💅

fr fr, version 1.11.0, dated 2026-10-17, straight from the rrdtool source. mwah, see u next time 🫶💖
📦 where this page comes from