linux-from-scratch/glfs
1
0
Fork 0
mirror of https://github.com/Zeckmathederg/glfs.git synced 2025-02-03 14:47:17 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Tagged rsync.xml

Browse Source 
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4361 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Manuel Canales Esparcia 2005-05-18 20:36:07 +00:00
parent 4d7ed6c583
commit 5ab6e72333
1 changed files with 131 additions and 87 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

218
server/other/rsync.xml
View File

@ -4,85 +4,107 @@
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY rsync-download-http "http://rsync.samba.org/ftp/rsync/rsync-&rsync-version;.tar.gz">
<!ENTITY rsync-download-ftp "ftp://ftp.samba.org/pub/rsync/rsync-&rsync-version;.tar.gz">
<!ENTITY rsyncd-md5sum "2beb30caafa69a01182e71c528fb0393">
<!ENTITY rsyncd-size "583 KB">
<!ENTITY rsync-buildsize "4.8 MB">
<!ENTITY rsyncd-time "0.17 SBU">
<!ENTITY rsync-download-http "http://rsync.samba.org/ftp/rsync/rsync-&rsync-version;.tar.gz">
<!ENTITY rsync-download-ftp "ftp://ftp.samba.org/pub/rsync/rsync-&rsync-version;.tar.gz">
<!ENTITY rsync-md5sum "2beb30caafa69a01182e71c528fb0393">
<!ENTITY rsync-size "583 KB">
<!ENTITY rsync-buildsize "4.8 MB">
<!ENTITY rsync-time "0.17 SBU">
]>
<sect1 id="rsync" xreflabel="rsync-&rsync-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="rsync.html"?>
<title><application>rsync</application>-&rsync-version;</title>
<?dbhtml filename="rsync.html"?>
<sect2>
<title>Introduction to <application>rsync</application></title>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<para>The <application>rsync</application> package contains the
<command>rsync</command> utility. This is useful for synchronizing large file
archives over a network.</para>
<title>rsync-&rsync-version;</title>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&rsync-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&rsync-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &rsyncd-md5sum;</para></listitem>
<listitem><para>Download size: &rsyncd-size;</para></listitem>
<listitem><para>Estimated disk space required:
&rsync-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&rsyncd-time;</para></listitem></itemizedlist>
</sect3>
<indexterm zone="rsync">
<primary sortas="a-rsync">rsync</primary>
</indexterm>
<sect3><title><application>rsync</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="popt"/></para>
</sect4>
</sect3>
<sect2 role="package">
<title>Introduction to rsync</title>
</sect2>
<para>The <application>rsync</application> package contains the
<command>rsync</command> utility. This is useful for synchronizing large
file archives over a network.</para>
<sect2>
<title>Installation of <application>rsync</application></title>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&rsync-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&rsync-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &rsync-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &rsync-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &rsync-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &rsync-time;</para>
</listitem>
</itemizedlist>
<para>For security reasons, running the <application>rsync</application>
server as an unprivileged user and group is encouraged. If you intend to
run <command>rsync</command> as a daemon, create the rsyncd user and group
with the following commands:</para>
<bridgehead renderas="sect3">rsync Dependencies</bridgehead>
<screen><userinput><command>groupadd rsyncd &amp;&amp;
useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd -s /bin/false rsyncd</command>
</userinput></screen>
<bridgehead renderas="sect4">Optional</bridgehead>
<para><xref linkend="popt"/></para>
<para>Install <application>rsync</application> by running the following
commands:</para>
</sect2>
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
<sect2 role="installation">
<title>Installation of rsync</title>
<para>For security reasons, running the <application>rsync</application>
server as an unprivileged user and group is encouraged. If you intend to
run <command>rsync</command> as a daemon, create the
<systemitem class="username">rsyncd</systemitem> user and group
with the following commands:</para>
<screen role="root"><userinput>groupadd rsyncd &amp;&amp;
useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd -s /bin/false rsyncd</userinput></screen>
<para>Install <application>rsync</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install </command></userinput></screen>
make install</userinput></screen>
</sect2>
</sect2>
<sect2>
<title>Configuring <application>rsync</application></title>
<sect2 role="configuration">
<title>Configuring rsync</title>
<sect3><title>Config files</title>
<para><filename>/etc/rsyncd.conf</filename></para>
</sect3>
<sect3 id="rsync-config">
<title>Config Files</title>
<sect3><title>Configuration Information</title>
<para>This is a simple download-only configuration. See the rsyncd man-page for
additional options (i.e., user authentication).</para>
<para><filename>/etc/rsyncd.conf</filename></para>
<screen><userinput><command>cat &gt; /etc/rsyncd.conf &lt;&lt; "EOF"</command>
# This is a basic rsync configuration file
<indexterm zone="rsync rsync-config">
<primary sortas="e-etc-rsyncd.conf">/etc/rsyncd.conf</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<para>This is a simple download-only configuration. See the rsyncd
man-page for additional options (i.e., user authentication).</para>
<screen role="root"><userinput>cat &gt; /etc/rsyncd.conf &lt;&lt; "EOF"
<literal># This is a basic rsync configuration file
# It exports a single module without user authentication.
motd file = /home/rsync/welcome.msg
@ -95,45 +117,67 @@ use chroot = yes
list = yes
uid = rsyncd
gid = rsyncd
</literal>
EOF</userinput></screen>
<command>EOF</command></userinput></screen>
</sect3>
</sect3>
<sect3><title>rsyncd init.d script</title>
<sect3 id="rsync-init">
<title>Boot Script</title>
<para>Note that you only want to start the <application>rsync</application>
server if you want to provide a <application>rsync</application> archive on
your local machine. You don't need this script to run the
<application>rsync</application> client.</para>
<para>Note that you only want to start the
<application>rsync</application> server if you want to provide a
<application>rsync</application> archive on your local machine.
You don't need this script to run the
<application>rsync</application> client.</para>
<para>Install the <filename>/etc/rc.d/init.d/rsyncd</filename> init script
included in the <xref linkend="intro-important-bootscripts"/> package.</para>
<para>Install the <filename>/etc/rc.d/init.d/rsyncd</filename> init
script included in the
<xref linkend="intro-important-bootscripts"/> package.</para>
<screen><userinput><command>make install-rsyncd</command></userinput></screen>
<screen role="root"><userinput>make install-rsyncd</userinput></screen>
</sect3>
</sect3>
</sect2>
</sect2>
<sect2>
<title>Contents</title>
<sect2 role="content">
<title>Contents</title>
<para>The <application>rsync</application> package contains
<command>rsync</command>.</para>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
</sect2>
<seglistitem>
<seg>rsync</seg>
<seg>None</seg>
<seg>Not determined at this time</seg>
</seglistitem>
</segmentedlist>
<sect2><title>Description</title>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<sect3><title>rsync</title>
<para><application>rsync</application> is a replacement for
<command>rcp</command> (and <command>scp</command>) 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.</para></sect3>
<varlistentry id="rsync-prog">
<term><command>rsync</command></term>
<listitem>
<para>is a replacement for <command>rcp</command> (and
<command>scp</command>) 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.</para>
<indexterm zone="rsync rsync-prog">
<primary sortas="b-rsync">rsync</primary>
</indexterm>
</listitem>
</varlistentry>
</sect2>
</variablelist>
</sect2>
</sect1>