%general-entities; ]> $LastChangedBy$ $Date$ rsync-&rsync-version; rsync Introduction to rsync The rsync package contains the rsync utility. This is useful for synchronizing large file archives over a network. &lfs91_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &rsync-md5sum; Download size: &rsync-size; Estimated disk space required: &rsync-buildsize; Estimated build time: &rsync-time; rsync Dependencies Recommended Optional , lz4, and xxhash User Notes: Installation of rsync For security reasons, running the rsync server as an unprivileged user and group is encouraged. If you intend to run rsync as a daemon, create the rsyncd user and group with the following commands issued by the root user: groupadd -g 48 rsyncd && useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd \ -s /bin/false -u 48 rsyncd Install rsync by running the following commands: ./configure --prefix=/usr \ --disable-lz4 \ --disable-xxhash \ --without-included-zlib && make If you have installed and wish to build HTML API documentation, issue: doxygen To test the results, issue: make check. Now, as the root user: make install If you built the documentation, install it using the following commands as the root user: install -v -m755 -d /usr/share/doc/rsync-&rsync-version;/api && install -v -m644 dox/html/* /usr/share/doc/rsync-&rsync-version;/api Command Explanations --disable-lz4: This switch disables LZ4 compression support. Note that it uses the superior 'zstd' algorithm when this switch is in use, and zstd is provided in LFS. --disable-xxhash: This switch disables advanced xxhash checksum support. Remove this switch if you have installed xxhash. --without-included-zlib: This switch enables compilation with the system-installed zlib library. Configuring rsync Config Files /etc/rsyncd.conf /etc/rsyncd.conf Configuration Information For client access to remote files, you may need to install the package to connect to the remote server. This is a simple download-only configuration to set up running rsync as a server. See the rsyncd.conf(5) man-page for additional options (i.e., user authentication). cat > /etc/rsyncd.conf << "EOF" # This is a basic rsync configuration file # It exports a single module without user authentication. motd file = /home/rsync/welcome.msg use chroot = yes [localhost] path = /home/rsync comment = Default rsync module read only = yes list = yes uid = rsyncd gid = rsyncd EOF You can find additional configuration information and general documentation about rsync at . <phrase revision="sysv">Boot Script</phrase> <phrase revision="systemd">Systemd Unit</phrase> Note that you only need to start the rsync server if you want to provide an rsync archive on your local machine. You don't need this script unit to run the rsync client. Install the /etc/rc.d/init.d/rsyncd init script rsyncd.service unit included in the package. make install-rsyncd This package comes with two types of units: A service file and a socket file. The service file will start rsync daemon once at boot and it will keep running until the system shuts down. The socket file will make systemd listen on rsync port (Default 873, needs to be edited for anything else) and will start rsync daemon when something tries to connect to that port and stop the daemon when the connection is terminated. This is called socket activation and is analogous to using {,x}inetd on a SysVinit based system. By default, the first method is used - rsync daemon is started at boot and stopped at shutdown. If the socket method is desired, you need to run as the root user: systemctl stop rsyncd && systemctl disable rsyncd && systemctl enable rsyncd.socket && systemctl start rsyncd.socket Note that socket method is only useful for remote backups. For local backups you'll need the service method. Contents Installed Program Installed Libraries Installed Directories rsync and rsync-ssl None Optionally, /usr/share/doc/rsync-&rsync-version; Short Descriptions rsync is a replacement for rcp (and scp) that has many more features. It uses the rsync algorithm which provides a very fast method of syncing remote files. It does this by sending just the differences in the files across the link, without requiring that both sets of files are present at one end of the link beforehand. rsync rsync-ssl is a helper script used when connecting to an rsync daemon that has SSL support built in. rsync-ssl