source: server/other/rsync.xml@ 718392d9

10.0 10.1 11.0 11.1 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 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 718392d9 was 718392d9, checked in by Randy McMurchy <randy@…>, 14 years ago

Fixed broken rsync download URL

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

  • Property mode set to 100644
File size: 8.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/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://ftp.samba.org/pub/rsync/rsync-&rsync-version;.tar.gz"> -->
9 <!ENTITY rsync-download-http "&sources-anduin-http;/r/rsync-&rsync-version;.tar.gz">
10 <!ENTITY rsync-download-ftp " ">
11 <!-- <!ENTITY rsync-download-http "http://rsync.samba.org/ftp/rsync/old-versions/rsync-&rsync-version;.tar.gz"> -->
12 <!-- <!ENTITY rsync-download-ftp "&gentoo-ftp-repo;/rsync-&rsync-version;.tar.gz"> -->
13 <!ENTITY rsync-md5sum "fd4c5d77d8cb7bb86ab209076fa214d9">
14 <!ENTITY rsync-size "765 KB">
15 <!ENTITY rsync-buildsize "35 MB (includes installing all documentation)">
16 <!ENTITY rsync-time "0.2 SBU">
17]>
18
19<sect1 id="rsync" xreflabel="rsync-&rsync-version;">
20 <?dbhtml filename="rsync.html"?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>rsync-&rsync-version;</title>
28
29 <indexterm zone="rsync">
30 <primary sortas="a-rsync">rsync</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to rsync</title>
35
36 <para>The <application>rsync</application> package contains the
37 <command>rsync</command> utility. This is useful for synchronizing large
38 file archives over a network.</para>
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Download (HTTP): <ulink url="&rsync-download-http;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download (FTP): <ulink url="&rsync-download-ftp;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &rsync-md5sum;</para>
50 </listitem>
51 <listitem>
52 <para>Download size: &rsync-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required: &rsync-buildsize;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated build time: &rsync-time;</para>
59 </listitem>
60 </itemizedlist>
61
62 <bridgehead renderas="sect3">rsync Dependencies</bridgehead>
63
64 <bridgehead renderas="sect4">Optional</bridgehead>
65 <para role="optional"><xref linkend="popt"/>,
66 <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libattr</ulink>, and
67 <ulink url="ftp://oss.sgi.com/projects/xfs/cmd_tars/">libacl</ulink></para>
68
69 <para condition="html" role="usernotes">User Notes:
70 <ulink url="&blfs-wiki;/rsync"/></para>
71
72 </sect2>
73
74 <sect2 role="installation">
75 <title>Installation of rsync</title>
76
77 <para>For security reasons, running the <application>rsync</application>
78 server as an unprivileged user and group is encouraged. If you intend to
79 run <command>rsync</command> as a daemon, create the
80 <systemitem class="username">rsyncd</systemitem> user and group
81 with the following commands issued by the
82 <systemitem class="username">root</systemitem> user:</para>
83
84<screen role="root"><userinput>groupadd -g 48 rsyncd &amp;&amp;
85useradd -c "rsyncd Daemon" -d /home/rsync -g rsyncd \
86 -s /bin/false -u 48 rsyncd</userinput></screen>
87
88 <para>Install <application>rsync</application> by running the following
89 commands:</para>
90
91<screen><userinput>./configure --prefix=/usr &amp;&amp;
92make</userinput></screen>
93
94 <para>If you have <xref linkend="doxygen"/> installed and wish to
95 build HTML API documentation, issue <command>doxygen</command>.</para>
96
97 <para>If you have <xref linkend="docbook-utils"/> installed and wish to
98 build the user documentation, issue any or all of the following
99 commands:</para>
100
101<screen><userinput>pushd doc &amp;&amp;
102docbook2pdf rsync.sgml &amp;&amp;
103docbook2ps rsync.sgml &amp;&amp;
104docbook2dvi rsync.sgml &amp;&amp;
105docbook2txt rsync.sgml &amp;&amp;
106docbook2html --nochunks rsync.sgml &amp;&amp;
107popd</userinput></screen>
108
109 <para>To test the results, issue: <command>make check</command>.</para>
110
111 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
112
113<screen role='root'><userinput>make install</userinput></screen>
114
115 <para>If you built the documentation, install it using the following
116 commands as the <systemitem class="username">root</systemitem> user:</para>
117
118<screen role='root'><userinput>install -v -m755 -d /usr/share/doc/rsync-&rsync-version;/api &amp;&amp;
119install -v -m644 dox/html/* /usr/share/doc/rsync-&rsync-version;/api &amp;&amp;
120install -v -m644 doc/rsync.* /usr/share/doc/rsync-&rsync-version;</userinput></screen>
121
122 </sect2>
123
124 <sect2 role="configuration">
125 <title>Configuring rsync</title>
126
127 <sect3 id="rsync-config">
128 <title>Config Files</title>
129
130 <para><filename>/etc/rsyncd.conf</filename></para>
131
132 <indexterm zone="rsync rsync-config">
133 <primary sortas="e-etc-rsyncd.conf">/etc/rsyncd.conf</primary>
134 </indexterm>
135
136 </sect3>
137
138 <sect3>
139 <title>Configuration Information</title>
140
141 <para>For client access to remote files, you may need to install the
142 <xref linkend="openssh"/> package to connect to the remote server.</para>
143
144 <para>This is a simple download-only configuration to set up running
145 <command>rsync</command> as a server. See the rsyncd.conf(5)
146 man-page for additional options (i.e., user authentication).</para>
147
148<screen role="root"><userinput>cat &gt; /etc/rsyncd.conf &lt;&lt; "EOF"
149<literal># This is a basic rsync configuration file
150# It exports a single module without user authentication.
151
152motd file = /home/rsync/welcome.msg
153use chroot = yes
154
155[localhost]
156 path = /home/rsync
157 comment = Default rsync module
158 read only = yes
159 list = yes
160 uid = rsyncd
161 gid = rsyncd
162</literal>
163EOF</userinput></screen>
164
165 <para>You can find additional configuration information and general
166 documentation about <command>rsync</command> at
167 <ulink url="http://rsync.samba.org/documentation.html"/>.</para>
168
169 </sect3>
170
171 <sect3 id="rsync-init">
172 <title>Boot Script</title>
173
174 <para>Note that you only want to start the
175 <application>rsync</application> server if you want to provide an
176 <application>rsync</application> archive on your local machine.
177 You don't need this script to run the
178 <application>rsync</application> client.</para>
179
180 <para>Install the <filename>/etc/rc.d/init.d/rsyncd</filename> init
181 script included in the
182 <xref linkend="bootscripts"/> package.</para>
183
184<screen role="root"><userinput>make install-rsyncd</userinput></screen>
185
186 </sect3>
187
188 </sect2>
189
190 <sect2 role="content">
191 <title>Contents</title>
192
193 <segmentedlist>
194 <segtitle>Installed Program</segtitle>
195 <segtitle>Installed Libraries</segtitle>
196 <segtitle>Installed Directories</segtitle>
197
198 <seglistitem>
199 <seg>rsync</seg>
200 <seg>None</seg>
201 <seg>Optionally, /usr/share/doc/rsync-&rsync-version;</seg>
202 </seglistitem>
203 </segmentedlist>
204
205 <variablelist>
206 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
207 <?dbfo list-presentation="list"?>
208 <?dbhtml list-presentation="table"?>
209
210 <varlistentry id="rsync-prog">
211 <term><command>rsync</command></term>
212 <listitem>
213 <para>is a replacement for <command>rcp</command> (and
214 <command>scp</command>) that has many more features. It uses the
215 <quote>rsync algorithm</quote> which provides a very fast method of
216 syncing remote files. It does this by sending just the differences
217 in the files across the link, without requiring that both sets of
218 files are present at one end of the link beforehand.</para>
219 <indexterm zone="rsync rsync-prog">
220 <primary sortas="b-rsync">rsync</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 </variablelist>
226
227 </sect2>
228
229</sect1>
Note: See TracBrowser for help on using the repository browser.