DragonFly On-Line Manual Pages

Search: Section:  

RDUP(1)                              rdup                              RDUP(1)


NAME

       rdup-simple - create a hardlinked backup


SYNOPSIS

       rdup-simple [+DAYS] -[-Pcmd,opt1,...,opt7]...  [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 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,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
       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.

1.1.14                            24 Dec 2005                          RDUP(1)

Search: Section: