Changeset 7b478500 for networking/netprogs/samba.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, 12.2, 7.10, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gimp3, 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/for-12.3, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/spidermonkey128, 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/samba.xml (modified) (6 diffs)

networking/netprogs/samba.xml

@@ -121 +121 @@
     commands:</para>
 
-<screen><userinput>./configure                            \
+<screen revision="sysv"><userinput>./configure                            \
     --prefix=/usr                      \
     --sysconfdir=/etc                  \
@@ -130 +130 @@
     --without-ad-dc                    \
     --without-systemd                  &amp;&amp;
+make</userinput></screen>
+
+<screen revision="systemd"><userinput>./configure                            \
+    --prefix=/usr                      \
+    --sysconfdir=/etc                  \
+    --localstatedir=/var               \
+    --with-piddir=/run/samba           \
+    --with-pammodulesdir=/lib/security \
+    --enable-fhs &amp;&amp;
 make</userinput></screen>
 
@@ -183 +192 @@
     a manner compliant with the Filesystem Hierarchy Standard (FHS).</para>
 
-    <para><parameter>--without-systemd</parameter>: Disable
+    <para revision="sysv"><parameter>--without-systemd</parameter>: Disable
     <application>systemd</application> integration, which is not part of
     LFS/BLFS. If you use <application>systemd</application>, replace by
     <parameter>--with-systemd</parameter>.</para>
 
-    <para><option>--without-ad-dc</option>: Disable Active Directory Domain
-    Controller functionality. See <ulink
+    <para revision="sysv"><option>--without-ad-dc</option>: Disable Active
+    Directory Domain Controller functionality. See <ulink
     url="https://wiki.samba.org/index.php/Setup_a_Samba_Active_Directory_Domain_Controller">
     Setup a Samba Active Directory Domain Controller</ulink> for detailed
-    information. </para>
+    information.</para>
 
     <para><option>--with-selftest-prefix=SELFTEST_PREFIX</option>: This option
@@ -203 +212 @@
     <para><command>ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so</command>
     and <command>ln -v -sf ../../lib/libnss_wins.so.2    /usr/lib/libnss_wins.so</command>:
-    These symlinks are required when applicates build against these libraries.</para>
+    These symlinks are required when applicationss build against these
+    libraries.</para>
 
     <para><command>install -v -m644 examples/LDAP/* /etc/openldap/schema</command>:
@@ -407 +417 @@
       </sect4>
 
-      <sect4 id="samba-init">
+      <sect4 id="samba-init" revision="sysv">
         <title>Boot Script</title>
 
         <para>For your convenience, boot scripts have been provided for
         <application>Samba</application>. There are two included in the
-        <xref linkend="bootscripts" revision="sysv"/>
-        <xref linkend="systemd-units" revision="systemd"/> package. The first,
+        <xref linkend="bootscripts"/> package. The first,
         <filename>samba</filename>, will start the <command>smbd</command>
         and <command>nmbd</command> daemons needed to provide SMB/CIFS
@@ -453 +462 @@
 <screen role="root"><userinput>make install-winbindd</userinput></screen>
 
-       </sect4>
+      </sect4>
+
+      <sect4 id="samba-init-sysd" revision="systemd">
+        <title>Systemd Units</title>
+
+        <para>The default <application>Samba</application> installation uses the
+        <systemitem class='username'>nobody</systemitem> user for guest access
+        to the server. This can be overridden by setting the
+        <option>guest account =</option> parameter in the
+        <filename>/etc/samba/smb.conf</filename> file. If you utilize the
+        <option>guest account =</option> parameter, ensure this user exists in
+        the <filename>/etc/passwd</filename> file.</para>
+
+        <para>
+          To start the <application>Samba</application> daemons at boot,
+          install the systemd units from the <xref linkend="systemd-units"/>
+          package by running the following command as the
+          <systemitem class="username">root</systemitem> user:
+        </para>
+
+        <indexterm zone="samba samba-init-sysd">
+          <primary sortas="f-samba">samba</primary>
+        </indexterm>
+
+<screen role="root"><userinput>make install-samba</userinput></screen>
+
+        <para>
+          To start the <command>winbindd</command> daemon at boot,
+          install the systemd unit from the <xref linkend="systemd-units"/>
+          package by running the following command as the
+          <systemitem class="username">root</systemitem> user:
+        </para>
+
+        <indexterm zone="samba samba-init-sysd">
+          <primary sortas="f-winbindd">winbindd</primary>
+        </indexterm>
+
+<screen role="root"><userinput>make install-winbindd</userinput></screen>
+
+        <note>
+        <para>This package comes with two types of units: A service file and a
+        socket file. The service file will start the smbd daemon once at boot
+        and it will keep running until the system shuts down. The socket file
+        will make systemd listen on the smbd port (Default 445, needs to be
+        edited for anything else) and will start the smbd 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 - the smbd daemon is started
+        at boot and stopped at shutdown. If the socket method is desired, you
+        need to run the following commands as the
+        <systemitem class="username">root</systemitem> user:</para>
+
+<screen role="root"><userinput>systemctl stop smbd &amp;&amp;
+systemctl disable smbd &amp;&amp;
+systemctl enable smbd.socket &amp;&amp;
+systemctl start smbd.socket</userinput></screen>
+
+        <para>Note that only the smbd daemon can be socket activated.</para>
+        </note>
+      </sect4>
 
     </sect3>