Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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: lo-
       cally 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	 path-
	      name  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	 path-
	      name.  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 be-
	      fore -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 informa-
	      tion  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  dis-
	      allows 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 PUR-
       POSE.

       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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT CODE | AUTHOR | REPORTING BUGS | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=rdup-up&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help