Changeset 0da88ea3 for networking/netprogs/rsync-systemd.xml

Timestamp:

07/20/2014 02:21:04 PM (10 years ago)

Author:

Krejzi <krejzi@…>

Branches:

7.6-blfs, 7.6-systemd, kde5-14269, kde5-14686, systemd-13485

Children:

3452097f

Parents:

932240d

Message:

More systemd integration merged from Christopher's branch.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@13503 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• networking/netprogs/rsync-systemd.xml (moved) (moved from networking/netprogs/rsync.xml ) (1 diff)

networking/netprogs/rsync-systemd.xml

@@ -165 +165 @@
 
     <sect3 id="rsync-init">
-      <title>Boot Script</title>
+      <title>Systemd Units</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 unit 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="bootscripts"/> package.</para>
+      <para>
+        To start the <command>rsync</command> daemon at boot,
+        install the systemd units from the <xref linkend="bootscripts"/>
+        package by running the following command as the
+        <systemitem class="username">root</systemitem> user:
+      </para>
 
 <screen role="root"><userinput>make install-rsyncd</userinput></screen>
+
+      <note>
+        <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.
+
+          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:
+
+<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>
+
+          Note that socket method is only useful for remote backups. For local backups you'll need the
+          service method.
+        </para>
+      </note>
 
     </sect3>