Ignore:
Timestamp:
06/13/2004 05:38:30 AM (20 years ago)
Author:
DJ Lucas <dj@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
60384c68
Parents:
08254fc
Message:

Part VI xml update + bz815

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2307 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/other/rsync.xml

    r08254fc r0931098  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY rsync-download-http "http://rsync.samba.org/ftp/rsync/rsync-&rsync-version;.tar.gz">
     8<!ENTITY rsync-download-ftp "ftp://gd.tuwien.ac.at/utils/admin-tools/rsync/rsync-&rsync-version;.tar.gz">
     9<!ENTITY rsyncd-size "504 KB">
     10<!ENTITY rsync-buildsize "6.5 MB">
     11<!ENTITY rsyncd-time "0.20 SBU">
     12
     13]>
     14
    115<sect1 id="rsync" xreflabel="rsync-&rsync-version;">
    216<?dbhtml filename="rsync.html"?>
    317<title>rsync-&rsync-version;</title>
    418
    5 &rsync-intro;
    6 &rsync-inst;
    7 &rsync-config;
    8 &rsync-desc;
     19<sect2>
     20<title>Introduction to <application>rsync</application></title>
     21
     22<para>The <application>rsync</application> package contains the
     23<command>rsync</command> utility. This is useful for synchronizing large file
     24archives over a network.</para>
     25
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&rsync-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&rsync-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &rsyncd-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &rsync-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &rsyncd-time;</para></listitem></itemizedlist>
     33</sect3>
     34
     35<sect3><title><application>rsync</application> dependencies</title>
     36<sect4><title>Optional</title>
     37<para>
     38<xref linkend="popt"/>
     39</para></sect4>
     40</sect3>
     41
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application>rsync</application></title>
     46
     47<para>For security reasons, running the <application>rsync</application> server as
     48an unprivileged user and group is encouraged.  Create the rsyncd user
     49and group with the following commands:</para>
     50
     51<screen><userinput><command>groupadd rsyncd &amp;&amp;
     52useradd -c rsyncd -d /home/rsync -g rsyncd -s /bin/false rsyncd</command>
     53</userinput></screen>
     54
     55<para>Install <application>rsync</application> by running the following
     56commands:</para>
     57
     58<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     59make &amp;&amp;
     60make install </command></userinput></screen>
     61
     62</sect2>
     63
     64<sect2>
     65<title>Configuring <application>rsync</application></title>
     66
     67<sect3><title>Config files</title>
     68<para><filename>/etc/rsyncd.conf</filename></para>
     69</sect3>
     70
     71<sect3><title>Configuration Information</title>
     72
     73<para>This is a simple download-only configuration. See the rsyncd man-page for
     74additional options (i.e., user authentication).</para>
     75
     76<screen><userinput><command>cat &gt; /etc/rsyncd.conf &lt;&lt; "EOF"</command>
     77# This is a basic rsync configuration file
     78# It exports a single module without user authentication.
     79
     80motd file = /home/rsync/welcome.msg
     81use chroot = yes
     82
     83[localhost]
     84    path = /home/rsync
     85    comment = Default rsync module
     86    read only = yes
     87    list = yes
     88    uid = rsyncd
     89    gid = rsyncd
     90
     91<command>EOF</command></userinput></screen>
     92</sect3>
     93
     94<sect3><title>rsyncd init.d script</title>
     95
     96<para>Note that you only want to start the <application>rsync</application>
     97server if you want to provide a <application>rsync</application> archive on
     98your machine. The <application>rsync</application> client doesn't need this
     99script to be used.</para>
     100
     101<para>Install the <filename>/etc/rc.d/init.d/rsyncd</filename>
     102init script included in the <xref linkend="intro-important-bootscripts"/> package.</para>
     103                                                                                                               
     104<screen><userinput><command>make install-rsyncd</command></userinput></screen>
     105
     106</sect3>
     107
     108</sect2>
     109
     110<sect2>
     111<title>Contents</title>
     112
     113<para>The <application>rsync</application> package contains <command>rsync</command>.</para>
     114
     115</sect2>
     116
     117<sect2><title>Description</title>
     118
     119<sect3><title>rsync</title>
     120<para><application>rsync</application> is a replacement for <command>rcp
     121</command> (and <command>scp</command>) that has many more features. It
     122uses the "rsync algorithm" which provides a very fast method of syncing remote
     123files. It does this by sending just the differences in the files across the
     124link, without requiring that both sets of files are present at one end
     125of the link beforehand.</para></sect3>
     126
     127</sect2>
    9128
    10129</sect1>
Note: See TracChangeset for help on using the changeset viewer.