Ubuntu Manpage: rdup-simple - 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

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

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.