RDIFF-BACKUP-STATISTICS(1)

💖 rdiff-backup-statistics(1) 💖

okay bestie, welcome to the Rdiff-Backup-Statistics Manual, version 2.2.6 — yes that's the manual name, we're keeping it, slay. this is the little page that tells you how to summarise your rdiff-backup stats files and honestly? it's giving main character energy for your backups. 🦋

---

✨ NAME ✨

rdiff-backup-statistics — summarize rdiff-backup statistics files 🎀

---

🌸 SYNOPSIS 🌸

rdiff-backup-statistics [--begin-time time] [--end-time time]
[--minimum-ratio ratio] [--null-separator] [--quiet] [-h|--help]
[-V|--version] repository

---

💅 DESCRIPTION 💅

so here's the vibe: rdiff-backup-statistics reads the matching statistics files inside a backup repository that was made by rdiff-backup, and then it prints some summary statistics right to your screen. and the best part? it does not alter the repository in any way. it just looks. respectfully. 👀✨

the required argument is the pathname of the root of an rdiff-backup repository. like, for instance — if you ran rdiff-backup in out, you could later run rdiff-backup-statistics out. see? cute, simple, no drama.

the output has two parts, and you're gonna want both:

1. the first part is literally just an average of all the matching session_statistics files. what do those fields even mean tho? it's explained in the FAQ included in the package, and also at https://rdiff-backup.net/FAQ.html#what_do_the_various_fields_mean_in_the_session_statistics_and_directory_statistics_files — go read it, it's giving ✨knowledge✨.
2. the second section lists some particularly significant files (directories count too, they're files in spirit 🫶). these files either contain a lot of data, take up increment space, or contain a lot of changed files. and every single file that's above the minimum ratio (default 5%) will be listed. no gatekeeping here.

okay and here's the little detail that makes it make sense: if a file or directory is listed, its contributions are subtracted from its parent. that's why the percentage listed after a directory can be larger than the percentage of its parent. without this trick, the root directory would always be the largest and the output would be boring. 💀 and we do not do boring. not on this account.

---

🌈 OPTIONS 🌈

• --begin-time time — do not read statistics files older than time. by default, all statistics files will be read. time should be in the same format taken by --restore-as-of. (peep TIME FORMATS in the rdiff-backup man page for the deets, iykyk.)
• --end-time time — like --begin-time but it excludes statistics files later than time. it's the other end of the time sandwich 🥪
• -h, --help — outputs a short usage description and exits. your little "what do i do" button, iconic.
• --minimum-ratio ratio — prints all directories contributing more than the given ratio to the total. the default value is .05, or 5 percent. lower it if you want more receipts.
• --null-separator — specifies that the lines of the file_statistics file are separated by nulls ('\0'). the default is to assume that newlines separate them. use this switch if rdiff-backup was run with the --null-separator when making the given repository. match the energy, bestie. 🧚
• --quiet — suppresses printing of the ‘Processing statistics from session...’ output lines. for when you want the results but not the commentary.
• -V, --version — outputs the full path to the command and the version, then exits. a little self-introduction. 💁‍♀️

---

😭 BUGS 😭

when aggregating multiple statistics files, some directories above (but close to) the minimum ratio may not be displayed. for this reason, you may want to set the minimum-ratio lower than need.

like, it's a real one. it's a known thing. don't come for us, just lower the ratio. 🙈

---

👑 AUTHOR 👑

Ben Escoto ben@emerose.org, based on original script by Dean Gaudet. legends, both of them. periodt. 💜

---

🍓 SEE ALSO 🍓

rdiff-backup(1), python(1). the rdiff-backup web page is at https://rdiff-backup.net/ 🌈⭐

---

and that's the whole page, bestie!! this was rdiff-backup-statistics from the Rdiff-Backup-Statistics Manual, version 2.2.6, dated September 2023. mwah, go forth and summarise your stats 💖🦋🌸🎀