RRDRESTORE(1)

RRDRESTORE(1) 💅

okay so this is the rrdtool manual page, and we're about to make restoring an RRD from XML make sense. no cap, it's easier than it sounds. ✨

✨ NAME ✨

rrdrestore — restore the contents of an RRD from its XML dump format. that's the whole vibe: XML goes in, native RRD comes out. 💖

🌈 SYNOPSIS 🌈

rrdtool restore filename.xml filename.rrd [--range-check|-r]
[--force-overwrite|-f]

💖 DESCRIPTION 💖

okay so the restore function reads the XML representation of an RRD and converts it to the native RRD format. literally glow-up via XML. 🦋

here's the cast of characters you pass in:

• filename.xml — the name of the XML file you want to restore, bestie. the special filename - (a single dash) is interpreted as standard input. 👑
• filename.rrd — the name of the RRD to restore. that's the destination, periodt. 🎀
• --range-check, -r — make sure the values in the RRAs do not exceed the limits defined for the various data sources. it's giving safety goggles for your data. 🔥
• --force-overwrite, -f — allows RRDtool to overwrite the destination RRD. use the force, but like, responsibly. 💅

Now, pipe mode tea ☕: in order to support the restore command in pipe mode (especially when using RRDtool over a network connection), when you're using - as a filename, the end of the file can be signaled either by closing the data channel after the file has transferred — as would be the case when using input redirection within a suitable shell — or by sending a crtl-Z / newline combination. this allows one to send more commands to the RRDtool server after a restore. so iconic for network stuff. 🌐✨

🫶 AUTHOR 🫶

Tobias Oetiker <tobi@oetiker.ch> wrote this one. absolute icon. 💜

💖 that's the whole page, bestie — this is rrdtool version 1.11.0, dated 2026-10-17. mwah 💋✨