--- name: "rdup-simple" section: "1" platform: "linux" package: "rdup" version: "1.1.15-1" release: "Debian 10 (Buster)" platforms: ["linux"] url: "https://new.carta.tech/rdup-simple" --- # rdup-simple(1) create a hardlinked backup ## NAME rdup-simple - create a hardlinked backup ## SYNOPSIS **rdup-simple** \[*+DAYS*\] -\[*-P CMD*\]... \[*OPTION*\]... *FILELIST* \[*DIR/FILE\]...* DESTINATION ## DESCRIPTION rdup-simple is a frontend for 'rdup-snap' and 'rdup'. It will backup all directories and files given on the command line. It will create a hard linked backup directory, where the backup is created. With the optional +DAYS argument you can specify how far backup rdup-simple looks back for previous backups. This should be a number in the range 1..99. It defaults to 8 days. rdup-simple will create the directory '~/.rdup' and will store its administrative files there. This program does not need to be run with root permissions. The last argument of rdup-simple is used as the destination; the following destinations are 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. /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. Multiple directories or files are allowed on the command line. The backup will be stored in '/vol/backup/$HOSTNAME'. For the backup a YYYYMM directory is created. In this directory specific day-dumps are placed. So the first dump in October 2006, will created in 200610/01 and the second in 200610/02, etc. You can use incremental dumps for ever, there is no need to do a full dump every once in a while. Note that rdup-simple calls rdup-snap-link. This small utility will actually hardlink copy the previous backup. The return value of rdup-snap-link will determine if a full or incremental dump will be performed. 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 - **-P*command*** 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 \. ## SEE ALSO http:/www.miek.nl/projects/rdup is the main site of rdup. Also see [rdup-tr(1)](/rdup-tr/1.md), [rdup-up(1)](/rdup-up/1.md) and [rdup-backups(7)](/rdup-backups/7.md). ## COPYRIGHT 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 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.