rsbackup(1)

📦
version 10.0 · 3 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 rsbackup-snapshot-hook 💖

okay bestie, welcome to the rsbackup-snapshot-hook manual page — part of the rsbackup family, the rsync-based backup utility, and lowkey one of the most underrated little sidekicks in the whole backup saga. it does one job and it does it flawlessly, and honestly? iconic.

✨ SYNOPSIS ✨

rsbackup-snapshot-hook [OPTIONS]

that's it. that's the whole vibe. no subcommands, no drama, just options. 💅

🌸 DESCRIPTION 🌸

so here's the tea: rsbackup-snapshot-hook creates and removes LVM snapshots when you set it up as a pre- or post-volume-hook for rsbackup(1). it's the backstage crew of your backup show, fr fr. 🎀

now, it does not just snap everything it can see. snapshots will only be created for volumes that have a corresponding directory inside the snapshot directory. like, a snapshot gets created for the volume root if /var/lib/rsbackup/snapshots/root exists. cute, right? (and if you wanna move that snapshot directory somewhere else, that's what the --snaps option is for, bestie.) 🦋

important: those volumes must be stored in a logical volume. no logical volume, no snapshot, no exceptions, iykyk.

leftover snapshots? always unmounted and removed before creation. we do not tolerate stale clutter in this house. ✨

snapshots are only given a fraction of the size of the original volume — not the whole thing, just a lil slice. use the --divisor option if you want to change that ratio. 🌸

after creation, snapshots are fsck'd and mounted. and here's the part where you gotta be careful: if an error occurs in any part of the creation process, the partially created snapshot may be left in place — and it'll ultimately get torn down when the post-volume-hook is run. so like, not a forever problem, but also not nothing. 😭

👑 OPTIONS 👑

  • --snaps, -s PATH — sets the path to the snapshot directory. the default is /var/lib/rsbackup/snapshots. move it, own it. 🫶
  • --divisor, -d DIVISOR — sets the snapshot size ratio. the default is 5. math girlies rise up. 💜
  • --help, -h — displays the usage message. when you're lost, she's there. 💖
  • --version, -V — displays the version string. gotta know which era you're in. ⭐

🌈 SEE ALSO 🌈

go read those too, bestie, they're the main characters. this one's the supporting role that carries the whole plot. 🧚

🎀 AUTHOR 🎀

Richard Kettlewell <rjk@greenend.org.uk> — thank you for your service, king. 👑

and that's a wrap on the rsbackup(1) manual page, section 1 of the general commands manual. no version stamp, no date, just the section header holding it down at the bottom of every page like the true icon it is. slay, periodt. 💅✨

📦 where this page comes from