====== rsync ======

  * [[Filename Exclusions]]
  * [[rsyncd]]

** rsync and slashes **

Rsync will do things differently based on how you add a slash to the source.

Let's say you have two directories: ''src'' and ''dest'', and that ''src'' has a file named ''document.txt'' in it.

You have two options: Use rsync to copy the entire folder of src **with** its contents, or copy the contents **alone** without the folder.

Here's how each would look:

Copy the entire directory:

<code>
rsync -r src dest
ls dest/src/document.txt
</code>

Copy the contents of the directory:

<code>
rsync -r src/ dest
ls dest/document.txt
</code>

Use the second example if you want to copy all files, **including** dot files in the directory.

If you want to ignore the dotfiles, then use an ''*'' to exclude those:

<code>
touch src/.dotfile.txt
rsync -r src/* dest
</code>

**Copy files to keep them as close to the original as possible**

<code>
rsync --archive --times foo:src/bar /data/tmp
</code>

**Add some options for large transfers**

Keep a log of transfers

<code>
rsync --log-file=/tmp/rsync.log
</code>

== Display progress ==

<code>
rsync --progress
</code>

== Compress as copying files ==

<code>
rsync --compress
</code>

== Exclude files ==

<code>
rsync --exclude 'foo-bar*'
</code>

== Exclude files and delete them on the destination ==

<code>
rsync --exclude 'foo-bar*' --delete-excluded
</code>

== Specify rsync path ==

When using SSH to connect to a remote server, it will drop the PATH to ''/bin:/usr/bin'' by default.  If rsync is not in that path, set the path manually:

<code>
rsync --rsync-path=/usr/local/bin/rsync
</code>