rsync (remote sync) is an open source utility used for synchronizing files and directories between two different systems, providing fast incremental file transfer. It is a great tool to perform backups.
Basic usage
To sync the contents of source directory(dir1) to a destination directory(dir2) on the same system:
rsync -a dir1/ dir2
To sync the contents of a local directory(dir1) to a remote directory(dir2):
rsync -a dir1/ username@remote_host:dir2
To sync the contents of a local directory(dir1) to a remote directory(dir2), when using a SSH identity file (private key) for public key authentication:
rsync -e "ssh -i keypair.pem" -a dir1/ username@remote_host:dir2
Verbose (--verbose, -v)
By default, rsync works silently. This option allows you to see what's happening during the transfer, even if no files are transfered.
rsync -v dir1/ dir2
$ rsync -v dir1/ livia@192.168.1.2:remote_dir
livia@192.168.1.2's password:
skipping directory .
sent 16 bytes received 12 bytes 6.22 bytes/sec
total size is 0 speedup is 0.00
$
Archive (--archive, -a)
It is a quick way of saying you want to preserve almost everything.
rsync -a dir1/ dir2
$ rsync -av dir1/ livia@192.168.1.2:remote_dir
sending incremental file list
./
file1
file2
file3
sent 2,183 bytes received 589 bytes 792.00 bytes/sec
total size is 498 speedup is 0.18
$
Recursive (--recursive, -r)
This tells rsync to copy directories recursively.
rsync -r dir1/ dir2
$ rsync -rav dir1/ livia@192.168.1.2:remote_dir
sending incremental file list
subdir1/
subdir1/subfile1
subdir1/subfile2
subdir1/subfile3
sent 391 bytes received 77 bytes 133.71 bytes/sec
total size is 83 speedup is 0.18
$
DISCLAIMER: Noticed that there is a trailing slash (/) at the end of the first argument in dir1/
This is necessary to mean the contents of dir1. The alternative, without the trailing slash, would place dir1, including the directory, within dir2. This would create a hierarchy that looks like: ~/dir2/dir1/[files]
Compare this output with the trailing slash:
$ rsync -rav dir1/ livia@192.168.1.2:remote_dir
sending incremental file list
./
file1
file2
file3
subdir1/
subdir1/subfile1
subdir1/subfile2
subdir1/subfile3
sent 534 bytes received 145 bytes 194.00 bytes/sec
total size is 83 speedup is 0.12
$ tree remote_dir/
remote_dir/
file1
file2
file3
subdir1
subfile1
subfile2
subfile3
1 directory, 6 files
livia@antix1:~
$
And when we remove the trailing slash:
$ rsync -rav dir1 livia@192.168.1.2:remote_dir
sending incremental file list
dir1/
dir1/file1
dir1/file2
dir1/file3
dir1/subdir1/
dir1/subdir1/subfile1
dir1/subdir1/subfile2
dir1/subdir1/subfile3
sent 850 bytes received 260 bytes 246.67 bytes/sec
total size is 83 speedup is 0.07
$ tree remote_dir/
remote_dir/
dir1
file1
file2
file3
subdir1
subfile1
subfile2
subfile3
2 directories, 6 files
livia@antix1:~
$
You can see here that the directory itself is transferred.
Update (--update, -u)
This forces rsync to skip any files which exist on the destination and have a modified time that is newer than the source file.
rsync -u dir1/ dir2
Notice how the size and modified date changes from 83 Nov 26 16:56 file1 to 677 Nov 27 14:10 file1.
$ ls -lh remote_dir/
total 8.0K
-rw-rw-r-- 1 livia livia 83 Nov 26 16:56 file1
-rw-rw-r-- 1 livia livia 0 Nov 26 15:58 file2
-rw-rw-r-- 1 livia livia 0 Nov 26 15:58 file3
drwxrwxr-x 2 livia livia 4.0K Nov 27 13:42 subdir1
$ rsync -rauv dir1/ livia@192.168.1.2:remote_dir
livia@192.168.1.2's password:
sending incremental file list
./
file1
sent 934 bytes received 45 bytes 217.56 bytes/sec
total size is 677 speedup is 0.69
$ ls -lh remote_dir/
total 8.0K
-rw-rw-r-- 1 livia livia 677 Nov 27 14:10 file1
-rw-rw-r-- 1 livia livia 0 Nov 26 15:58 file2
-rw-rw-r-- 1 livia livia 0 Nov 26 15:58 file3
drwxrwxr-x 2 livia livia 4.0K Nov 27 13:42 subdir1
$
Dry Run (--dry-run, -n)
This makes rsync perform a trial run that doesn't make any changes (and produces mostly the same output as a real run). Good resource to test the parameters before doing a big transfer.
rsync -n dir1/ dir2
$ rsync -rauvn dir1/ livia@192.168.1.2:remote_dir
sending incremental file list
./
file1
file2
file3
subdir1/
subdir1/subfile1
subdir1/subfile2
subdir1/subfile3
sent 235 bytes received 41 bytes 78.86 bytes/sec
total size is 677 speedup is 2.45 (DRY RUN)
$ tree remote_dir/
remote_dir/
0 directories, 0 files
livia@antix1:~
$
Progress (--progress, -P)
This option tells rsync to print information showing the progress of the transfer.
rsync -P dir1/ dir2
$ rsync -rauvP dir1/ livia@192.168.1.2:remote_dir
sending incremental file list
./
big-file
67,562,098 100% 1.16MB/s 0:00:55 (xfr#1, to-chk=7/9)
sent 67,562,098 bytes received 100 bytes 945,162.08 bytes/sec
total size is 67,562,198 speedup is 1.00
$
More about rsync can be found at the manual page.
Top comments (0)