GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  RDUP-UP (1)

NAME

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

CONTENTS

Synopsis
Description
     Username and uids
     File ownership
Options
Exit Code
Author
Reporting Bugs
See Also
Copyright

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.

Search for    or go to Top of page |  Section 1 |  Main Index


1.1.14 RDUP-UP (1) 13 Dec 2008

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.