Re: [Duplicity-talk] Could you document the various URL syntaxes?

[Kenneth Loafman]

Eric Hanchrow wrote:
> As soon as I upgraded to 0.4.8, things stopped working, because I'd
> gotten the syntax for an rsync backup wrong.  (It had worked for
> 0.4.7).  Up until now, I've pretty much made up my URLs at random,
> stopping when I stumble onto something that worked; I've gotten some
> help by adding extra calls to "log.Log" in various places in the code,
> to observe how they're parsed.
> 
> Anyway, for 0.4.7, I used these URLs for my rsync backups:
> 
>     rsync://address@hidden/home/erich/dups/
>     rsync://address@hidden/Users/erich/dups/
> 
> Through trial and error, I see that for 0.4.8 the proper syntax is
> 
>     rsync://address@hidden:dups/
>     rsync://address@hidden:dups/
> 
> Could you please document the rsync syntax -- and for that matter, the
> others -- so that we no longer have to guess?

I don't intend for you to have to guess.

The formats are documented in the man page and in the help screen, with
the exception of the added ability to add a password in the URL.  On any
URL that is of the form 'address@hidden' the URL can now contain a password
in the form of 'user:address@hidden'.

There was indeed a change to the rsync protocol.  Alexander Zangerl
(Debian maint) just sent this note to me about rsync and a couple of
helpful patches.

I'll incorporate these changes and doc updates into the next release.  I
will also add an rsync w/module test to the unit tests.

...Thanks,
...Ken

Alexander Zangerl wrote:
> thanks. i've tested 0.4.7 for a few days, looks ok and 
> uploaded it to the debian repositories. 
> i had to add two patches of my own:
> 
> * the new url parser has (legitimate but minor) troubles with 
>   rsync module urls. i've added the following note to the
>   debian version:
> 
>   old-style rsync urls with modules (and only with modules!)
>     must be written differently now, because the new url parser 
>     library is stricter than before (and because rsync's way
>     of saying "module please!" by ending the hostname with
>     a colon is not rfc-compliant).
>   
>     a url referring to module modname on bhost for versions < 0.4.7 
>     would have looked like
>   
>         rsync://address@hidden:/modname/somedir
>   
>     and now must be written as
>   
>         rsync://address@hidden::/modname/somedir
> 
>   i also fixed the url example given in the help text to
>   display this kind of url.
> 
> --- duplicity-0.4.7~/src/commandline.py 2007-12-08 01:28:51.000000000 +1000
> +++ duplicity-0.4.7/src/commandline.py  2007-12-12 14:03:25.883808520 +1000
> @@ -270,7 +270,7 @@
>         ftp://address@hidden/some_dir
>         hsi://address@hidden/some_dir
>         file:///some_dir
> -       rsync://address@hidden:/module/some_dir
> +       rsync://address@hidden::/module/some_dir
>         rsync://address@hidden/some_non_module_path
>         s3://host/bucket_name[/prefix]
>         s3+http://bucket_name[/prefix]
> 
>

signature.asc
Description: OpenPGP digital signature