r4544 - in trunk/BOOK: . introduction/welcome server/other

randy at linuxfromscratch.org randy at linuxfromscratch.org
Fri Jun 3 11:46:09 PDT 2005


Author: randy
Date: 2005-06-03 12:46:08 -0600 (Fri, 03 Jun 2005)
New Revision: 4544

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/server/other/rsync.xml
Log:
Updated to rsync-2.6.5

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2005-06-03 15:49:35 UTC (rev 4543)
+++ trunk/BOOK/general.ent	2005-06-03 18:46:08 UTC (rev 4544)
@@ -211,7 +211,7 @@
 <!-- Chapter 18 -->
 <!ENTITY ncftp-version                "3.1.7">
 <!ENTITY openssh-version              "4.0p1">
-<!ENTITY rsync-version                "2.6.3">
+<!ENTITY rsync-version                "2.6.5">
 <!ENTITY cvs-version                  "1.11.20">
 <!ENTITY subversion-version           "1.1.4">
 <!ENTITY wget-version                 "1.9.1">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-06-03 15:49:35 UTC (rev 4543)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-06-03 18:46:08 UTC (rev 4544)
@@ -26,7 +26,8 @@
 
     <listitem>
       <para>June 3rd, 2005 [randy]: Updated Samba configuration information as
-      suggested by Alexander Patrakov (fixes bug #1386).</para>
+      suggested by Alexander Patrakov (fixes bug #1386); Updated to 
+      rsync-2.6.5.</para>
     </listitem>
 
     <listitem>

Modified: trunk/BOOK/server/other/rsync.xml
===================================================================
--- trunk/BOOK/server/other/rsync.xml	2005-06-03 15:49:35 UTC (rev 4543)
+++ trunk/BOOK/server/other/rsync.xml	2005-06-03 18:46:08 UTC (rev 4544)
@@ -6,10 +6,10 @@
 
   <!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">
+  <!ENTITY rsync-md5sum "3691cdf1540d0649ba679edce6bae8fc">
+  <!ENTITY rsync-size "643 KB">
+  <!ENTITY rsync-buildsize "12 MB">
+  <!ENTITY rsync-time "0.2 SBU">
 ]>
 
 <sect1 id="rsync" xreflabel="rsync-&rsync-version;">
@@ -58,7 +58,8 @@
     <bridgehead renderas="sect3">rsync Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para><xref linkend="popt"/></para>
+    <para><xref linkend="popt"/> and 
+    <xref linkend="docbook-utils"/></para>
 
   </sect2>
 
@@ -69,18 +70,38 @@
     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>
+    with the following commands issued by the 
+    <systemitem class="username">root</systemitem> user:</para>
 
-<screen role="root"><userinput>groupadd rsyncd &&
-useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd -s /bin/false rsyncd</userinput></screen>
+<screen role="root"><userinput>groupadd -g 48 rsyncd &&
+useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd \
+    -s /bin/false -u 48 rsyncd</userinput></screen>
 
     <para>Install <application>rsync</application> by running the following
     commands:</para>
 
 <screen><userinput>./configure --prefix=/usr &&
-make &&
-make install</userinput></screen>
+make</userinput></screen>
 
+    <para>If you have DocBook-Utils installed and wish to build HTML
+    documentation, issue:</para>
+
+<screen><userinput>cd doc &&
+docbook2html rsync.sgml &&
+cd ..</userinput></screen>
+
+    <para>To test the results, issue: <command>make check</command>.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role='root'><userinput>make install</userinput></screen>
+
+    <para>If you built the HTML documentation, install it using the following
+    commands as the <systemitem class="username">root</systemitem> user:</para>
+
+<screen role='root'><userinput>install -v -m755 -d /usr/share/doc/rsync-&rsync-version; &&
+install -v -m644 doc/*.html /usr/share/doc/rsync-&rsync-version;</userinput></screen>
+
   </sect2>
 
   <sect2 role="configuration">
@@ -100,7 +121,11 @@
     <sect3>
       <title>Configuration Information</title>
 
-      <para>This is a simple download-only configuration. See the rsyncd
+      <para>For client access to remote files, you may need to install the 
+      <xref linkend="openssh"/> package to connect to the remote server.</para>
+
+      <para>This is a simple download-only configuration to set up running 
+      <command>rsync</command> as a server. See the rsyncd.conf(5)
       man-page for additional options (i.e., user authentication).</para>
 
 <screen role="root"><userinput>cat > /etc/rsyncd.conf << "EOF"
@@ -120,13 +145,17 @@
 </literal>
 EOF</userinput></screen>
 
+    <para>You can find additional configuration information and general
+    documentation about <command>rsync</command> at
+    <ulink url="http://rsync.samba.org/documentation.html"/>.</para>
+ 
     </sect3>
 
-    <sect3  id="rsync-init">
+    <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> server if you want to provide an
       <application>rsync</application> archive on your local machine.
       You don't need this script to run the
       <application>rsync</application> client.</para>
@@ -152,7 +181,7 @@
       <seglistitem>
         <seg>rsync</seg>
         <seg>None</seg>
-        <seg>Not determined at this time</seg>
+        <seg>Optionally, /usr/share/doc/rsync-&rsync-version;</seg>
       </seglistitem>
     </segmentedlist>
 
@@ -166,10 +195,10 @@
         <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>
+          <quote>rsync algorithm</quote> 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>




More information about the blfs-book mailing list