Changeset 7b478500 for networking/netprogs/rsync.xml

Timestamp:

06/11/2016 05:26:20 AM (8 years ago)

Author:

DJ Lucas <dj@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 7.10, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

cec6657e

Parents:

a9e71e2

Message:

[Systemd merge] - Chapter 16

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

File:

• networking/netprogs/rsync.xml (modified) (1 diff)

networking/netprogs/rsync.xml

@@ -165 +165 @@
 
     <sect3 id="rsync-init">
-      <title>Boot Script</title>
+      <title><phrase revision="sysv">Boot Script</phrase>
+             <phrase revision="systemd">Systemd Unit</phrase></title>
 
       <para>Note that you only want to start the
       <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
+      You don't need this <phrase revision="sysv">script</phrase>
+      <phrase revision="systemd">unit</phrase> to run the
       <application>rsync</application> client.</para>
 
-      <para>Install the <filename>/etc/rc.d/init.d/rsyncd</filename> init
-      script included in the
+      <para>Install the
+      <phrase revision="sysv"><filename>/etc/rc.d/init.d/rsyncd</filename> init
+      script</phrase>
+      <phrase revision="systemd"><filename>rsyncd.service</filename>
+      unit</phrase> included in the
       <xref linkend="bootscripts" revision="sysv"/>
       <xref linkend="systemd-units" revision="systemd"/> package.</para>
 
 <screen role="root"><userinput>make install-rsyncd</userinput></screen>
+
+      <note revision="systemd">
+        <para>This package comes with two types of units: A service file and a
+        socket file. The service file will start rsync daemon once at boot
+        and it will keep running until the system shuts down. The socket file
+        will make systemd listen on rsync port (Default 873, needs to be
+        edited for anything else) and will start rsync daemon when something
+        tries to connect to that port and stop the daemon when the connection
+        is terminated. This is called socket activation and is analogous to
+        using <application>{,x}inetd</application> on a SysVinit based 
+        system.</para>
+
+
+        <para>By default, the first method is used - rsync daemon is started
+        at boot and stopped at shutdown. If the socket method is desired, you
+        need to run as the
+        <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>systemctl stop rsyncd &amp;&amp;
+systemctl disable rsyncd &amp;&amp;
+systemctl enable rsyncd.socket &amp;&amp;
+systemctl start rsyncd.socket</userinput></screen>
+
+        <para>Note that socket method is only useful for remote backups. For
+        local backups you'll need the service method.</para>
+      </note>
 
     </sect3>