Changeset 5ab6e72


Ignore:
Timestamp:
05/18/2005 08:36:07 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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:
eae0107f
Parents:
4d7ed6c
Message:

Tagged rsync.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/other/rsync.xml

    r4d7ed6c r5ab6e72  
    55  %general-entities;
    66
    7 <!ENTITY rsync-download-http "http://rsync.samba.org/ftp/rsync/rsync-&rsync-version;.tar.gz">
    8 <!ENTITY rsync-download-ftp "ftp://ftp.samba.org/pub/rsync/rsync-&rsync-version;.tar.gz">
    9 <!ENTITY rsyncd-md5sum "2beb30caafa69a01182e71c528fb0393">
    10 <!ENTITY rsyncd-size "583 KB">
    11 <!ENTITY rsync-buildsize "4.8 MB">
    12 <!ENTITY rsyncd-time "0.17 SBU">
     7  <!ENTITY rsync-download-http "http://rsync.samba.org/ftp/rsync/rsync-&rsync-version;.tar.gz">
     8  <!ENTITY rsync-download-ftp "ftp://ftp.samba.org/pub/rsync/rsync-&rsync-version;.tar.gz">
     9  <!ENTITY rsync-md5sum "2beb30caafa69a01182e71c528fb0393">
     10  <!ENTITY rsync-size "583 KB">
     11  <!ENTITY rsync-buildsize "4.8 MB">
     12  <!ENTITY rsync-time "0.17 SBU">
    1313]>
    1414
    1515<sect1 id="rsync" xreflabel="rsync-&rsync-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="rsync.html"?>
    21 <title><application>rsync</application>-&rsync-version;</title>
     16  <?dbhtml filename="rsync.html"?>
    2217
    23 <sect2>
    24 <title>Introduction to <application>rsync</application></title>
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
    2522
    26 <para>The <application>rsync</application> package contains the
    27 <command>rsync</command> utility. This is useful for synchronizing large file
    28 archives over a network.</para>
     23  <title>rsync-&rsync-version;</title>
    2924
    30 <sect3><title>Package information</title>
    31 <itemizedlist spacing='compact'>
    32 <listitem><para>Download (HTTP):
    33 <ulink url="&rsync-download-http;"/></para></listitem>
    34 <listitem><para>Download (FTP):
    35 <ulink url="&rsync-download-ftp;"/></para></listitem>
    36 <listitem><para>Download MD5 sum: &rsyncd-md5sum;</para></listitem>
    37 <listitem><para>Download size: &rsyncd-size;</para></listitem>
    38 <listitem><para>Estimated disk space required:
    39 &rsync-buildsize;</para></listitem>
    40 <listitem><para>Estimated build time:
    41 &rsyncd-time;</para></listitem></itemizedlist>
    42 </sect3>
     25  <indexterm zone="rsync">
     26    <primary sortas="a-rsync">rsync</primary>
     27  </indexterm>
    4328
    44 <sect3><title><application>rsync</application> dependencies</title>
    45 <sect4><title>Optional</title>
    46 <para><xref linkend="popt"/></para>
    47 </sect4>
    48 </sect3>
     29  <sect2 role="package">
     30    <title>Introduction to rsync</title>
    4931
    50 </sect2>
     32    <para>The <application>rsync</application> package contains the
     33    <command>rsync</command> utility. This is useful for synchronizing large
     34    file archives over a network.</para>
    5135
    52 <sect2>
    53 <title>Installation of <application>rsync</application></title>
     36    <bridgehead renderas="sect3">Package Information</bridgehead>
     37    <itemizedlist spacing="compact">
     38      <listitem>
     39        <para>Download (HTTP): <ulink url="&rsync-download-http;"/></para>
     40      </listitem>
     41      <listitem>
     42        <para>Download (FTP): <ulink url="&rsync-download-ftp;"/></para>
     43      </listitem>
     44      <listitem>
     45        <para>Download MD5 sum: &rsync-md5sum;</para>
     46      </listitem>
     47      <listitem>
     48        <para>Download size: &rsync-size;</para>
     49      </listitem>
     50      <listitem>
     51        <para>Estimated disk space required: &rsync-buildsize;</para>
     52      </listitem>
     53      <listitem>
     54        <para>Estimated build time: &rsync-time;</para>
     55      </listitem>
     56    </itemizedlist>
    5457
    55 <para>For security reasons, running the <application>rsync</application>
    56 server as an unprivileged user and group is encouraged. If you intend to
    57 run <command>rsync</command> as a daemon, create the rsyncd user and group
    58 with the following commands:</para>
     58    <bridgehead renderas="sect3">rsync Dependencies</bridgehead>
    5959
    60 <screen><userinput><command>groupadd rsyncd &amp;&amp;
    61 useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd -s /bin/false rsyncd</command>
    62 </userinput></screen>
     60    <bridgehead renderas="sect4">Optional</bridgehead>
     61    <para><xref linkend="popt"/></para>
    6362
    64 <para>Install <application>rsync</application> by running the following
    65 commands:</para>
     63  </sect2>
    6664
    67 <screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     65  <sect2 role="installation">
     66    <title>Installation of rsync</title>
     67
     68    <para>For security reasons, running the <application>rsync</application>
     69    server as an unprivileged user and group is encouraged. If you intend to
     70    run <command>rsync</command> as a daemon, create the
     71    <systemitem class="username">rsyncd</systemitem> user and group
     72    with the following commands:</para>
     73
     74<screen role="root"><userinput>groupadd rsyncd &amp;&amp;
     75useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd -s /bin/false rsyncd</userinput></screen>
     76
     77    <para>Install <application>rsync</application> by running the following
     78    commands:</para>
     79
     80<screen><userinput>./configure --prefix=/usr &amp;&amp;
    6881make &amp;&amp;
    69 make install </command></userinput></screen>
     82make install</userinput></screen>
    7083
    71 </sect2>
     84  </sect2>
    7285
    73 <sect2>
    74 <title>Configuring <application>rsync</application></title>
     86  <sect2 role="configuration">
     87    <title>Configuring rsync</title>
    7588
    76 <sect3><title>Config files</title>
    77 <para><filename>/etc/rsyncd.conf</filename></para>
    78 </sect3>
     89    <sect3 id="rsync-config">
     90      <title>Config Files</title>
    7991
    80 <sect3><title>Configuration Information</title>
    81 <para>This is a simple download-only configuration. See the rsyncd man-page for
    82 additional options (i.e., user authentication).</para>
     92      <para><filename>/etc/rsyncd.conf</filename></para>
    8393
    84 <screen><userinput><command>cat &gt; /etc/rsyncd.conf &lt;&lt; "EOF"</command>
    85 # This is a basic rsync configuration file
     94      <indexterm zone="rsync rsync-config">
     95        <primary sortas="e-etc-rsyncd.conf">/etc/rsyncd.conf</primary>
     96      </indexterm>
     97
     98    </sect3>
     99
     100    <sect3>
     101      <title>Configuration Information</title>
     102
     103      <para>This is a simple download-only configuration. See the rsyncd
     104      man-page for additional options (i.e., user authentication).</para>
     105
     106<screen role="root"><userinput>cat &gt; /etc/rsyncd.conf &lt;&lt; "EOF"
     107<literal># This is a basic rsync configuration file
    86108# It exports a single module without user authentication.
    87109
    … …  
    96118    uid = rsyncd
    97119    gid = rsyncd
     120</literal>
     121EOF</userinput></screen>
    98122
    99 <command>EOF</command></userinput></screen>
    100 </sect3>
     123    </sect3>
    101124
    102 <sect3><title>rsyncd init.d script</title>
     125    <sect3  id="rsync-init">
     126      <title>Boot Script</title>
    103127
    104 <para>Note that you only want to start the <application>rsync</application>
    105 server if you want to provide a <application>rsync</application> archive on
    106 your local machine. You don't need this script to run the
    107 <application>rsync</application> client.</para>
     128      <para>Note that you only want to start the
     129      <application>rsync</application> server if you want to provide a
     130      <application>rsync</application> archive on your local machine.
     131      You don't need this script to run the
     132      <application>rsync</application> client.</para>
    108133
    109 <para>Install the <filename>/etc/rc.d/init.d/rsyncd</filename> init script
    110 included in the <xref linkend="intro-important-bootscripts"/> package.</para>
     134      <para>Install the <filename>/etc/rc.d/init.d/rsyncd</filename> init
     135      script included in the
     136      <xref linkend="intro-important-bootscripts"/> package.</para>
    111137
    112 <screen><userinput><command>make install-rsyncd</command></userinput></screen>
     138<screen role="root"><userinput>make install-rsyncd</userinput></screen>
    113139
    114 </sect3>
     140    </sect3>
    115141
    116 </sect2>
     142  </sect2>
    117143
    118 <sect2>
    119 <title>Contents</title>
     144  <sect2 role="content">
     145    <title>Contents</title>
    120146
    121 <para>The <application>rsync</application> package contains
    122 <command>rsync</command>.</para>
     147    <segmentedlist>
     148      <segtitle>Installed Program</segtitle>
     149      <segtitle>Installed Libraries</segtitle>
     150      <segtitle>Installed Directories</segtitle>
    123151
    124 </sect2>
     152      <seglistitem>
     153        <seg>rsync</seg>
     154        <seg>None</seg>
     155        <seg>Not determined at this time</seg>
     156      </seglistitem>
     157    </segmentedlist>
    125158
    126 <sect2><title>Description</title>
     159    <variablelist>
     160      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     161      <?dbfo list-presentation="list"?>
     162      <?dbhtml list-presentation="table"?>
    127163
    128 <sect3><title>rsync</title>
    129 <para><application>rsync</application> is a replacement for
    130 <command>rcp</command> (and <command>scp</command>) that has many more
    131 features. It uses the "rsync algorithm" which provides a very fast method of
    132 syncing remote files. It does this by sending just the differences in the
    133 files across the link, without requiring that both sets of files are present
    134 at one end of the link beforehand.</para></sect3>
     164      <varlistentry id="rsync-prog">
     165        <term><command>rsync</command></term>
     166        <listitem>
     167          <para>is a replacement for <command>rcp</command> (and
     168          <command>scp</command>) that has many more features. It uses the
     169          "rsync algorithm" which provides a very fast method of syncing
     170          remote files. It does this by sending just the differences in the
     171          files across the link, without requiring that both sets of files
     172          are present at one end of the link beforehand.</para>
     173          <indexterm zone="rsync rsync-prog">
     174            <primary sortas="b-rsync">rsync</primary>
     175          </indexterm>
     176        </listitem>
     177      </varlistentry>
    135178
    136 </sect2>
     179    </variablelist>
     180
     181  </sect2>
    137182
    138183</sect1>
    139 
Note: See TracChangeset for help on using the changeset viewer.