Linux rsync command with practical examples


Overview :

Rsync  is a fast and extraordinarily versatile file copying tool.  It can copy locally, to/from another host over any remote shell, or to/from a remote rsync daemon.  It offers a large number of options that control every aspect of its behavior  and permit  very  flexible specification of the set of files to be copied.  It is famous for its delta-transfer algorithm, which reduces the amount of data sent over the network by sending only the differences between the source files and  the  existing files in the destination.  Rsync is widely used for backups and mirroring and as an improved copy command for everyday use.

Rsync  finds  files  that need to be transferred using a "quick check" algorithm (by default) that looks for files that have changed in size or in last-modified time.  Any changes in the other preserved attributes (as requested by options) are  made on the destination file directly when the quick check indicates that the file’s data does not need to be updated.

Some of the additional features of rsync are:
  • support for copying links, devices, owners, groups, and permissions
  • exclude and exclude-from options similar to GNU tar
  • a CVS exclude mode for ignoring the same files that CVS would ignore
  • can use any transparent remote shell, including ssh or rsh
  • does not require super-user privileges
  • pipelining of file transfers to minimize latency costs
  • support for anonymous or authenticated rsync daemons (ideal for mirroring

Syntax :

# rsync options source destination

Some of the Commonly Used Options :

  • –delete : delete files that don't exist on sender (system)
  • -v : Verbose output
  • -e "ssh options" : specify the ssh as remote shell
  • -a : archive mode
  • -r : recurse into directories
  • -z : compress file data
Example : 1 Sync files & Directories on local system
[root@linux ~]# rsync -zvr /usr/  /root/sync-data/

Above Command will copy or sync all files & directories of /usr folder to /root/sync-data folder.

Example:2  Sync files Locally along with preserve permissions using “rsync -a”

-a options do the followings : it provide recursive features &  preserves permissions,symblic links,users & group information

[root@linux ~]# rsync -azv /usr/ /root/sync-data/


Example:3 Synchronize / Copy  Files From Local Machine to Remote Server
[root@linux ~]# rsync -avz /root/sync-data/ root@

Above command will copy the data of /root/syc-data folder  to the remote machine with the root user crendetails in /tmpfolder.

Example:4 Synchronize / Copy  Files From Remote Server to  Local Machine
[root@linux ~]# rsync -avz root@  /opt 
root@'s password: 
receiving file list ... done 
sent 38 bytes  received 99 bytes  10.96 bytes/sec 
total size is 0  speedup is 0.00

Above Command will copy remote server's /tmp/src folder to local machine's /opt folder.

Example:5 Remote synchronization Over SSH

rsync allows us to synchronize files to remote machine & vice versa over ssh i.e secure communication. Use "rsync -e ssh" to specify which remote shell to use. In our case, rsync will use ssh.

[root@localhost ~]# rsync -avz -e ssh root@  /opt 
The authenticity of host ' (' can't be established. 
RSA key fingerprint is 45:fc:99:57:34:ba:6a:bb:e3:6f:00:bb:ca:15:3d:c3. 
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '' (RSA) to the list of known hosts.
root@'s password: 
receiving file list ... done 
sent 422 bytes  received 12521670 bytes  115410.99 bytes/sec 
total size is 35467264  speedup is 2.83
Example:6 View Progress  while synchronization using "- -progress" option
[root@localhost ~]# rsync -avz  --progress root@   /opt 
root@'s password: 
receiving file list ... 
44609 files to consider 
usr/tmp -> ../var/tmp 
65 100%   63.48kB/s    0:00:00 (xfer#1, to-check=44605/44609) 
65 100%   63.48kB/s    0:00:00 (xfer#2, to-check=44604/44609) 
14519 100%  248.75kB/s    0:00:00 (xfer#3, to-check=44603/44609) 
14519 100%  232.44kB/s    0:00:00 (xfer#4, to-check=44602/44609)


Example:7 include & exclude options in rsync

rsync allows us to specify  the pattern that we want to include and exclude files or directories while doing synchronization.

# rsync -avz --include 'P*' --exclude '*' root@  /opt 
root@'s password: 
receiving file list ... done 
sent 129 bytes  received 9395561 bytes  695977.04 bytes/sec 
total size is 28999680  speedup is 3.09

In the above example, it includes only the files or directories starting with ‘P’  and excludes all other files. (using rsync exclude ‘*’ )

Example:8  Delete files at the target if the files are not Present at Source.

With the help of “–delete” option in rsync , we can delete the files created at the target if the same files are not present at source.

[root@localhost ~]# rsync -avz --delete root@  /opt


Example:9 View the Changes between Source & Target using “-i” option
[root@localhost ~]# rsync -avzi root@ /opt
 root@'s password:
 receiving file list ... done
 >f+++++++ .rpm.lock
 >f+++++++ Basenames
 >f+++++++ Conflictname
 >f+++++++ Dirnames
 >f+++++++ Filedigests
 >f+++++++ Group
 >f+++++++ Installtid
 >f+++++++ Name
 >f+++++++ Obsoletename
 >f+++++++ Requirename
 >f+++++++ Requireversion
 >f+++++++ Sha1header
 >f+++++++ Sigmd5
 >f+++++++ Triggername
sent 328 bytes  received 3126214 bytes  297765.90 bytes/sec
total size is 35467264  speedup is 11.34


Example:10 Limit the transfer file  size  using “- -max-size”

You can force rsync not to transfer files that are greater than a specific size using “–max-size” option.

[root@localhost ~]# rsync -avz --max-size='200k' root@ /opt

Above command makes rsync to transfer only the files that are less than or equal to 200K. We can indicate M for megabytes and G for gigabytes.