RDUP-UP(1)

📦
version 1.1.15 · 2 versions
, in nixos 26.05, ubuntu jammy, ubuntu noble

✨ RDUP-UP(1) ✨

okay bestie, so this is rdup-up from the rdup manual, and it's genuinely one of my faves 💖

🎀 NAME 🎀

rdup-up — update a directory tree with a rdup archive. literally that's the whole vibe.

🌸 SYNOPSIS 🌸

rdup-up [OPTION]...  DIRECTORY

🦋 DESCRIPTION 🦋

So with rdup-up you can update an (possibly) existing directory structure with a rdup archive. that's it. that's the job. no cap. 👑

important!! the rdup archive has to be given to rdup-up's standard input. like, stdin, not a filename argument. iykyk.

💜 Username and uids 💜

rdup outputs both the user name and uid, and the receiving system (which may be a totally different system, like bestie you never know) checks if the user name and uid match. if the user name and uid don't match, the (numeric) uid is used on the file. same energy for the group name and gid. periodt.

🫶 File ownership 🫶

Because rdup supports backups via SSH, this situation can lowkey happen: locally rdup is run as root, but rdup-up is run as a non-root user (the one logged in via SSH). in that case the original owner- and group name can not be set. if this happens rdup-up will create a ._rdup_. file which contains the user/group information — also see the -u flag for rdup-tr (and rdup). it's giving "sorry i couldn't chown, here's a note instead" 💀

🔥 OPTIONS 🔥

  • -n — do a dry-run and do not create anything on disk. window shopping only, we're not buying 🛍️
  • -t — create DIRECTORY (ala mkdir -p) if it does not exist.
  • -s N — strip N path components from a pathname. if the resulting pathname is empty after this operation it is skipped. but be careful though, because of the following structure:
/foo
/foo/bar
/foo/bar/bla.txt
/foo/blork/bla.txt

with rdup-up -s2 this will leave:

<empty>
<empty>
/bla.txt
/bla.txt

and the last bla.txt will over write the previous one, this will happen without warnings. 😭 not me warning you right now though. this is a silent overwrite situation, bestie, so pay attention.

  • -r PATH — this option is related to the -s option, but works different. the string PATH is removed from (the beginning of) each pathname. with -r /home/backup the pathname /home/backup/bin/mycmd becomes /bin/mycmd. the same could be done with -s 2, but then you need to count the slashes. note -s is always performed before -r. 🧚
  • -v — be more verbose and echo the processed files to standard output. she's chatty and we love that for her ✨
  • -T — show a table of contents of the rdup stream received (ala tar -tf -). with -T the directory argument is optional. -T unsets any verbose (-v) options. 💅
  • -u — do not create a ._rdup_. file which contains user/group information when failing to chown the actual file or directory. useful when restoring a backup when you do not want to see ._rdup._-files being created.
  • -q — silence chown failures even when running as root. this can be helpful when the file system does not implement chown or disallows it (sshfs for instance). shhh, no drama, no errors 🌈
  • -h — a short help message.
  • -V — show the version.

⭐ EXIT CODE ⭐

rdup-up return a zero exit code on success, otherwise 1 is returned. zero = slay, one = not slay. 🎀

👑 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(1), rdup-tr(1) and rdup-backups(7).

Copyright (C) 2005-2010 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.

and that's the whole page bestie!! this is version 1.1.14, dated 13 Dec 2008 — vintage but iconic, we stan a classic 🫶✨

📦 where this page comes from