rdup-simple(8) - Linux man page

Name

rdup-simple - create a hardlink backup

Synopsis

rdup-simple [ +DAYS ] [ OPTIONS ] DIR|FILE [ 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

-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.