Ignore:
Timestamp:
03/22/2020 03:52:07 PM (4 years ago)
Author:
Pierre Labastie <pieere@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, 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:
254bc90d
Parents:
dcee7a56
Message:

Format netprogs

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • networking/netprogs/samba.xml

    rdcee7a56 rb51fe6e  
    3030    <title>Introduction to Samba</title>
    3131
    32     <para>The <application>Samba</application> package provides file and print
    33     services to SMB/CIFS clients and Windows networking to Linux clients.
    34     <application>Samba</application> can also be configured as a Windows Domain
    35     Controller replacement, a file/print server acting as a member of a Windows
    36     Active Directory domain and a NetBIOS (rfc1001/1002) nameserver (which
    37     among other things provides LAN browsing support).</para>
     32    <para>
     33      The <application>Samba</application> package provides file and print
     34      services to SMB/CIFS clients and Windows networking to Linux clients.
     35      <application>Samba</application> can also be configured as a Windows
     36      Domain Controller replacement, a file/print server acting as a member
     37      of a Windows Active Directory domain and a NetBIOS (rfc1001/1002)
     38      nameserver (which among other things provides LAN browsing support).
     39    </para>
    3840
    3941    &lfs91_checked;
    … …  
    4244    <itemizedlist spacing="compact">
    4345      <listitem>
    44         <para>Download (HTTP): <ulink url="&samba-download-http;"/></para>
     46        <para>
     47          Download (HTTP): <ulink url="&samba-download-http;"/>
     48        </para>
    4549      </listitem>
    4650      <listitem>
    47         <para>Download (FTP): <ulink url="&samba-download-ftp;"/></para>
     51        <para>
     52          Download (FTP): <ulink url="&samba-download-ftp;"/>
     53        </para>
    4854      </listitem>
    4955      <listitem>
    50         <para>Download MD5 sum: &samba-md5sum;</para>
     56        <para>
     57          Download MD5 sum: &samba-md5sum;
     58        </para>
    5159      </listitem>
    5260      <listitem>
    53         <para>Download size: &samba-size;</para>
     61        <para>
     62          Download size: &samba-size;
     63        </para>
    5464      </listitem>
    5565      <listitem>
    56         <para>Estimated disk space required: &samba-buildsize;</para>
     66        <para>
     67          Estimated disk space required: &samba-buildsize;
     68        </para>
    5769      </listitem>
    5870      <listitem>
    59         <para>Estimated build time: &samba-time;</para>
     71        <para>
     72          Estimated build time: &samba-time;
     73        </para>
    6074      </listitem>
    6175    </itemizedlist>
    … …  
    124138
    125139    <bridgehead renderas="sect4">Optional (for the Developer Test Suite)</bridgehead>
    126     <para role="optional">Install in listed order:
    127     <xref linkend="six"/>,
    128     <ulink url="&pypi;/argparse/">argparse</ulink>,
    129     <ulink url="&pypi;/extras/">extras</ulink>,
    130     <ulink url="&pypi;/py/">py</ulink>,
    131     <ulink url="&pypi;/enum34/">enum34</ulink>,
    132     <ulink url="&pypi;/hypothesis/">hypothesis</ulink>,
    133     <ulink url="&pypi;/pytest/">pytest</ulink>,
    134     <ulink url="&pypi;/coverage/">coverage</ulink>,
    135     <ulink url="&pypi;/pytest-cov/">pytest-cov</ulink>,
    136     <ulink url="&pypi;/doctools/">doctools</ulink>,
    137     <ulink url="&pypi;/unittest2/">unittest2</ulink>,
    138     <ulink url="&pypi;/testtools/">testtools</ulink>,
    139     <ulink url="&pypi;/fixtures/">fixtures</ulink>,
    140     <ulink url="&pypi;/python-mimeparse/">python-mimeparse</ulink>,
    141     <ulink url="&pypi;/contextlib2/">contextlib2</ulink>,
    142     <ulink url="&pypi;/traceback2/">traceback2</ulink>,
    143     <ulink url="&pypi;/linecache2/">linecache2</ulink>,
    144     <ulink url="&pypi;/testscenarios/">testscenarios</ulink>,
    145     <ulink url="&pypi;/testresources/">testresources</ulink>,
    146     <ulink url="&pypi;/virtualenv/">virtualenv</ulink>,
    147     <ulink url="&pypi;/pbr/">pbr</ulink>, and
    148     <ulink url="&pypi;/python-subunit/">python-subunit</ulink></para>
     140    <para role="optional">
     141      Install in listed order:
     142      <xref linkend="six"/>,
     143      <ulink url="&pypi;/argparse/">argparse</ulink>,
     144      <ulink url="&pypi;/extras/">extras</ulink>,
     145      <ulink url="&pypi;/py/">py</ulink>,
     146      <ulink url="&pypi;/enum34/">enum34</ulink>,
     147      <ulink url="&pypi;/hypothesis/">hypothesis</ulink>,
     148      <ulink url="&pypi;/pytest/">pytest</ulink>,
     149      <ulink url="&pypi;/coverage/">coverage</ulink>,
     150      <ulink url="&pypi;/pytest-cov/">pytest-cov</ulink>,
     151      <ulink url="&pypi;/doctools/">doctools</ulink>,
     152      <ulink url="&pypi;/unittest2/">unittest2</ulink>,
     153      <ulink url="&pypi;/testtools/">testtools</ulink>,
     154      <ulink url="&pypi;/fixtures/">fixtures</ulink>,
     155      <ulink url="&pypi;/python-mimeparse/">python-mimeparse</ulink>,
     156      <ulink url="&pypi;/contextlib2/">contextlib2</ulink>,
     157      <ulink url="&pypi;/traceback2/">traceback2</ulink>,
     158      <ulink url="&pypi;/linecache2/">linecache2</ulink>,
     159      <ulink url="&pypi;/testscenarios/">testscenarios</ulink>,
     160      <ulink url="&pypi;/testresources/">testresources</ulink>,
     161      <ulink url="&pypi;/virtualenv/">virtualenv</ulink>,
     162      <ulink url="&pypi;/pbr/">pbr</ulink>, and
     163      <ulink url="&pypi;/python-subunit/">python-subunit</ulink>
     164    </para>
    149165
    150166    <para condition="html" role="usernotes">User Notes:
    … …  
    156172    <title>Installation of Samba</title>
    157173
    158     <para>Fix a test that always fails:</para>
     174    <para>
     175      Fix a test that always fails:
     176    </para>
    159177
    160178<screen><userinput>echo "^samba4.rpc.echo.*on.*ncacn_np.*with.*object.*nt4_dc" >> selftest/knownfail</userinput></screen>
    161179
    162     <para>Install <application>Samba</application> by running the following
    163     commands:</para>
     180    <para>
     181      Install <application>Samba</application> by running the following
     182      commands:
     183    </para>
    164184
    165185<screen revision="sysv"><userinput>CFLAGS="-I/usr/include/tirpc"          \
    … …  
    190210make</userinput></screen>
    191211
    192     <para>To test the results, as the
    193     <systemitem class="username">root</systemitem> user, issue:
    194     <command>make quicktest</command>. The test suite will produce lines that
    195     look like failures, but these are innocuous. The last few lines of output
    196     should report <emphasis>"ALL OK"</emphasis> for a good test run. A summary
    197     of any failures can be found in
    198     <filename class="directory">./st/summary</filename>.</para>
    199 
    200     <!-- If doing a security update or a new minor version (point releases do not apply
    201     here), run 'make testenv' before running 'make test' and 'make subunit-test'. This
    202     will setup the test environment and make the tests run faster, as well as point
    203     out any glaring issues that might affect the new Samba installation. With 4.10.4,
    204     I got 236 failures, 73 errors, and 2 unexpected successes. These were all known
    205     upstream, and you can find them in the knownfail list in their git repo.
    206     This is per Upstream's recommendation over IRC.-->
     212    <para>
     213      To test the results, as the
     214      <systemitem class="username">root</systemitem> user, issue:
     215      <command>make quicktest</command>. The test suite will produce lines that
     216      look like failures, but these are innocuous. The last few lines of output
     217      should report <emphasis>"ALL OK"</emphasis> for a good test run. A summary
     218      of any failures can be found in
     219      <filename class="directory">./st/summary</filename>.
     220    </para>
     221
     222    <!--
     223      If doing a security update or a new minor version (point releases do not
     224      apply here), run 'make testenv' before running 'make test' and 'make
     225      subunit-test'. This will setup the test environment and make the tests
     226      run faster, as well as point out any glaring issues that might affect
     227      the new Samba installation. With 4.10.4, I got 236 failures, 73 errors,
     228      and 2 unexpected successes. These were all known upstream, and you can
     229      find them in the knownfail list in their git repo. This is per
     230      Upstream's recommendation over IRC.
     231    -->
    207232
    208233    <note>
    209       <para>Additionally, developer test suites are available. If you've
    210       installed the optional python modules above, you can run these tests with
    211       <command>make test</command>. It is not recommended for the average
    212       builder at around 290 SBU and over a gigabyte of disk space, and you
    213       should expect ~73 errors and ~30 failures from the 3000+ tests.</para>
     234      <para>
     235        Additionally, developer test suites are available. If you've installed
     236        the optional python modules above, you can run these tests with
     237        <command>make test</command>. It is not recommended for the average
     238        builder at around 290 SBU and over a gigabyte of disk space, and you
     239        should expect ~73 errors and ~30 failures from the 3000+ tests.
     240      </para>
    214241    </note>
    215242
    216     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     243    <para>
     244      Now, as the <systemitem class="username">root</systemitem> user:
     245    </para>
    217246
    218247<screen role="root"><userinput>make install &amp;&amp;
    … …  
    240269    <title>Command Explanations</title>
    241270
    242     <para><parameter>--enable-fhs</parameter>: Assigns all other file paths in
    243     a manner compliant with the Filesystem Hierarchy Standard (FHS).</para>
    244 
    245     <para revision="sysv"><parameter>--without-systemd</parameter>: Disable
    246     <application>systemd</application> integration, since it is not built
    247     in the System V version of LFS/BLFS.</para>
    248 
    249     <para><parameter>--without-ad-dc</parameter>: Disable
    250     Active Directory Domain Controller functionality. See <ulink
    251     url="https://wiki.samba.org/index.php/Setup_a_Samba_Active_Directory_Domain_Controller">
    252     Setup a Samba Active Directory Domain Controller</ulink> for detailed
    253     information. Remove this switch if you've installed the Python modules
    254     needed for ADS support. Note that BLFS does not provide a samba bootscript
    255     for an Active Directory domain controller.</para>
    256 
    257     <para><option>--with-selftest-prefix=SELFTEST_PREFIX</option>: This option
    258     specifies the test suite work directory (default=./st).</para>
    259 
    260     <para><command>mv -v /usr/lib/libnss_win{s,bind}.so* /lib</command>:
    261     The nss libraries are installed in /usr/lib by default. Move them to
    262     /lib.</para>
    263 
    264     <para><command>ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so</command>
    265     and <command>ln -v -sf ../../lib/libnss_wins.so.2    /usr/lib/libnss_wins.so</command>:
    266     These symlinks are required when applications build against these
    267     libraries.</para>
    268 
    269     <para><command>install -v -m644 examples/LDAP/* /etc/openldap/schema</command>:
    270     These commands are used to copy sample Samba schemas to the OpenLDAP
    271     <filename class='directory'>schema</filename> directory.</para>
    272 
    273     <para><command>install -v -m644 ../examples/smb.conf.default
    274     /etc/samba</command>: This copies a default <filename>smb.conf</filename>
    275     file into <filename>/etc/samba</filename>. This sample configuration will
    276     not work until you copy it to <filename>/etc/samba/smb.conf</filename> and
    277     make the appropriate changes for your installation. See the configuration
    278     section for minimum values which must be set.</para>
     271    <para>
     272      <parameter>--enable-fhs</parameter>: Assigns all other file paths in
     273      a manner compliant with the Filesystem Hierarchy Standard (FHS).
     274    </para>
     275
     276    <para revision="sysv">
     277      <parameter>--without-systemd</parameter>: Disable
     278      <application>systemd</application> integration, since it is not built
     279      in the System V version of LFS/BLFS.
     280    </para>
     281
     282    <para>
     283      <parameter>--without-ad-dc</parameter>: Disable
     284      Active Directory Domain Controller functionality. See <ulink url=
     285      "https://wiki.samba.org/index.php/Setup_a_Samba_Active_Directory_Domain_Controller">
     286      Setup a Samba Active Directory Domain Controller</ulink> for detailed
     287      information. Remove this switch if you've installed the Python modules
     288      needed for ADS support. Note that BLFS does not provide a samba bootscript
     289      for an Active Directory domain controller.
     290    </para>
     291
     292    <para>
     293      <option>--with-selftest-prefix=SELFTEST_PREFIX</option>: This option
     294      specifies the test suite work directory (default=./st).
     295    </para>
     296
     297    <para>
     298      <command>mv -v /usr/lib/libnss_win{s,bind}.so* /lib</command>:
     299      The nss libraries are installed in
     300      <filename class="directory">/usr/lib</filename> by default. Move them to
     301      <filename class="directory">/lib</filename>.
     302    </para>
     303
     304    <para>
     305      <command>ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so</command>
     306      and <command>ln -v -sf ../../lib/libnss_wins.so.2    /usr/lib/libnss_wins.so</command>:
     307      These symlinks are required when applications build against these
     308      libraries.
     309    </para>
     310
     311    <para>
     312      <command>install -v -m644 examples/LDAP/* /etc/openldap/schema</command>:
     313      These commands are used to copy sample Samba schemas to the OpenLDAP
     314      <filename class='directory'>schema</filename> directory.
     315    </para>
     316
     317    <para>
     318      <command>install -v -m644 ../examples/smb.conf.default
     319      /etc/samba</command>: This copies a default <filename>smb.conf</filename>
     320      file into <filename>/etc/samba</filename>. This sample configuration will
     321      not work until you copy it to <filename>/etc/samba/smb.conf</filename> and
     322      make the appropriate changes for your installation. See the configuration
     323      section for minimum values which must be set.
     324    </para>
    279325
    280326  </sect2>
    … …  
    286332      <title>Config Files</title>
    287333
    288       <para>/etc/samba/smb.conf</para>
     334      <para>
     335        /etc/samba/smb.conf
     336      </para>
    289337
    290338      <indexterm zone="samba samba-config">
    … …  
    297345      <title>Printing to SMB Clients</title>
    298346
    299       <para>If you use <application>CUPS</application> for print services,
    300       and you wish to print to a printer attached to an SMB client, you
    301       need to create an SMB backend device. To create the device, issue the
    302       following command as the <systemitem class="username">root</systemitem>
    303       user:</para>
    304 
    305 <screen role="root"><userinput>ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
     347      <para>
     348        If you use <application>CUPS</application> for print services, and you
     349        wish to print to a printer attached to an SMB client, you need to
     350        create an SMB backend device. To create the device, issue the following
     351        command as the <systemitem class="username">root</systemitem> user:
     352      </para>
     353
     354<screen role="root"><userinput>install -dvm 755 /usr/lib/cups/backend &amp;&amp;
     355ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
    306356
    307357    </sect3>
    … …  
    310360      <title>Configuration Information</title>
    311361
    312       <para>Due to the complexity and the many various uses for
    313       <application>Samba</application>, complete configuration for all the
    314       package's capabilities is well beyond the scope of the BLFS book. This
    315       section provides instructions to configure the
    316       <filename>/etc/samba/smb.conf</filename> file for two common scenarios.
    317       The complete contents of <filename>/etc/samba/smb.conf</filename> will
    318       depend on the purpose of <application>Samba</application>
    319       installation.</para>
     362      <para>
     363        Due to the complexity and the many various uses for
     364        <application>Samba</application>, complete configuration for all the
     365        package's capabilities is well beyond the scope of the BLFS book. This
     366        section provides instructions to configure the
     367        <filename>/etc/samba/smb.conf</filename> file for two common scenarios.
     368        The complete contents of <filename>/etc/samba/smb.conf</filename> will
     369        depend on the purpose of <application>Samba</application>
     370        installation.
     371      </para>
    320372
    321373      <note>
    322         <para>You may find it easier to copy the configuration parameters shown
    323         below into an empty <filename>/etc/samba/smb.conf</filename> file
    324         instead of copying and editing the default file as mentioned in the
    325         <quote>Command Explanations</quote> section. How you create/edit the
    326         <filename>/etc/samba/smb.conf</filename> file will be left up to
    327         you. Do ensure the file is only writeable by the
    328         <systemitem class="username">root</systemitem> user (mode 644).</para>
     374        <para>
     375          You may find it easier to copy the configuration parameters shown
     376          below into an empty <filename>/etc/samba/smb.conf</filename> file
     377          instead of copying and editing the default file as mentioned in the
     378          <quote>Command Explanations</quote> section. How you create/edit the
     379          <filename>/etc/samba/smb.conf</filename> file will be left up to
     380          you. Do ensure the file is only writeable by the
     381          <systemitem class="username">root</systemitem> user (mode 644).
     382        </para>
    329383      </note>
    330384
    … …  
    332386        <title>Scenario 1: Minimal Standalone Client-Only Installation</title>
    333387
    334         <para>Choose this variant if you only want to transfer files using
    335         <command>smbclient</command>, mount Windows shares and print to Windows
    336         printers, and don't want to share your files and printers to Windows
    337         machines.</para>
    338 
    339         <para>A <filename>/etc/samba/smb.conf</filename> file with the following
    340         three parameters is sufficient:</para>
     388        <para>
     389          Choose this variant if you only want to transfer files using
     390          <command>smbclient</command>, mount Windows shares and print to
     391          Windows printers, and don't want to share your files and printers to
     392          Windows machines.
     393        </para>
     394
     395        <para>
     396          A <filename>/etc/samba/smb.conf</filename> file with the following
     397          three parameters is sufficient:
     398        </para>
    341399
    342400<screen role='root'><literal>[global]
    … …  
    345403    unix charset = <replaceable>ISO-8859-1</replaceable></literal></screen>
    346404
    347         <para>The values in this example specify that the computer belongs to a
    348         Windows workgroup named
    349         <quote><replaceable>MYGROUP</replaceable></quote>, uses the
    350         <quote><replaceable>cp850</replaceable></quote> character set on the
    351         wire when talking to MS-DOS and MS Windows 9x, and that the filenames
    352         are stored in the <quote><replaceable>ISO-8859-1</replaceable></quote>
    353         encoding on the disk. Adjust these values appropriately for your
    354         installation. The <quote>unix charset</quote> value must be the same as
    355         the output of <command>locale charmap</command> when executed with the
    356         <envar>LANG</envar> variable set to your preferred locale, otherwise the
    357         <command>ls</command> command may not display correct filenames of
    358         downloaded files.</para>
    359 
    360         <para>There is no need to run any <application>Samba</application>
    361         servers in this scenario, thus you don't need to install the provided
    362         bootscripts.</para>
     405        <para>
     406          The values in this example specify that the computer belongs to a
     407          Windows workgroup named
     408          <quote><replaceable>MYGROUP</replaceable></quote>, uses the
     409          <quote><replaceable>cp850</replaceable></quote> character set on the
     410          wire when talking to MS-DOS and MS Windows 9x, and that the filenames
     411          are stored in the <quote><replaceable>ISO-8859-1</replaceable></quote>
     412          encoding on the disk. Adjust these values appropriately for your
     413          installation. The <quote>unix charset</quote> value must be the same
     414          as the output of <command>locale charmap</command> when executed with
     415          the <envar>LANG</envar> variable set to your preferred locale,
     416          otherwise the <command>ls</command> command may not display correct
     417          filenames of downloaded files.
     418        </para>
     419
     420        <para>
     421          There is no need to run any <application>Samba</application>
     422          servers in this scenario, thus you don't need to install the provided
     423          bootscripts.
     424        </para>
    363425
    364426      </sect4>
    … …  
    367429        <title>Scenario 2: Standalone File/Print Server</title>
    368430
    369         <para>Choose this variant if you want to share your files and printers
    370         to Windows machines in your workgroup in addition to the capabilities
    371         described in Scenario 1.</para>
    372 
    373         <para>In this case, the <filename>/etc/samba/smb.conf.default</filename>
    374         file may be a good template to start from. Also add
    375         <quote>dos charset</quote> and <quote>unix charset</quote> parameters
    376         to the <quote>[global]</quote> section as described in Scenario 1 in
    377         order to prevent filename corruption. For security reasons, you may
    378         wish to define
    379         <replaceable>path = /home/alice/shared-files</replaceable>,
    380         assuming your user name is <replaceable>alice</replaceable> and you
    381         only want to share the files in that directory, instead of your entire
    382         home. Then, replace <replaceable>homes</replaceable> by
    383         <replaceable>shared-files</replaceable> and change also the
    384         <quote><literal>comment</literal></quote> if used the configuration
    385         file below or the <filename>/etc/samba/smb.conf.default</filename>
    386         to create yours.</para>
    387 
    388         <para>The following configuration file creates a separate share for each
    389         user's home directory and also makes all printers available to Windows
    390         machines:</para>
     431        <para>
     432          Choose this variant if you want to share your files and printers
     433          to Windows machines in your workgroup in addition to the capabilities
     434          described in Scenario 1.
     435        </para>
     436
     437        <para>
     438          In this case, the <filename>/etc/samba/smb.conf.default</filename>
     439          file may be a good template to start from. Also add
     440          <quote>dos charset</quote> and <quote>unix charset</quote> parameters
     441          to the <quote>[global]</quote> section as described in Scenario 1 in
     442          order to prevent filename corruption. For security reasons, you may
     443          wish to define
     444          <replaceable>path = /home/alice/shared-files</replaceable>,
     445          assuming your user name is <replaceable>alice</replaceable> and you
     446          only want to share the files in that directory, instead of your entire
     447          home. Then, replace <replaceable>homes</replaceable> by
     448          <replaceable>shared-files</replaceable> and change also the
     449          <quote><literal>comment</literal></quote> if used the configuration
     450          file below or the <filename>/etc/samba/smb.conf.default</filename>
     451          to create yours.
     452        </para>
     453
     454        <para>
     455          The following configuration file creates a separate share for each
     456          user's home directory and also makes all printers available to Windows
     457          machines:
     458        </para>
    391459
    392460<screen role='root'><literal>[global]
    … …  
    407475    printable = yes</literal></screen>
    408476
    409         <para>Other parameters you may wish to customize in the
    410         <quote>[global]</quote> section include:</para>
     477        <para>
     478          Other parameters you may wish to customize in the
     479          <quote>[global]</quote> section include:
     480        </para>
    411481
    412482<screen role='root'><literal>    server string =
    … …  
    419489    local master =</literal></screen>
    420490
    421         <para>Reference the comments in the
    422         <filename>/etc/samba/smb.conf.default</filename> file for information
    423         regarding these parameters.</para>
    424 
    425         <para>Since the <command>smbd</command> and <command>nmbd</command>
    426         daemons are needed in this case, install the <filename>samba</filename>
    427         bootscript. Be sure to run <command>smbpasswd</command> (with the
    428         <option>-a</option> option to add users) to enable and
    429         set passwords for all accounts that need
    430         <application>Samba</application> access. Using the default
    431         <application>Samba</application> passdb backend, any user you attempt
    432         to add will also be required to exist in the
    433         <filename>/etc/passwd</filename> file.</para>
     491        <para>
     492          Reference the comments in the
     493          <filename>/etc/samba/smb.conf.default</filename> file for information
     494          regarding these parameters.
     495        </para>
     496
     497        <para>
     498          Since the <command>smbd</command> and <command>nmbd</command> daemons
     499          are needed in this case, install the <filename>samba</filename>
     500          bootscript. Be sure to run <command>smbpasswd</command> (with the
     501          <option>-a</option> option to add users) to enable and set passwords
     502          for all accounts that need <application>Samba</application> access.
     503          Using the default <application>Samba</application> passdb backend,
     504          any user you attempt to add will also be required to exist in the
     505          <filename>/etc/passwd</filename> file.
     506        </para>
    434507
    435508      </sect4>
    … …  
    438511        <title>Advanced Requirements</title>
    439512
    440         <para>More complex scenarios involving domain control or membership are
    441         possible.  Such setups are advanced topics and cannot be adequately
    442         covered in BLFS. Many complete books have been written on these topics
    443         alone.  Note that in some domain membership scenarios, the
    444         <command>winbindd</command> daemon and the corresponding bootscript are
    445         needed.</para>
    446 
    447         <para>There is quite a bit of documentation available which covers many
    448         of these advanced configurations. Point your web browser to the links
    449         below to view some of the documentation included with the
    450         <application>Samba</application> package:</para>
     513        <para>
     514          More complex scenarios involving domain control or membership are
     515          possible. Such setups are advanced topics and cannot be adequately
     516          covered in BLFS. Many complete books have been written on these topics
     517          alone. Note that in some domain membership scenarios, the
     518          <command>winbindd</command> daemon and the corresponding bootscript
     519          are needed.
     520        </para>
     521
     522        <para>
     523          There is quite a bit of documentation available which covers many
     524          of these advanced configurations. Point your web browser to the links
     525          below to view some of the documentation included with the
     526          <application>Samba</application> package:
     527        </para>
    451528
    452529        <itemizedlist spacing='compact'>
    453530          <listitem>
    454             <para>Using Samba, 2nd Edition; a popular book published by O'Reilly
    455             <ulink url="http://www.samba.org/samba/docs/using_samba/toc.html"/></para>
    456           </listitem>
    457           <listitem>
    458             <para>The Official Samba HOWTO and Reference Guide <ulink
    459             url="http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/"/>
     531            <para>
     532              Using Samba, 2nd Edition; a popular book published by O'Reilly
     533              <ulink url=
     534                "http://www.samba.org/samba/docs/using_samba/toc.html"/>
    460535            </para>
    461536          </listitem>
    462537          <listitem>
    463             <para>Samba-3 by Example
    464             <ulink url="http://www.samba.org/samba/docs/man/Samba-Guide/"/>
     538            <para>
     539              The Official Samba HOWTO and Reference Guide <ulink url=
     540               "http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/"/>
     541            </para>
     542          </listitem>
     543          <listitem>
     544            <para>
     545              Samba-3 by Example
     546              <ulink url="http://www.samba.org/samba/docs/man/Samba-Guide/"/>
    465547            </para>
    466548          </listitem>
    … …  
    472554        <title>Guest account</title>
    473555
    474         <para>The default <application>Samba</application> installation uses the
    475         <systemitem class='username'>nobody</systemitem> user for guest access
    476         to the server. This can be overridden by setting the
    477         <option>guest account =</option> parameter in the
    478         <filename>/etc/samba/smb.conf</filename> file. If you utilize the
    479         <option>guest account =</option> parameter, ensure this user exists in
    480         the <filename>/etc/passwd</filename> file.</para>
     556        <para>
     557          The default <application>Samba</application> installation uses the
     558          <systemitem class='username'>nobody</systemitem> user for guest
     559          access to the server. This can be overridden by setting the
     560          <option>guest account =</option> parameter in the
     561          <filename>/etc/samba/smb.conf</filename> file. If you utilize the
     562          <option>guest account =</option> parameter, ensure this user exists
     563          in the <filename>/etc/passwd</filename> file.
     564        </para>
    481565
    482566      </sect4>
    … …  
    485569        <title>Boot Script</title>
    486570
    487         <para>For your convenience, boot scripts have been provided for
    488         <application>Samba</application>. There are two included in the
    489         <xref linkend="bootscripts"/> package. The first,
    490         <filename>samba</filename>, will start the <command>smbd</command>
    491         and <command>nmbd</command> daemons needed to provide SMB/CIFS
    492         services. The second script, <filename>winbind</filename>, starts
    493         the <command>winbindd</command> daemon, used for providing Windows
    494         domain services to Linux clients.</para>
     571        <para>
     572          For your convenience, boot scripts have been provided for
     573          <application>Samba</application>. There are two included in the
     574          <xref linkend="bootscripts"/> package. The first,
     575          <filename>samba</filename>, will start the <command>smbd</command>
     576          and <command>nmbd</command> daemons needed to provide SMB/CIFS
     577          services. The second script, <filename>winbind</filename>, starts
     578          the <command>winbindd</command> daemon, used for providing Windows
     579          domain services to Linux clients.
     580        </para>
    495581
    496582        <indexterm zone="samba samba-init">
    … …  
    538624
    539625        <note>
    540         <para>This package comes with two types of units: A service file and a
    541         socket file. The service file will start the smbd daemon once at boot
    542         and it will keep running until the system shuts down. The socket file
    543         will make systemd listen on the smbd port (Default 445, needs to be
    544         edited for anything else) and will start the smbd daemon when something
    545         tries to connect to that port and stop the daemon when the connection
    546         is terminated. This is called socket activation and is analogous to
    547         using <application>{,x}inetd</application> on a SysVinit based
    548         system.</para>
    549 
    550         <para>By default, the first method is used - the smbd daemon is started
    551         at boot and stopped at shutdown. If the socket method is desired, you
    552         need to run the following commands as the
    553         <systemitem class="username">root</systemitem> user:</para>
     626          <para>
     627            This package comes with two types of units: A service file and a
     628            socket file. The service file will start the smbd daemon once at
     629            boot and it will keep running until the system shuts down. The
     630            socket file will make systemd listen on the smbd port (Default 445,
     631            needs to be edited for anything else) and will start the smbd
     632            daemon when something tries to connect to that port and stop the
     633            daemon when the connection is terminated. This is called socket
     634            activation and is analogous to using
     635            <application>{,x}inetd</application> on a SysVinit based system.
     636          </para>
     637
     638          <para>
     639            By default, the first method is used - the smbd daemon is started
     640            at boot and stopped at shutdown. If the socket method is desired,
     641            you need to run the following commands as the <systemitem
     642            class="username">root</systemitem> user:
     643          </para>
    554644
    555645<screen role="root"><userinput>systemctl stop smbd &amp;&amp;
    … …  
    558648systemctl start smbd.socket</userinput></screen>
    559649
    560         <para>Note that only the smbd daemon can be socket activated.</para>
     650          <para>
     651            Note that only the smbd daemon can be socket activated.
     652          </para>
    561653        </note>
    562654      </sect4>
    … …  
    626718        <term><command>cifsdd</command></term>
    627719        <listitem>
    628           <para>is the dd command for SMB.</para>
     720          <para>
     721            is the dd command for SMB.
     722          </para>
    629723          <indexterm zone="samba cifsdd">
    630724            <primary sortas="b-cifsdd">cifsdd</primary>
    … …  
    636730        <term><command>dbwrap_tool</command></term>
    637731        <listitem>
    638           <para>is used to read and manipulate TDB/CTDB databases using
    639             the dbwrap interface.</para>
     732          <para>
     733            is used to read and manipulate TDB/CTDB databases using
     734            the dbwrap interface.
     735          </para>
    640736          <indexterm zone="samba dbwrap_tool">
    641737            <primary sortas="b-dbwrap_tool">dbwrap_tool</primary>
    … …  
    647743        <term><command>eventlogadm</command></term>
    648744        <listitem>
    649           <para>is used to write records to eventlogs from STDIN, add the
    650           specified source and DLL eventlog registry entries and display the
    651           active eventlog names (from <filename>smb.conf</filename>).</para>
     745          <para>
     746            is used to write records to eventlogs from STDIN, add the
     747            specified source and DLL eventlog registry entries and display the
     748            active eventlog names (from <filename>smb.conf</filename>).
     749          </para>
    652750          <indexterm zone="samba eventlogadm">
    653751            <primary sortas="b-eventlogadm">eventlogadm</primary>
    … …  
    659757        <term><command>findsmb</command></term>
    660758        <listitem>
    661           <para>is used to list info about machines that respond to SMB name
    662           queries on a subnet.</para>
     759          <para>
     760            is used to list info about machines that respond to SMB name
     761            queries on a subnet.
     762          </para>
    663763          <indexterm zone="samba findsmb">
    664764            <primary sortas="b-findsmb">findsmb</primary>
    … …  
    670770        <term><command>gentest</command></term>
    671771        <listitem>
    672           <para>is used to run random generic SMB operations against two
    673            SMB servers and show the differences in behavior.</para>
     772          <para>
     773            is used to run random generic SMB operations against two
     774            SMB servers and show the differences in behavior.
     775          </para>
    674776          <indexterm zone="samba gentest">
    675777            <primary sortas="b-gentest">gentest</primary>
    … …  
    681783        <term><command>ldbadd</command></term>
    682784        <listitem>
    683           <para>is a command-line utility for adding records to an LDB
    684           database.</para>
     785          <para>
     786            is a command-line utility for adding records to an LDB
     787            database.
     788          </para>
    685789          <indexterm zone="samba ldbadd">
    686790            <primary sortas="b-ldbadd">ldbadd</primary>
    … …  
    692796        <term><command>ldbdel</command></term>
    693797        <listitem>
    694           <para>is a command-line program for deleting LDB database
    695           records.</para>
     798          <para>
     799            is a command-line program for deleting LDB database records.
     800          </para>
    696801          <indexterm zone="samba ldbdel">
    697802            <primary sortas="b-ldbdel">ldbdel</primary>
    … …  
    703808        <term><command>ldbedit</command></term>
    704809        <listitem>
    705           <para>allows you to edit LDB databases using your preferred
    706           editor.</para>
     810          <para>
     811            allows you to edit LDB databases using your preferred editor.
     812          </para>
    707813          <indexterm zone="samba ldbedit">
    708814            <primary sortas="b-ldbedit">ldbedit</primary>
    … …  
    714820        <term><command>ldbmodify</command></term>
    715821        <listitem>
    716           <para>allows you to modify records in an LDB database.</para>
     822          <para>
     823            allows you to modify records in an LDB database.
     824          </para>
    717825          <indexterm zone="samba ldbmodify">
    718826            <primary sortas="b-ldbmodify">ldbmodify</primary>
    … …  
    724832        <term><command>ldbrename</command></term>
    725833        <listitem>
    726           <para>allows you to rename LDB databases.</para>
     834          <para>
     835            allows you to rename LDB databases.
     836          </para>
    727837          <indexterm zone="samba ldbrename">
    728838            <primary sortas="b-ldbrename">ldbrename</primary>
    … …  
    734844        <term><command>ldbsearch</command></term>
    735845        <listitem>
    736           <para>searches an LDB database for records matching a specified
    737           expression.</para>
     846          <para>
     847            searches an LDB database for records matching a specified
     848            expression.
     849          </para>
    738850          <indexterm zone="samba ldbsearch">
    739851            <primary sortas="b-ldbsearch">ldbsearch</primary>
    … …  
    745857        <term><command>locktest</command></term>
    746858        <listitem>
    747           <para>is used to find differences in locking between two SMB
    748            servers.</para>
     859          <para>
     860            is used to find differences in locking between two SMB servers.
     861          </para>
    749862          <indexterm zone="samba locktest">
    750863            <primary sortas="b-locktest">locktest</primary>
    … …  
    756869        <term><command>masktest</command></term>
    757870        <listitem>
    758           <para>is used to find differences in wildcard matching between
    759            Samba's implementation and that of a remote server.</para>
     871          <para>
     872            is used to find differences in wildcard matching between
     873            Samba's implementation and that of a remote server.
     874          </para>
    760875          <indexterm zone="samba masktest">
    761876            <primary sortas="b-masktest">masktest</primary>
    … …  
    767882        <term><command>mvxattr</command></term>
    768883        <listitem>
    769           <para>is used to recursively rename extended attributes.</para>
     884          <para>
     885            is used to recursively rename extended attributes.
     886          </para>
    770887          <indexterm zone="samba mvxattr">
    771888            <primary sortas="b-mvxattr">mvxattr</primary>
    … …  
    777894        <term><command>ndrdump</command></term>
    778895        <listitem>
    779           <para>is a DCE/RPC Packet Parser and Dumper.</para>
     896          <para>
     897            is a DCE/RPC Packet Parser and Dumper.
     898          </para>
    780899          <indexterm zone="samba ndrdump">
    781900            <primary sortas="b-ndrdump">ndrdump</primary>
    … …  
    787906        <term><command>net</command></term>
    788907        <listitem>
    789           <para>is a tool for administration of
    790           <application>Samba</application> and remote CIFS servers, similar
    791           to the <command>net</command> utility for DOS/Windows.</para>
     908          <para>
     909            is a tool for administration of <application>Samba</application>
     910            and remote CIFS servers, similar to the <command>net</command>
     911            utility for DOS/Windows.
     912          </para>
    792913          <indexterm zone="samba net">
    793914            <primary sortas="b-net">net</primary>
    … …  
    799920        <term><command>nmbd</command></term>
    800921        <listitem>
    801           <para>is the <application>Samba</application>
    802           NetBIOS name server.</para>
     922          <para>
     923            is the <application>Samba</application> NetBIOS name server.
     924          </para>
    803925          <indexterm zone="samba nmbd">
    804926            <primary sortas="b-nmbd">nmbd</primary>
    … …  
    810932        <term><command>nmblookup</command></term>
    811933        <listitem>
    812           <para>is used to query NetBIOS names and map
    813           them to IP addresses.</para>
     934          <para>
     935            is used to query NetBIOS names and map them to IP addresses.
     936          </para>
    814937          <indexterm zone="samba nmblookup">
    815938            <primary sortas="b-nmblookup">nmblookup</primary>
    … …  
    821944        <term><command>ntlm_auth</command></term>
    822945        <listitem>
    823           <para>is a tool to allow external access to Winbind's
    824           NTLM authentication function.</para>
     946          <para>
     947            is a tool to allow external access to Winbind's
     948            NTLM authentication function.
     949          </para>
    825950          <indexterm zone="samba ntlm_auth">
    826951            <primary sortas="b-ntlm_auth">ntlm_auth</primary>
    … …  
    832957        <term><command>oLschema2ldif</command></term>
    833958        <listitem>
    834           <para>converts LDAP schema's to LDB-compatible LDIF.</para>
     959          <para>
     960            converts LDAP schema's to LDB-compatible LDIF.
     961          </para>
    835962          <indexterm zone="samba oLschema2ldif">
    836963            <primary sortas="b-oLschema2ldif">oLschema2ldif</primary>
    … …  
    842969        <term><command>pdbedit</command></term>
    843970        <listitem>
    844           <para>is a tool used to manage the SAM database.</para>
     971          <para>
     972            is a tool used to manage the SAM database.
     973          </para>
    845974          <indexterm zone="samba pdbedit">
    846975            <primary sortas="b-pdbedit">pdbedit</primary>
    … …  
    852981        <term><command>pidl</command></term>
    853982        <listitem>
    854           <para>is an IDL (Interface Definition Language) compiler
    855             written in Perl.</para>
     983          <para>
     984            is an IDL (Interface Definition Language) compiler
     985            written in Perl.
     986          </para>
    856987          <indexterm zone="samba pidl">
    857988            <primary sortas="b-pidl">pidl</primary>
    … …  
    863994        <term><command>profiles</command></term>
    864995        <listitem>
    865           <para>is a utility that reports and changes SIDs in Windows
    866           registry files. It currently only supports Windows NT.</para>
     996          <para>
     997            is a utility that reports and changes SIDs in Windows
     998            registry files. It currently only supports Windows NT.
     999          </para>
    8671000          <indexterm zone="samba profiles">
    8681001            <primary sortas="b-profiles">profiles</primary>
    … …  
    8741007        <term><command>regdiff</command></term>
    8751008        <listitem>
    876           <para>is a Diff program for Windows registry files.</para>
     1009          <para>
     1010            is a Diff program for Windows registry files.
     1011          </para>
    8771012          <indexterm zone="samba regdiff">
    8781013            <primary sortas="b-regdiff">regdiff</primary>
    … …  
    8841019        <term><command>regpatch</command></term>
    8851020        <listitem>
    886           <para>applies registry patches to registry files.</para>
     1021          <para>
     1022            applies registry patches to registry files.
     1023          </para>
    8871024          <indexterm zone="samba regpatch">
    8881025            <primary sortas="b-regpatch">regpatch</primary>
    … …  
    8941031        <term><command>regshell</command></term>
    8951032        <listitem>
    896           <para>is a Windows registry file browser using readline.</para>
     1033          <para>
     1034            is a Windows registry file browser using readline.
     1035          </para>
    8971036          <indexterm zone="samba regshell">
    8981037            <primary sortas="b-regshell">regshell</primary>
    … …  
    9041043        <term><command>regtree</command></term>
    9051044        <listitem>
    906           <para>is a text-mode registry viewer.</para>
     1045          <para>
     1046            is a text-mode registry viewer.
     1047          </para>
    9071048          <indexterm zone="samba regtree">
    9081049            <primary sortas="b-regtree">regtree</primary>
    … …  
    9141055        <term><command>rpcclient</command></term>
    9151056        <listitem>
    916           <para>is used to execute MS-RPC client side functions.</para>
     1057          <para>
     1058            is used to execute MS-RPC client side functions.
     1059          </para>
    9171060          <indexterm zone="samba rpcclient">
    9181061            <primary sortas="b-rpcclient">rpcclient</primary>
    … …  
    9241067        <term><command>samba</command></term>
    9251068        <listitem>
    926           <para>is a server to provide AD and SMB/CIFS services
    927            to clients.</para>
     1069          <para>
     1070            is a server to provide AD and SMB/CIFS services
     1071            to clients.
     1072          </para>
    9281073          <indexterm zone="samba samba-prog">
    9291074            <primary sortas="b-samba-prog">samba</primary>
    … …  
    9351080        <term><command>samba_dnsupdate</command></term>
    9361081        <listitem>
    937           <para>is used to update our DNS names using TSIG-GSS.</para>
     1082          <para>
     1083            is used to update our DNS names using TSIG-GSS.
     1084          </para>
    9381085          <indexterm zone="samba samba_dnsupdate">
    9391086            <primary sortas="b-samba_dnsupdate">samba_dnsupdate</primary>
    … …  
    9451092        <term><command>samba_kcc</command></term>
    9461093        <listitem>
    947           <para>is a script used to compute your KCC (Knowledge
    948            Consistency Checker) topology.</para>
     1094          <para>
     1095            is a script used to compute your KCC (Knowledge
     1096            Consistency Checker) topology.
     1097          </para>
    9491098          <indexterm zone="samba samba_kcc">
    9501099            <primary sortas="b-samba_kcc">samba_kcc</primary>
    … …  
    9561105        <term><command>samba-gpupdate</command></term>
    9571106        <listitem>
    958           <para>allows you to edit Microsoft Group Policy Objects (GPOs).</para>
     1107          <para>
     1108            allows you to edit Microsoft Group Policy Objects (GPOs).
     1109          </para>
    9591110          <indexterm zone="samba samba-gpupdate">
    9601111            <primary sortas="b-samba-gpupdate">samba-gpupdate</primary>
    … …  
    9661117        <term><command>samba-regedit</command></term>
    9671118        <listitem>
    968           <para>is a ncurses based tool to manage the Samba registry.</para>
     1119          <para>
     1120            is a ncurses based tool to manage the Samba registry.
     1121          </para>
    9691122          <indexterm zone="samba samba-regedit">
    9701123            <primary sortas="b-samba-regedit">samba-regedit</primary>
    … …  
    9761129        <term><command>samba_spnupdate</command></term>
    9771130        <listitem>
    978           <para>is a script to update the servicePrincipalName
    979            names from spn_update_list.</para>
     1131          <para>
     1132            is a script to update the servicePrincipalName
     1133            names from spn_update_list.
     1134          </para>
    9801135          <indexterm zone="samba samba_spnupdate">
    9811136            <primary sortas="b-samba_spnupdate">samba_spnupdate</primary>
    … …  
    9871142        <term><command>samba-tool</command></term>
    9881143        <listitem>
    989           <para>is the main Samba administration tool.</para>
     1144          <para>
     1145            is the main Samba administration tool.
     1146          </para>
    9901147          <indexterm zone="samba samba-tool">
    9911148            <primary sortas="b-samba-tool">samba-tool</primary>
    … …  
    9971154        <term><command>samba_upgradedns</command></term>
    9981155        <listitem>
    999           <para>is a Unix SMB/CIFS implementation.</para>
     1156          <para>
     1157            is a Unix SMB/CIFS implementation.
     1158          </para>
    10001159          <indexterm zone="samba samba_upgradedns">
    10011160            <primary sortas="b-samba_upgradedns">samba_upgradedns</primary>
    … …  
    10071166        <term><command>sharesec</command></term>
    10081167        <listitem>
    1009           <para>manipulates share ACL permissions on SMB file shares.</para>
     1168          <para>
     1169            manipulates share ACL permissions on SMB file shares.
     1170          </para>
    10101171          <indexterm zone="samba sharesec">
    10111172            <primary sortas="b-sharesec">sharesec</primary>
    … …  
    10171178        <term><command>smbcacls</command></term>
    10181179        <listitem>
    1019           <para>is used to manipulate Windows NT access control lists.</para>
     1180          <para>
     1181            is used to manipulate Windows NT access control lists.
     1182          </para>
    10201183          <indexterm zone="samba smbcacls">
    10211184            <primary sortas="b-smbcacls">smbcacls</primary>
    … …  
    10271190        <term><command>smbclient</command></term>
    10281191        <listitem>
    1029           <para>is a SMB/CIFS access utility, similar to FTP.</para>
     1192          <para>
     1193            is a SMB/CIFS access utility, similar to FTP.
     1194          </para>
    10301195          <indexterm zone="samba smbclient">
    10311196            <primary sortas="b-smbclient">smbclient</primary>
    … …  
    10371202        <term><command>smbcontrol</command></term>
    10381203        <listitem>
    1039           <para>is used to control running <command>smbd</command>,
    1040           <command>nmbd</command> and <command>winbindd</command>
    1041           daemons.</para>
     1204          <para>
     1205            is used to control running <command>smbd</command>,
     1206            <command>nmbd</command> and <command>winbindd</command> daemons.
     1207          </para>
    10421208          <indexterm zone="samba smbcontrol">
    10431209            <primary sortas="b-smbcontrol">smbcontrol</primary>
    … …  
    10491215        <term><command>smbcquotas</command></term>
    10501216        <listitem>
    1051           <para>is used to manipulate Windows NT quotas on
    1052           SMB file shares.</para>
     1217          <para>
     1218            is used to manipulate Windows NT quotas on SMB file shares.
     1219          </para>
    10531220          <indexterm zone="samba smbcquotas">
    10541221            <primary sortas="b-smbcquotas">smbcquotas</primary>
    … …  
    10601227        <term><command>smbd</command></term>
    10611228        <listitem>
    1062           <para>is the main <application>Samba</application> daemon which
    1063           provides SMB/CIFS services to clients.</para>
     1229          <para>
     1230            is the main <application>Samba</application> daemon which
     1231            provides SMB/CIFS services to clients.
     1232          </para>
    10641233          <indexterm zone="samba smbd">
    10651234            <primary sortas="b-smbd">smbd</primary>
    … …  
    10711240        <term><command>smbget</command></term>
    10721241        <listitem>
    1073           <para>is a simple utility with <command>wget</command>-like
    1074           semantics, that can download files from SMB servers. You can specify
    1075           the files you would like to download on the command-line.</para>
     1242          <para>
     1243            is a simple utility with <command>wget</command>-like semantics,
     1244            that can download files from SMB servers. You can specify the
     1245            files you would like to download on the command-line.
     1246          </para>
    10761247          <indexterm zone="samba smbget">
    10771248            <primary sortas="b-smbget">smbget</primary>
    … …  
    10831254        <term><command>smbpasswd</command></term>
    10841255        <listitem>
    1085           <para>changes a user's <application>Samba</application>
    1086           password.</para>
     1256          <para>
     1257            changes a user's <application>Samba</application> password.
     1258          </para>
    10871259          <indexterm zone="samba smbpasswd">
    10881260            <primary sortas="b-smbpasswd">smbpasswd</primary>
    … …  
    10941266        <term><command>smbspool</command></term>
    10951267        <listitem>
    1096           <para>sends a print job to an SMB printer.</para>
     1268          <para>
     1269            sends a print job to an SMB printer.
     1270          </para>
    10971271          <indexterm zone="samba smbspool">
    10981272            <primary sortas="b-smbspool">smbspool</primary>
    … …  
    11041278        <term><command>smbstatus</command></term>
    11051279        <listitem>
    1106           <para>reports current <application>Samba</application>
    1107           connections.</para>
     1280          <para>
     1281            reports current <application>Samba</application> connections.
     1282          </para>
    11081283          <indexterm zone="samba smbstatus">
    11091284            <primary sortas="b-smbstatus">smbstatus</primary>
    … …  
    11151290        <term><command>smbtar</command></term>
    11161291        <listitem>
    1117           <para>is a shell script used for backing up SMB/CIFS shares
    1118           directly to Linux tape drives or a file.</para>
     1292          <para>
     1293            is a shell script used for backing up SMB/CIFS shares
     1294            directly to Linux tape drives or a file.
     1295          </para>
    11191296          <indexterm zone="samba smbtar">
    11201297            <primary sortas="b-smbtar">smbtar</primary>
    … …  
    11271304        <term><command>smbta-util</command></term>
    11281305        <listitem>
    1129           <para>is a tool to ease the configuration of the
    1130            vfs_smb_traffic_analyzer module regarding data encryption.</para>
     1306          <para>
     1307            is a tool to ease the configuration of the
     1308            vfs_smb_traffic_analyzer module regarding data encryption.
     1309          </para>
    11311310          <indexterm zone="samba smbta-util">
    11321311            <primary sortas="b-smbta-util">smbta-util</primary>
    … …  
    11391318        <term><command>smbtorture</command></term>
    11401319        <listitem>
    1141           <para>is  a testsuite that runs several tests against a SMB
    1142             server.</para>
     1320          <para>
     1321            is  a testsuite that runs several tests against a SMB server.
     1322          </para>
    11431323          <indexterm zone="samba smbtorture">
    11441324            <primary sortas="b-smbtorture">smbtorture</primary>
    … …  
    11501330        <term><command>smbtree</command></term>
    11511331        <listitem>
    1152           <para>is a text-based SMB network browser.</para>
     1332          <para>
     1333            is a text-based SMB network browser.
     1334          </para>
    11531335          <indexterm zone="samba smbtree">
    11541336            <primary sortas="b-smbtree">smbtree</primary>
    … …  
    11601342        <term><command>tdbbackup</command></term>
    11611343        <listitem>
    1162           <para>is a tool for backing up or validating the integrity of
    1163           <application>Samba</application> <filename>.tdb</filename>
    1164           files.</para>
     1344          <para>
     1345            is a tool for backing up or validating the integrity of
     1346            <application>Samba</application> <filename>.tdb</filename> files.
     1347          </para>
    11651348          <indexterm zone="samba tdbbackup">
    11661349            <primary sortas="b-tdbbackup">tdbbackup</primary>
    … …  
    11721355        <term><command>tdbdump</command></term>
    11731356        <listitem>
    1174           <para> is a tool used to print the contents of a
    1175           <application>Samba</application> <filename>.tdb</filename>
    1176           file.</para>
     1357          <para>
     1358            is a tool used to print the contents of a
     1359            <application>Samba</application> <filename>.tdb</filename> file.
     1360          </para>
    11771361          <indexterm zone="samba tdbdump">
    11781362            <primary sortas="b-tdbdump">tdbdump</primary>
    … …  
    11841368        <term><command>tdbrestore</command></term>
    11851369        <listitem>
    1186           <para> is a tool for creating a <application>Samba</application>
    1187             <filename>.tdb</filename> file out of a ntdbdump.</para>
     1370          <para>
     1371            is a tool for creating a <application>Samba</application>
     1372            <filename>.tdb</filename> file out of a ntdbdump.
     1373          </para>
    11881374          <indexterm zone="samba tdbrestore">
    11891375            <primary sortas="b-tdbrestore">tdbrestore</primary>
    … …  
    11951381        <term><command>tdbtool</command></term>
    11961382        <listitem>
    1197           <para>is a tool which allows simple database manipulation from the
    1198           command line.</para>
     1383          <para>
     1384            is a tool which allows simple database manipulation from the
     1385            command line.
     1386          </para>
    11991387          <indexterm zone="samba tdbtool">
    12001388            <primary sortas="b-tdbtool">tdbtool</primary>
    … …  
    12061394        <term><command>testparm</command></term>
    12071395        <listitem>
    1208           <para>checks an <filename>smb.conf</filename> file for proper
    1209           syntax.</para>
     1396          <para>
     1397            checks an <filename>smb.conf</filename> file for proper syntax.
     1398          </para>
    12101399          <indexterm zone="samba testparm">
    12111400            <primary sortas="b-testparm">testparm</primary>
    … …  
    12171406        <term><command>wbinfo</command></term>
    12181407        <listitem>
    1219           <para>queries a running <command>winbindd</command> daemon.</para>
     1408          <para>
     1409            queries a running <command>winbindd</command> daemon.
     1410          </para>
    12201411          <indexterm zone="samba wbinfo">
    12211412            <primary sortas="b-wbinfo">wbinfo</primary>
    … …  
    12271418        <term><command>winbindd</command></term>
    12281419        <listitem>
    1229           <para>resolves names from Windows NT servers.</para>
     1420          <para>
     1421            resolves names from Windows NT servers.
     1422          </para>
    12301423          <indexterm zone="samba winbindd">
    12311424            <primary sortas="b-winbindd">winbindd</primary>
    … …  
    12371430        <term><filename class='libraryfile'>libnss_winbind.so</filename></term>
    12381431        <listitem>
    1239           <para>provides Name Service Switch API functions for resolving names
    1240           from NT servers.</para>
     1432          <para>
     1433            provides Name Service Switch API functions for resolving names
     1434            from NT servers.
     1435          </para>
    12411436          <indexterm zone="samba libnss_winbind">
    12421437            <primary sortas="c-libnss_winbind">libnss_winbind.so</primary>
    … …  
    12481443        <term><filename class='libraryfile'>libnss_wins.so</filename></term>
    12491444        <listitem>
    1250           <para>provides API functions for Samba's implementation of the
    1251           Windows Internet Naming Service.</para>
     1445          <para>
     1446            provides API functions for Samba's implementation of the
     1447            Windows Internet Naming Service.
     1448          </para>
    12521449          <indexterm zone="samba libnss_wins">
    12531450            <primary sortas="c-libnss_wins">libnss_wins.so</primary>
    … …  
    12591456        <term><filename class='libraryfile'>libnetapi.so</filename></term>
    12601457        <listitem>
    1261           <para>provides the API functions for the administration tools used
    1262           for Samba and remote CIFS servers.</para>
     1458          <para>
     1459            provides the API functions for the administration tools used
     1460            for Samba and remote CIFS servers.
     1461          </para>
    12631462          <indexterm zone="samba libnetapi">
    12641463            <primary sortas="c-libnetapi">libnetapi.so</primary>
    … …  
    12701469        <term><filename class='libraryfile'>libsmbclient.so</filename></term>
    12711470        <listitem>
    1272           <para>provides the API functions for the Samba SMB client tools.</para>
     1471          <para>
     1472            provides the API functions for the Samba SMB client tools.
     1473          </para>
    12731474          <indexterm zone="samba libsmbclient">
    12741475            <primary sortas="c-libsmbclient">libsmbclient.so</primary>
    … …  
    12801481        <term><filename class='libraryfile'>libsmbsharemodes.so</filename></term>
    12811482        <listitem>
    1282           <para>provides API functions for accessing SMB share modes
    1283           (locks etc.)</para>
     1483          <para>
     1484            provides API functions for accessing SMB share modes (locks etc.)
     1485          </para>
    12841486          <indexterm zone="samba libsmbsharemodes">
    12851487            <primary sortas="c-libsmbsharemodes">libsmbsharemodes.so</primary>
    … …  
    12911493        <term><filename class='libraryfile'>libwbclient.so</filename></term>
    12921494        <listitem>
    1293           <para>provides API functions for Windows domain client services.</para>
     1495          <para>
     1496            provides API functions for Windows domain client services.
     1497          </para>
    12941498          <indexterm zone="samba libwbclient">
    12951499            <primary sortas="c-libwbclient">libwbclient.so</primary>
Note: See TracChangeset for help on using the changeset viewer.