DragonFly On-Line Manual Pages

RDUP-UP(1)                           rdup                           RDUP-UP(1)

NAME
       rdup-up - update a directory tree with a rdup archive

SYNOPSIS
       rdup-up [OPTION]...  DIRECTORY

DESCRIPTION
       With rdup-up you can update an (possibly) existing directory structure
       with a rdup archive.

       The rdup archive has to be given to rdup-up's standard input.

   Username and uids
       rdup outputs both the user name and uid, the receiving system (which
       may be a totally different system) checks if the user name and uid
       match. If the user name and uid don't match the (numeric) uid is used
       on the file. The same holds true for the group name and gid.

   File ownership
       As rdup supports backups via SSH the following situation can occur:
       locally rdup is run a root, but rdup-up is run as a non-root user (the
       one logged in via SSH). In this case the original owner- and group name
       can not be set. If this happens rdup-up will create a ._rdup_. file
       which contains the user/group information, also see the -u flag for
       rdup-tr (and rdup).

OPTIONS
       -n     Do a dry-run and do not create anything on disk.

       -t     Create DIRECTORY (ala mkdir -p) if it does not exist.

       -s N   Strip N path components from a pathname. If the resulting
              pathname is empty after this operation it is skipped. Be careful
              however with the following structure:

                  /foo
                  /foo/bar
                  /foo/bar/bla.txt
                  /foo/blork/bla.txt

              With rdup-up -s2 this will leave:

                  <empty>
                  <empty>
                  /bla.txt
                  /bla.txt

              And the last 'bla.txt' will over write the previous one, this
              will happen without warnings.

       -r PATH
              This option is related to the -s option, but works different.
              The string PATH is removed from (the beginning of) each
              pathname. With -r /home/backup the pathname
              /home/backup/bin/mycmd becomes /bin/mycmd. The same could be
              done with -s 2, but then you need to count the slashes. Note -s
              is always performed before -r.

       -v     Be more verbose and echo the processed files to standard output.

       -T     Show a table of contents of the rdup stream received (ala tar
              -tf -).  With -T the directory argument is optional. -T unsets
              any verbose (-v) options.

       -u     Do not create a ._rdup_. file which contains user/group
              information when failing to chown the actual file or directory.
              Useful when restoring a backup when you do not want to see
              ._rdup._-files being created.

       -q     Silence 'chown' failures even when running as root. This can be
              helpful when the file system does not implement 'chown' or
              disallows it ('sshfs' for instance).

       -h     A short help message.

       -V     Show the version.

EXIT CODE
       rdup-up return a zero exit code on success, otherwise 1 is returned.

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(1), rdup-tr(1) and rdup-backups(7).

COPYRIGHT
       Copyright (C) 2005-2010 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.

1.1.14                            13 Dec 2008                       RDUP-UP(1)