RDUP(1)

📦
version 1.1.15 · 3 versions
, in ubuntu jammy, ubuntu noble

🌸 rdup-simple 🌸

okay so welcome to RDUP(1) bestie — this is the manual page for rdup-simple, and it lives in section 1 under the name <rainbow>rdup</rainbow>. pull up a chair, we're making backups today 💖

✨ NAME ✨

rdup-simple — create a hardlinked backup 💅

🦋 SYNOPSIS 🦋

rdup-simple [+DAYS] -[-P CMD]...  [OPTION]...  FILELIST [DIR/FILE]...
DESTINATION
fr fr that's the whole shape of it. copy it character for character, i'm not playing 🙈

👑 DESCRIPTION 👑

so rdup-simple is a frontend for rdup-snap and rdup. it will back up every single directory and file you give it on the command line, and it creates a hardlinked backup directory — that's where the backup actually lives. slay.

the optional +DAYS argument? that's you telling rdup-simple how far back to look for previous backups. it's gotta be a number in the range 1..99, and it defaults to 8 days. no cap.

rdup-simple will create the directory ~/.rdup and store its administrative files in there. and guess what — this program does not need to be run with root permissions. periodt 👑

the last argument of rdup-simple is used as the destination, and here's the whole lineup of what's supported:

  • ssh:///user@host/directory — use ssh as a protocol and user as the remote user name. store the backup in directory on the remote server host.
  • ssh://host/directory — use ssh as a protocol and the current username as the remote user name. store the backup in directory on the remote server host.
  • file:///directory — use /directory to store the backup, file:// is optional.
note: there are 3 slashes here. i said what i said 💅
  • /directory — use /directory to store the backup.
  • directory — use directory in the current directory for the backup.

🎀 Making a backup 🎀

making a backup is as simple as:

rdup-simple ~ /adm /vol/backup/$HOSTNAME

~ and /adm are the directories to be backed up — and yes, multiple directories or files are allowed on the command line, go off 🫶

the backup will be stored in /vol/backup/$HOSTNAME.

for the backup a YYYYMM directory is created, and inside that directory the specific day-dumps get placed. so the first dump in October 2006 gets created in 200610/01, and the second in 200610/02, etc. iconic scheduling ngl 📅

you can use incremental dumps for ever — there is literally no need to do a full dump every once in a while. obsessed.

note that rdup-simple calls rdup-snap-link. this small utility is the one that actually hardlink copies the previous backup. the return value of rdup-snap-link is what determines if a full or an incremental dump will be performed. iykyk.

🌈 Remote backups 🌈

note: for remote backups to work, the receiving machine must have rdup installed. also note: there is no colon between the hostname and the directory. 💀

remote backup will create a pipeline of the form:

rdup -c DIR|FILE | ssh user@remotehost
rdup-shapshot -c -b backupdir

there is no provisioning for ssh, so unless you have configured ssh to work without a passphrase you will be asked to supply one 🙈 also note that the PATH on the remote host should be set in such a way that all the rdup-util scripts can be found.

✨ OPTIONS ✨

  • -Pcommand — filter all output through command, which is called via sh -c command. multiple -P's can be used 🎀

🫶 AUTHOR 🫶

Written by Miek Gieben 💖

🐛 REPORTING BUGS 🐛

Report bugs to <miek@miek.nl>.

🌟 SEE ALSO 🌟

http:/www.miek.nl/projects/rdup is the main site of rdup. also see rdup-tr(1), rdup-up(1) and rdup-backups(7).

Copyright (C) 2005-2011 Miek Gieben. this is free software. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

licensed under the GPL version 3. see the file LICENSE in the source distribution of rdup.

🍓 rdup-simple [ +DAYS ] [ OPTIONS ] DIR|FILE [ DIR|FILE ] DESTINATION 🍓

Description

(the original leaves this one blank, bestie — no notes 🙈)

Options

  • -k keyfile — encrypt the files while backing up with keyfile. this option inserts rdup-crypt keyfile in the pipeline 🔐
  • -a — enable extended attributes. write the uid/gid to the extended user attributes r_uid and r_gid.
  • -f — force a full dump.
  • -x — see -x in rdup(8).
  • -z — compress the files while backing up. this option inserts rdup-gzip in the pipeline.
  • -v — echo the files processed to standard error.
  • -h — show a short help message.
  • -V — show the version.

See Also

rdup(8), rdup-snap-link(8) and rdup-snapshot(8). see rdup-backups(8) for examples and an introduction into making backups with rdup.

and that's the whole page, bestie 🦋 this is rdup version 1.1.14, dated 24 Dec 2005, and it's page RDUP(1) — go forth and hardlink 💖🌸👑

📦 where this page comes from