Beyond Linux® From Scratch - Version 7.4

Chapter 15. Networking Programs

rsync-3.0.9

Introduction to rsync

The rsync package contains the rsync utility. This is useful for synchronizing large file archives over a network.

This package is known to build and work properly using an LFS-7.4 platform.

Package Information

rsync Dependencies

Recommended

popt-1.16

Optional

attr-2.4.47 and acl-2.2.52

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/rsync

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 &&
make

If you have Doxygen-1.8.5 installed and wish to build HTML API documentation, issue doxygen.

If you have DocBook-utils-0.6.14 installed and wish to build the user documentation, issue any or all of the following commands: 

pushd doc &&
docbook2pdf             rsync.sgml &&
docbook2ps              rsync.sgml &&
docbook2dvi             rsync.sgml &&
docbook2txt             rsync.sgml &&
docbook2html --nochunks rsync.sgml &&
popd

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-3.0.9/api &&
install -v -m644 dox/html/*  /usr/share/doc/rsync-3.0.9/api &&
install -v -m644 doc/rsync.* /usr/share/doc/rsync-3.0.9

Configuring rsync

Config Files

/etc/rsyncd.conf

Configuration Information

For client access to remote files, you may need to install the OpenSSH-6.3p1 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 http://rsync.samba.org/documentation.html.

Boot Script

Note that you only want to start the rsync server if you want to provide an rsync archive on your local machine. You don't need this script to run the rsync client.

Install the /etc/rc.d/init.d/rsyncd init script included in the blfs-bootscripts-20130908 package. 

make install-rsyncd

Contents

Installed Program: rsync
Installed Libraries: None
Installed Directories: Optionally, /usr/share/doc/rsync-3.0.9

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.

Last updated on 2013-08-27 06:13:39 -0700