RDUP(1) rdup RDUP(1)NAMErdup-simple - create a hardlinked backup
SYNOPSISrdup-simple [+DAYS] -[-Pcmd,opt1,...,opt7]... [OPTION]... FILELIST
[DIR/FILE]... DESTINATION
DESCRIPTIONrdup-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 fol‐
lowing 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 file:///directory Use '/directory' to store the
backup, 'file://' is optional. Note: there are 3 slashes here. /direc‐
tory 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/$HOST‐
NAME
~ 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 spe‐
cific 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 per‐
formed.
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,opt0,...,opt6
Filter all output through command. opt0 through opt6 are given
as options to the command. Multiple -P's can be used, there is
however a maximum of seven options for each command. The options
are separated with commas, there must be no space in between.
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
Copyright (C) 2005-2011 Miek Gieben. This is free software. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
POSE.
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.
1.1.14 24 Dec 2005 RDUP(1)
