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" -m -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 Doxygen-1.9.6 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-3.2.7/api &&
install -v -m644 dox/html/* /usr/share/doc/rsync-3.2.7/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
Configuration Information
For client access to remote files, you may need to install the
OpenSSH-9.2p1 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
https://rsync.samba.org/documentation.html.
Boot Script
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
to run the
rsync client.
Install the
/etc/rc.d/init.d/rsyncd
init script
included in the
blfs-bootscripts-20230101
package.
make install-rsyncd