Changeset 99ef1fc


Ignore:
Timestamp:
05/18/2005 05:40:42 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
f8ff412
Parents:
b2323d4
Message:

Tagged samba3.xml

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/major/samba3.xml

    rb2323d4 r99ef1fc  
    55  %general-entities;
    66
    7 <!ENTITY samba3-download-http "http://us1.samba.org/samba/ftp/samba-&samba3-version;.tar.gz">
    8 <!ENTITY samba3-download-ftp "ftp://ftp.samba.org/pub/samba/samba-&samba3-version;.tar.gz">
    9 <!ENTITY samba3-md5sum "ebee37e66a8b5f6fd328967dc09088e8">
    10 <!ENTITY samba3-size "15.6 MB">
    11 <!ENTITY samba3-buildsize "147 MB">
    12 <!ENTITY samba3-time "2.21 SBU">
     7  <!ENTITY samba3-download-http "http://us1.samba.org/samba/ftp/samba-&samba3-version;.tar.gz">
     8  <!ENTITY samba3-download-ftp "ftp://ftp.samba.org/pub/samba/samba-&samba3-version;.tar.gz">
     9  <!ENTITY samba3-md5sum "ebee37e66a8b5f6fd328967dc09088e8">
     10  <!ENTITY samba3-size "15.6 MB">
     11  <!ENTITY samba3-buildsize "147 MB">
     12  <!ENTITY samba3-time "2.21 SBU">
    1313]>
    1414
    1515<sect1 id="samba3" xreflabel="Samba-&samba3-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="samba3.html"?>
    21 <title>Samba-&samba3-version;</title>
    22 <indexterm zone="samba3">
    23 <primary sortas="a-Samba">Samba</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>Samba</application></title>
    27 
    28 <para>The <application>Samba</application> package provides file and print
    29 services to <acronym>SMB</acronym>/<acronym>CIFS</acronym> clients and
    30 Windows networking to Linux clients. <application>Samba</application> can also
    31 be configured as a Windows NT 4.0 Domain Controller replacement
    32 (with caveats working with NT <acronym>PDC</acronym>'s and
    33 <acronym>BDC</acronym>'s), a file/print server acting as a member of a
    34 Windows NT 4.0 or Active Directory domain and a NetBIOS (rfc1001/1002)
    35 nameserver (which amongst other things provides
    36 <acronym>LAN</acronym> browsing support).</para>
    37 
    38 <sect3><title>Package information</title>
    39 <itemizedlist spacing='compact'>
    40 <listitem><para>Download (HTTP):
    41 <ulink url="&samba3-download-http;"/></para></listitem>
    42 <listitem><para>Download (FTP):
    43 <ulink url="&samba3-download-ftp;"/></para></listitem>
    44 <listitem><para>Download MD5 sum:
    45 &samba3-md5sum;</para></listitem>
    46 <listitem><para>Download size:
    47 &samba3-size;</para></listitem>
    48 <listitem><para>Estimated disk space required:
    49 &samba3-buildsize;</para></listitem>
    50 <listitem><para>Estimated build time:
    51 &samba3-time;</para></listitem></itemizedlist>
    52 </sect3>
    53 
    54 <sect3>
    55 <title><application>Samba</application> dependencies</title>
    56 <sect4>
    57 <title>Optional</title>
    58 <para><xref linkend="popt"/>,
    59 <xref linkend="Linux_PAM"/>,
    60 <xref linkend="openldap"/>,
    61 <xref linkend="cups"/>,
    62 <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
    63 <xref linkend="libxml2"/>,
    64 <xref linkend="mysql"/> or <xref linkend="postgresql"/>,
    65 <xref linkend="python"/>,
    66 <xref linkend="xinetd"/>,
    67 <ulink url="http://valgrind.kde.org/">Valgrind</ulink> and
    68 <xref linkend="stunnel"/> (used to encrypt access to SWAT)</para>
    69 </sect4>
    70 </sect3>
    71 
    72 </sect2>
    73 
    74 <sect2>
    75 <title>Installation of <application>Samba</application></title>
    76 
    77 <para>Install <application>Samba</application> by running the following
    78 commands:</para>
    79 
    80 <screen><userinput><command>cd source &amp;&amp;
     16  <?dbhtml filename="samba3.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>Samba-&samba3-version;</title>
     24
     25  <indexterm zone="samba3">
     26    <primary sortas="a-Samba">Samba</primary>
     27  </indexterm>
     28
     29  <sect2>
     30    <title>Introduction to Samba</title>
     31
     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 NT
     35    4.0 Domain Controller replacement (with caveats working with NT PDC's and
     36    BDC's), a file/print server acting as a member of a Windows NT 4.0 or
     37    Active Directory domain and a NetBIOS (rfc1001/1002) nameserver (which
     38    amongst other things provides LAN browsing support).</para>
     39
     40    <bridgehead renderas="sect3">Package Information</bridgehead>
     41    <itemizedlist spacing="compact">
     42      <listitem>
     43        <para>Download (HTTP): <ulink url="&samba3-download-http;"/></para>
     44      </listitem>
     45      <listitem>
     46        <para>Download (FTP): <ulink url="&samba3-download-ftp;"/></para>
     47      </listitem>
     48      <listitem>
     49        <para>Download MD5 sum: &samba3-md5sum;</para>
     50      </listitem>
     51      <listitem>
     52        <para>Download size: &samba3-size;</para>
     53      </listitem>
     54      <listitem>
     55        <para>Estimated disk space required: &samba3-buildsize;</para>
     56      </listitem>
     57      <listitem>
     58        <para>Estimated build time: &samba3-time;</para>
     59      </listitem>
     60    </itemizedlist>
     61
     62    <bridgehead renderas="sect3">Samba Dependencies</bridgehead>
     63
     64    <bridgehead renderas="sect4">Optional</bridgehead>
     65    <para><xref linkend="popt"/>,
     66    <xref linkend="Linux_PAM"/>,
     67    <xref linkend="openldap"/>,
     68    <xref linkend="cups"/>,
     69    <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
     70    <xref linkend="libxml2"/>,
     71    <xref linkend="mysql"/> or <xref linkend="postgresql"/>,
     72    <xref linkend="python"/>,
     73    <xref linkend="xinetd"/>,
     74    <ulink url="http://valgrind.kde.org/">Valgrind</ulink> and
     75    <xref linkend="stunnel"/> (used to encrypt access to SWAT)</para>
     76
     77  </sect2>
     78
     79  <sect2 role="installation">
     80    <title>Installation of Samba</title>
     81
     82    <para>Install <application>Samba</application> by running the following
     83    commands:</para>
     84
     85<screen><userinput>cd source &amp;&amp;
    8186./configure \
    8287    --prefix=/usr \
    … …  
    8691    --with-fhs \
    8792    --with-smbmount &amp;&amp;
    88 make</command></userinput></screen>
    89 
    90 <para>Now, as the root user:</para>
    91 
    92 <screen><userinput role='root'><command>install -v -m755 -d /var/cache/samba &amp;&amp;
     93make</userinput></screen>
     94
     95    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     96
     97<screen role="root"><userinput>install -v -m755 -d /var/cache/samba &amp;&amp;
    9398make install &amp;&amp;
    9499mv -v /usr/lib/samba/libsmbclient.so /usr/lib &amp;&amp;
    … …  
    98103ln -v -sf libnss_winbind.so /lib/libnss_winbind.so.2 &amp;&amp;
    99104ln -v -sf libnss_wins.so /lib/libnss_wins.so.2 &amp;&amp;
    100 if [ -f nsswitch/pam_winbind.so ]; then 
     105if [ -f nsswitch/pam_winbind.so ]; then
    101106    install -v -m755 nsswitch/pam_winbind.so /lib/security
    102107fi &amp;&amp;
    103108install -v -m644 ../examples/smb.conf.default /etc/samba &amp;&amp;
    104 install -v -m644 ../docs/*.pdf /usr/share/samba</command></userinput></screen>
    105 
    106 <note><para>You may want to run <command>configure</command> with the
    107 <parameter>--help</parameter> parameter.  There may be other parameters
    108 needed to take advantage of the optional dependencies.</para></note>
    109 
    110 </sect2>
    111 
    112 <sect2>
    113 <title>Command explanations</title>
    114 
    115 <para><parameter>--sysconfdir=/etc</parameter>: Sets the configuration
    116 file directory to avoid the default of
    117 <filename class="directory">/usr/etc</filename>.</para>
    118 
    119 <para><parameter>--localstatedir=/var</parameter>: Sets the variable
    120 data directory to avoid the default of
    121 <filename class="directory">/usr/var</filename>.</para>
    122 
    123 <para><option>--with-fhs</option>: Assigns all other file paths in a manner
    124 compliant with the Filesystem Hierarchy Standard
    125 (<acronym>FHS</acronym>).</para>
    126 
    127 <para><option>--with-smbmount</option>: Orders the creation of an extra
    128 binary for use by the <command>mount</command> command so that mounting remote
    129 <acronym>SMB</acronym> (Windows) shares becomes no more complex than mounting
    130 remote <acronym>NFS</acronym> shares.</para>
    131 
    132 <para><option>--with-pam</option>: Use this parameter to link
    133 <application>Linux-<acronym>PAM</acronym></application> into the build. This
    134 also builds the <filename class='libraryfile'>pam_winbind.so</filename>
    135 <application><acronym>PAM</acronym></application> module. You can find
    136 instructions on how to configure and use the module by running
    137 <command>man winbindd</command>.</para>
    138 
    139 <para><command>install -v -d /var/cache/samba</command>: This directory is
    140 needed for proper operation of the <command>smbd</command> and
    141 <command>nmbd</command> daemons.</para>
    142 
    143 <para><command>mv -v /usr/lib/samba/libsmbclient.so ...; ln -v -sf
    144 ../libsmbclient.so ...</command>: The
    145 <filename class='libraryfile'>libsmbclient.so</filename> library is needed
    146 by other packages. This command moves it to a location where other packages
    147 can find it.</para>
    148 
    149 <para><command>install -v -m755 nsswitch/libnss_win{s,bind}.so /lib</command>:
    150 The nss libraries are not installed by default.  If you intend to use
    151 winbindd for domain auth, and/or <acronym>WINS</acronym> name resolution,
    152 you need these libraries.</para>
    153 
    154 <para><command>ln -v -sf libnss_winbind.so /lib/libnss_winbind.so.2</command>
    155 and <command>ln -v -sf libnss_wins.so /lib/libnss_wins.so.2</command>:
    156 These symlinks are required by glibc to use the <acronym>NSS</acronym>
    157 libraries.</para>
    158 
    159 <para><command>install -v -m644 ../examples/smb.conf.default
    160 /etc/samba</command>: This copies a default <filename>smb.conf</filename> into
    161 <filename>/etc/samba</filename>.  This sample configuration will not
    162 work unless edited for your site, and renamed
    163 <filename>smb.conf</filename>.</para>
    164 
    165 </sect2>
    166 
    167 <sect2>
    168 <title>Configuring <application>Samba</application></title>
    169 
    170 <sect3 id="samba3-config"><title>Config files</title>
    171 <para>/etc/samba/smb.conf</para>
    172 <indexterm zone="samba3 samba3-config">
    173 <primary sortas="e-etc-samba-smb.conf">/etc/samba/smb.conf</primary>
    174 </indexterm>
    175 </sect3>
    176 
    177 <sect3><title>Configuration overview and available documentation</title>
    178 
    179 <para>Due to the complexity and the many various uses for
    180 <application>Samba</application>, complete configuration is well beyond the
    181 scope of the <acronym>BLFS</acronym> book. Advanced configurations including
    182 setting up Primary and Backup Domain Controllers are advanced topics and
    183 cannot be adequately covered in <acronym>BLFS</acronym> (it should be noted,
    184 however, that a <application>Samba</application> <acronym>BDC</acronym> cannot
    185 be used as a fallback for a
    186 <application>Windows</application> <acronym>PDC</acronym>, and conversely, a
    187 <application>Windows</application> <acronym>BDC</acronym> cannot be used as a
    188 fallback for a <application>Samba</application> <acronym>PDC</acronym>). Many
    189 complete books have been written on these topics alone.</para>
    190 
    191 <para>There is quite a bit of documentation available which covers many of
    192 these advanced configurations. Point your web browser to the links below to
    193 view some of the documentation included with the
    194 <application>Samba</application> package:</para>
    195 
    196 <itemizedlist spacing='compact'>
    197 <listitem><para>Using Samba, 2nd Edition; a popular book published by O'Reilly
    198 <ulink url="file:///usr/share/samba/swat/using_samba/toc.html"/></para>
    199 </listitem>
    200 
    201 <listitem><para>The Official Samba HOWTO and Reference Guide <ulink
    202 url="file:///usr/share/samba/swat/help/Samba-HOWTO-Collection/index.html"/>
    203 </para>
    204 </listitem>
    205 
    206 <listitem><para>Samba-3 by Example
    207 <ulink url="file:///usr/share/samba/swat/help/Samba-Guide/index.html"/></para>
    208 </listitem>
    209 
    210 <listitem><para>The Samba-3 man Pages
    211 <ulink url="file:///usr/share/samba/swat/help/samba.7.html"/></para>
    212 </listitem>
    213 </itemizedlist>
    214 </sect3>
    215 
    216 <sect3 id="samba3-swat-config"><title>Configuring SWAT</title>
    217 
    218 <para>The built in <acronym>SWAT</acronym>
    219 (<application>Samba</application> Web Administration Tool) utility can be used
    220 for basic configuration of the <application>Samba</application> installation, 
    221 but because it may be inconvenient, undesireable or perhaps even impossible
    222 to gain access to the console, <acronym>BLFS</acronym> recommends setting up
    223 access to <acronym>SWAT</acronym> using
    224 <application>Stunnel</application>.</para>
    225 <indexterm zone="samba3 samba3-swat-config">
    226 <primary sortas="g-SWAT">SWAT</primary></indexterm>
    227 
    228 <para>First you must add entries to <filename>/etc/services</filename> and
    229 modify the <command>inetd</command>/<command>xinetd</command>
    230 configuration.</para>
    231 
    232 <indexterm zone="samba3 samba3-swat-config">
    233   <primary sortas="e-etc-services">/etc/services</primary>
    234 </indexterm>
    235 
    236 <indexterm zone="samba3 samba3-swat-config">
    237   <primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary>
    238 </indexterm>
    239 
    240 <indexterm zone="samba3 samba3-swat-config">
    241   <primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary>
    242 </indexterm>
    243 
    244 <para>Add swat and swat_tunnel entries to
    245 <filename>/etc/services</filename> with the following commands issued as the
    246 root user:</para>
    247 
    248 <screen><userinput role='root'><command>echo "swat            901/tcp" &gt;&gt; /etc/services &amp;&amp;
    249 echo "swat_tunnel     902/tcp" &gt;&gt; /etc/services</command></userinput></screen>
    250 
    251 <para>If <command>inetd</command> is used, the following command will add the
    252 swat_tunnel entry to <filename>/etc/inetd.conf</filename> (as user
    253 root):</para>
    254 
    255 <screen><userinput role='root'><command>echo "swat_tunnel stream tcp nowait.400 root /usr/sbin/swat swat" \
    256     &gt;&gt; /etc/inetd.conf</command></userinput></screen>
    257 <para>Issue a <command>killall -HUP inetd</command> to reread the
    258 changed <filename>inetd.conf</filename> file.</para>
    259 
    260 <para>If you use <command>xinetd</command>, the following command will create
    261 the <application>Samba</application> file as
    262 <filename>/etc/xinetd.d/swat_tunnel</filename> (you may need to modify or
    263 remove the <quote>only_from</quote> line to include the desired
    264 host[s]):</para>
    265 
    266 <screen><userinput role='root'><command>cat &gt;&gt; /etc/xinetd.d/swat_tunnel &lt;&lt; "EOF"</command>
    267 # Begin /etc/xinetd.d/swat_tunnel
     109install -v -m644 ../docs/*.pdf /usr/share/samba</userinput></screen>
     110
     111    <note>
     112      <para>You may want to run <command>configure</command> with the
     113      <option>--help</option> parameter. There may be other parameters
     114      needed to take advantage of the optional dependencies.</para>
     115    </note>
     116
     117  </sect2>
     118
     119  <sect2 role="commands">
     120    <title>Command Explanations</title>
     121
     122    <para><parameter>--sysconfdir=/etc</parameter>: Sets the configuration
     123    file directory to avoid the default of
     124    <filename class="directory">/usr/etc</filename>.</para>
     125
     126    <para><parameter>--localstatedir=/var</parameter>: Sets the variable
     127    data directory to avoid the default of
     128    <filename class="directory">/usr/var</filename>.</para>
     129
     130    <para><parameter>--with-fhs</parameter>: Assigns all other file paths in
     131    a manner compliant with the Filesystem Hierarchy Standard (FHS).</para>
     132
     133    <para><parameter>--with-smbmount</parameter>: Orders the creation of an
     134    extra binary for use by the <command>mount</command> command so that
     135    mounting remote SMB (Windows) shares becomes no more complex than
     136    mounting remote NFS shares.</para>
     137
     138    <para><option>--with-pam</option>: Use this parameter to link
     139    <application>Linux-PAM</application> into the build. This
     140    also builds the <filename class='libraryfile'>pam_winbind.so</filename>
     141    <application>PAM</application> module. You can find
     142    instructions on how to configure and use the module by running
     143    <command>man winbindd</command>.</para>
     144
     145    <para><command>install -v -d /var/cache/samba</command>: This directory is
     146    needed for proper operation of the <command>smbd</command> and
     147    <command>nmbd</command> daemons.</para>
     148
     149    <para><command>mv -v /usr/lib/samba/libsmbclient.so ...; ln -v -sf
     150    ../libsmbclient.so ...</command>: The
     151    <filename class='libraryfile'>libsmbclient.so</filename> library is needed
     152    by other packages. This command moves it to a location where other packages
     153    can find it.</para>
     154
     155    <para><command>install -v -m755 nsswitch/libnss_win{s,bind}.so /lib</command>:
     156    The nss libraries are not installed by default.  If you intend to use
     157    winbindd for domain auth, and/or WINS name resolution,
     158    you need these libraries.</para>
     159
     160    <para><command>ln -v -sf libnss_winbind.so /lib/libnss_winbind.so.2</command>
     161    and <command>ln -v -sf libnss_wins.so /lib/libnss_wins.so.2</command>:
     162    These symlinks are required by glibc to use the NSS
     163    libraries.</para>
     164
     165    <para><command>install -v -m644 ../examples/smb.conf.default
     166    /etc/samba</command>: This copies a default <filename>smb.conf</filename>
     167    into <filename>/etc/samba</filename>.  This sample configuration will not
     168    work unless edited for your site, and renamed
     169    <filename>smb.conf</filename>.</para>
     170
     171  </sect2>
     172
     173  <sect2 role="configuration">
     174    <title>Configuring Samba</title>
     175
     176    <sect3 id="samba3-config">
     177      <title>Config Files</title>
     178
     179      <para>/etc/samba/smb.conf</para>
     180
     181      <indexterm zone="samba3 samba3-config">
     182        <primary sortas="e-etc-samba-smb.conf">/etc/samba/smb.conf</primary>
     183      </indexterm>
     184
     185    </sect3>
     186
     187    <sect3>
     188      <title>Configuration Overview and Available Documentation</title>
     189
     190      <para>Due to the complexity and the many various uses for
     191      <application>Samba</application>, complete configuration is well beyond
     192      the scope of the BLFS book. Advanced configurations including setting up
     193      Primary and Backup Domain Controllers are advanced topics and cannot be
     194      adequately covered in BLFS (it should be noted, however, that a
     195      <application>Samba</application> BDC cannot be used as a fallback for a
     196      <application>Windows</application> PDC, and conversely, a
     197      <application>Windows</application> BDC cannot be used as a
     198      fallback for a <application>Samba</application> PDC). Many
     199      complete books have been written on these topics alone.</para>
     200
     201      <para>There is quite a bit of documentation available which covers many
     202      of these advanced configurations. Point your web browser to the links
     203      below to view some of the documentation included with the
     204      <application>Samba</application> package:</para>
     205
     206      <itemizedlist spacing='compact'>
     207        <listitem>
     208          <para>Using Samba, 2nd Edition; a popular book published by O'Reilly
     209          <ulink url="file:///usr/share/samba/swat/using_samba/toc.html"/></para>
     210        </listitem>
     211        <listitem>
     212          <para>The Official Samba HOWTO and Reference Guide <ulink
     213          url="file:///usr/share/samba/swat/help/Samba-HOWTO-Collection/index.html"/>
     214          </para>
     215        </listitem>
     216        <listitem>
     217          <para>Samba-3 by Example
     218          <ulink url="file:///usr/share/samba/swat/help/Samba-Guide/index.html"/>
     219          </para>
     220        </listitem>
     221        <listitem>
     222          <para>The Samba-3 man Pages
     223          <ulink url="file:///usr/share/samba/swat/help/samba.7.html"/></para>
     224        </listitem>
     225      </itemizedlist>
     226
     227    </sect3>
     228
     229    <sect3 id="samba3-swat-config">
     230      <title>Configuring SWAT</title>
     231
     232      <para>The built in SWAT (<application>Samba</application> Web
     233      Administration Tool) utility can be used for basic configuration of
     234      the <application>Samba</application> installation, but because it may
     235      be inconvenient, undesireable or perhaps even impossible to gain
     236      access to the console, BLFS recommends setting up access to SWAT using
     237      <application>Stunnel</application>.</para>
     238
     239      <indexterm zone="samba3 samba3-swat-config">
     240        <primary sortas="g-SWAT">SWAT</primary>
     241      </indexterm>
     242
     243      <para>First you must add entries to <filename>/etc/services</filename>
     244      and modify the <command>inetd</command>/<command>xinetd</command>
     245      configuration.</para>
     246
     247      <indexterm zone="samba3 samba3-swat-config">
     248        <primary sortas="e-etc-services">/etc/services</primary>
     249      </indexterm>
     250
     251      <indexterm zone="samba3 samba3-swat-config">
     252        <primary sortas="e-etc-inetd.conf">/etc/inetd.conf</primary>
     253      </indexterm>
     254
     255      <indexterm zone="samba3 samba3-swat-config">
     256        <primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary>
     257      </indexterm>
     258
     259      <para>Add swat and swat_tunnel entries to
     260      <filename>/etc/services</filename> with the following commands issued
     261      as the <systemitem class="username">root</systemitem> user:</para>
     262
     263<screen role="root"><userinput>echo "swat            901/tcp" &gt;&gt; /etc/services &amp;&amp;
     264echo "swat_tunnel     902/tcp" &gt;&gt; /etc/services</userinput></screen>
     265
     266      <para>If <command>inetd</command> is used, the following command will
     267      add the swat_tunnel entry to <filename>/etc/inetd.conf</filename> (as
     268      user <systemitem class="username">root</systemitem>):</para>
     269
     270<screen role="root"><userinput>echo "swat_tunnel stream tcp nowait.400 root /usr/sbin/swat swat" \
     271    &gt;&gt; /etc/inetd.conf</userinput></screen>
     272
     273      <para>Issue a <command>killall -HUP inetd</command> to reread the
     274      changed <filename>inetd.conf</filename> file.</para>
     275
     276      <para>If you use <command>xinetd</command>, the following command will
     277      create the <application>Samba</application> file as
     278      <filename>/etc/xinetd.d/swat_tunnel</filename> (you may need to modify
     279      or remove the <quote>only_from</quote> line to include the desired
     280      host[s]):</para>
     281
     282<screen role="root"><userinput>cat &gt;&gt; /etc/xinetd.d/swat_tunnel &lt;&lt; "EOF"
     283<literal># Begin /etc/xinetd.d/swat_tunnel
    268284
    269285service swat_tunnel
    … …  
    278294}
    279295
    280 # End /etc/xinetd.d/swat_tunnel
    281 <command>EOF</command></userinput></screen>
    282 
    283 <indexterm zone="samba3 samba3-swat-config">
    284   <primary sortas="e-etc-xinetd.d-swat-tunnel">/etc/xinetd.d/swat_tunnel</primary>
    285 </indexterm>
    286 
    287 <para>Issue a <command>killall -HUP xinetd</command> to reread the
    288 changed <filename>xinetd.conf</filename> file.</para>
    289 
    290 <para>Next, you must add an entry for the swat service to the
    291 <filename>/etc/stunnel/stunnel.conf</filename> file (as user root):</para>
    292 
    293 <indexterm zone="samba3 samba3-swat-config">
    294   <primary sortas="e-etc-stunnel-stunnel.conf">/etc/stunnel/stunnel.conf</primary>
    295 </indexterm>
    296 
    297 <screen><userinput role='root'><command>cat &gt;&gt; /etc/stunnel/stunnel.conf &lt;&lt; "EOF"</command>
    298 [swat]
     296# End /etc/xinetd.d/swat_tunnel</literal>
     297EOF</userinput></screen>
     298
     299      <indexterm zone="samba3 samba3-swat-config">
     300        <primary sortas="e-etc-xinetd.d-swat-tunnel">/etc/xinetd.d/swat_tunnel</primary>
     301      </indexterm>
     302
     303      <para>Issue a <command>killall -HUP xinetd</command> to reread the
     304      changed <filename>xinetd.conf</filename> file.</para>
     305
     306      <para>Next, you must add an entry for the swat service to the
     307      <filename>/etc/stunnel/stunnel.conf</filename> file (as user
     308      <systemitem class="username">root</systemitem>):</para>
     309
     310      <indexterm zone="samba3 samba3-swat-config">
     311        <primary sortas="e-etc-stunnel-stunnel.conf">/etc/stunnel/stunnel.conf</primary>
     312      </indexterm>
     313
     314<screen role="root"><userinput>cat &gt;&gt; /etc/stunnel/stunnel.conf &lt;&lt; "EOF"
     315<literal>[swat]
    299316accept  = 901
    300 connect = 902
    301 
    302 <command>EOF</command></userinput></screen>
    303 
    304 <para>Restart the <command>stunnel</command> daemon using the following
    305 command as the root user:</para>
    306 
    307 <screen><userinput role='root'><command>/etc/rc.d/init.d/stunnel restart</command></userinput></screen>
    308 
    309 <para><acronym>SWAT</acronym> can be launched by pointing your web browser to
    310 <userinput>https://<replaceable>[CA_DN_field]</replaceable>:901</userinput>.
    311 Substitute the hostname listed in the <acronym>DN</acronym> field of the
    312 <acronym>CA</acronym> certificate used with
    313 <application>Stunnel</application> for
    314 <replaceable>[CA_DN_field]</replaceable>.</para>
    315 
    316 <note><para>If you linked
    317 <application>Linux-<acronym>PAM</acronym></application> into the
    318 <application>Samba</application> build, you'll need to create an
    319 <filename>/etc/pam.d/samba</filename> file.</para></note>
    320 
    321 <indexterm zone="samba3 samba3-swat-config">
    322   <primary sortas="e-etc-pam.d-samba">/etc/pam.d/samba</primary>
    323 </indexterm>
    324 
    325 </sect3>
    326 
    327 <sect3><title>Printing to <acronym>SMB</acronym> clients</title>
    328 
    329 <para>If you use <application><acronym>CUPS</acronym></application> for print
    330 services, and you wish to print to a printer attached to an
    331 <acronym>SMB</acronym> client, you need to create an <acronym>SMB</acronym>
    332 backend device. To create the device, issue the following command as the
    333 root user:</para>
    334 
    335 <screen><userinput><command>ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</command></userinput></screen>
    336 </sect3>
    337 
    338 <sect3 id="samba3-init"><title>Installing bootscripts</title>
    339 
    340 <para>For your convenience, boot scripts have been provided for
    341 <application>Samba</application>.  There are two included in the
    342 <xref linkend="intro-important-bootscripts"/> package.  The first,
    343 <filename>samba</filename>, will start the <command>smbd</command> and
    344 <command>nmbd</command> daemons needed to provide
    345 <acronym>SMB</acronym>/<acronym>CIFS</acronym> services.  The second
    346 script, <filename>winbind</filename>, starts the <command>winbindd</command>
    347 daemon, used for providing Windows domain services to Linux clients.</para>
    348 
    349 <indexterm zone="samba3 samba3-init">
    350   <primary sortas="f-samba">samba</primary>
    351 </indexterm>
    352 
    353 <indexterm zone="samba3 samba3-init">
    354   <primary sortas="f-winbind">winbind</primary>
    355 </indexterm>
    356 
    357 <para>Install the <filename>samba</filename> script with the following
    358 command issued as the root user:</para>
    359 
    360 <screen><userinput role='root'><command>make install-samba</command></userinput></screen>
    361 
    362 <para>If you also need the <filename>winbind</filename> script:</para>
    363 
    364 <screen><userinput role='root'><command>make install-winbind</command></userinput></screen>
    365 </sect3>
    366 
    367 </sect2>
    368 
    369 <sect2>
    370 <title>Contents</title>
    371 
    372 <segmentedlist>
    373 <segtitle>Installed Programs</segtitle>
    374 <segtitle>Installed Libraries</segtitle>
    375 <segtitle>Installed Directories</segtitle>
    376 
    377 <seglistitem>
    378 <seg>findsmb, mount.smbfs, net, nmbd, nmblookup, ntlm_auth, pdbedit, profiles,
    379 rpcclient, smbcacls, smbclient, smbcontrol, smbcquotas, smbd, smbmnt,
    380 smbmount, smbpasswd, smbspool, smbstatus, smbtar, smbtree, smbumount, swat,
    381 tdbbackup, tdbdump, tdbtool, testparm, testprns, wbinfo and winbindd</seg>
    382 <seg>libnss_winbind.so, libnss_wins.so, libsmbclient.so, the
    383 pam_winbind.so <acronym>PAM</acronym> library and assorted character set,
    384 filesystem and support modules.</seg>
    385 <seg>/etc/samba, /usr/lib/samba, /usr/share/samba, /var/cache/samba and
    386 /var/lib/samba</seg>
    387 </seglistitem>
    388 </segmentedlist>
    389 
    390 <variablelist>
    391 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    392 <?dbfo list-presentation="list"?>
    393 
    394 <varlistentry id="findsmb">
    395 <term><command>findsmb</command></term>
    396 <listitem><para>lists information about machines that respond to
    397 <acronym>SMB</acronym> name queries on a subnet.</para>
    398 <indexterm zone="samba3 findsmb">
    399 <primary sortas="b-findsmb">findsmb</primary>
    400 </indexterm></listitem>
    401 </varlistentry>
    402 
    403 <varlistentry id="mount.smbfs">
    404 <term><command>mount.smbfs</command></term>
    405 <listitem><para>is a symlink to <command>mountsmb</command> which provides
    406 <command>/bin/mount</command> with a way to mount remote Windows (or
    407 <application>Samba</application>) fileshares.</para>
    408 <indexterm zone="samba3 mount.smbfs">
    409 <primary sortas="b-mount.smbfs">mount.smbfs</primary>
    410 </indexterm></listitem>
    411 </varlistentry>
    412 
    413 <varlistentry id="net">
    414 <term><command>net</command></term>
    415 <listitem><para>is a tool for administration of
    416 <application>Samba</application> and remote <acronym>CIFS</acronym> servers,
    417 similar to the <command>net</command> utility for
    418 <acronym>DOS</acronym>/Windows.</para>
    419 <indexterm zone="samba3 net">
    420 <primary sortas="b-net">net</primary>
    421 </indexterm></listitem>
    422 </varlistentry>
    423 
    424 <varlistentry id="nmbd">
    425 <term><command>nmbd</command></term>
    426 <listitem><para>is the <application>Samba</application>
    427 Net<acronym>BIOS</acronym> name server.</para>
    428 <indexterm zone="samba3 nmbd">
    429 <primary sortas="b-nmbd">nmbd</primary>
    430 </indexterm></listitem>
    431 </varlistentry>
    432 
    433 <varlistentry id="nmblookup">
    434 <term><command>nmblookup</command></term>
    435 <listitem><para>is used to query Net<acronym>BIOS</acronym> names and map
    436 them to <acronym>IP</acronym> addresses.</para>
    437 <indexterm zone="samba3 nmblookup">
    438 <primary sortas="b-nmblookup">nmblookup</primary>
    439 </indexterm></listitem>
    440 </varlistentry>
    441 
    442 <varlistentry id="ntlm_auth">
    443 <term><command>ntlm_auth</command></term>
    444 <listitem><para>is a tool to allow external access to Winbind's
    445 <acronym>NTLM</acronym> authentication function.</para>
    446 <indexterm zone="samba3 ntlm_auth">
    447 <primary sortas="b-ntlm_auth">ntlm_auth</primary>
    448 </indexterm></listitem>
    449 </varlistentry>
    450 
    451 <varlistentry id="pdbedit">
    452 <term><command>pdbedit</command></term>
    453 <listitem><para>is a tool used to manage the <acronym>SAM</acronym>
    454 database.</para>
    455 <indexterm zone="samba3 pdbedit">
    456 <primary sortas="b-pdbedit">pdbedit</primary>
    457 </indexterm></listitem>
    458 </varlistentry>
    459 
    460 <varlistentry id="profiles">
    461 <term><command>profiles</command></term>
    462 <listitem><para>is a utility that reports and changes <acronym>SID</acronym>s
    463 in Windows registry files. It currently only supports Windows NT.</para>
    464 <indexterm zone="samba3 profiles">
    465 <primary sortas="b-profiles">profiles</primary>
    466 </indexterm></listitem>
    467 </varlistentry>
    468 
    469 <varlistentry id="rpcclient">
    470 <term><command>rpcclient</command></term>
    471 <listitem><para>is used to execute MS-<acronym>RPC</acronym> client side
    472 functions.</para>
    473 <indexterm zone="samba3 rpcclient">
    474 <primary sortas="b-rpcclient">rpcclient</primary>
    475 </indexterm></listitem>
    476 </varlistentry>
    477 
    478 <varlistentry id="smbcacls">
    479 <term><command>smbcacls</command></term>
    480 <listitem><para>is used to manipulate Windows NT access control lists.</para>
    481 <indexterm zone="samba3 smbcacls">
    482 <primary sortas="b-smbcacls">smbcacls</primary>
    483 </indexterm></listitem>
    484 </varlistentry>
    485 
    486 <varlistentry id="smbclient">
    487 <term><command>smbclient</command></term>
    488 <listitem><para>is a <acronym>SMB</acronym>/<acronym>CIFS</acronym> access
    489 utility, similar to <acronym>FTP</acronym>.</para>
    490 <indexterm zone="samba3 smbclient">
    491 <primary sortas="b-smbclient">smbclient</primary>
    492 </indexterm></listitem>
    493 </varlistentry>
    494 
    495 <varlistentry id="smbcontrol">
    496 <term><command>smbcontrol</command></term>
    497 <listitem><para>is used to control running <command>smbd</command>,
    498 <command>nmbd</command> and <command>winbindd</command> daemons.</para>
    499 <indexterm zone="samba3 smbcontrol">
    500 <primary sortas="b-smbcontrol">smbcontrol</primary>
    501 </indexterm></listitem>
    502 </varlistentry>
    503 
    504 <varlistentry id="smbcquotas">
    505 <term><command>smbcquotas</command></term>
    506 <listitem><para>is used to manipulate Windows NT quotas on
    507 <acronym>SMB</acronym> file shares.</para>
    508 <indexterm zone="samba3 smbcquotas">
    509 <primary sortas="b-smbcquotas">smbcquotas</primary>
    510 </indexterm></listitem>
    511 </varlistentry>
    512 
    513 <varlistentry id="smbd">
    514 <term><command>smbd</command></term>
    515 <listitem><para>is the main <application>Samba</application> daemon which
    516 provides <acronym>SMB</acronym>/<acronym>CIFS</acronym> services to
    517 clients.</para>
    518 <indexterm zone="samba3 smbd">
    519 <primary sortas="b-smbd">smbd</primary>
    520 </indexterm></listitem>
    521 </varlistentry>
    522 
    523 <varlistentry id="smbmnt">
    524 <term><command>smbmnt</command></term>
    525 <listitem><para>is a helper application used by the
    526 <command>smbmount</command> program to do the actual mounting of
    527 <acronym>SMB</acronym> shares. It can be installed setuid root if you want
    528 normal users to be able to mount their <acronym>SMB</acronym> shares.</para>
    529 <indexterm zone="samba3 smbmnt">
    530 <primary sortas="b-smbmnt">smbmnt</primary>
    531 </indexterm></listitem>
    532 </varlistentry>
    533 
    534 <varlistentry id="smbmount">
    535 <term><command>smbmount</command></term>
    536 <listitem><para>is usually invoked as <command>mount.smbfs</command> by the
    537 <command>mount</command> command when using the
    538 <parameter>-t smbfs</parameter> option, mounts a Linux <acronym>SMB</acronym>
    539 filesystem.</para>
    540 <indexterm zone="samba3 smbmount">
    541 <primary sortas="b-smbmount">smbmount</primary>
    542 </indexterm></listitem>
    543 </varlistentry>
    544 
    545 <varlistentry id="smbpasswd">
    546 <term><command>smbpasswd</command></term>
    547 <listitem><para>changes a user's <application>Samba</application>
    548 password.</para>
    549 <indexterm zone="samba3 smbpasswd">
    550 <primary sortas="b-smbpasswd">smbpasswd</primary>
    551 </indexterm></listitem>
    552 </varlistentry>
    553 
    554 <varlistentry id="smbspool">
    555 <term><command>smbspool</command></term>
    556 <listitem><para>sends a print job to an <acronym>SMB</acronym> printer.</para>
    557 <indexterm zone="samba3 smbspool">
    558 <primary sortas="b-smbspool">smbspool</primary>
    559 </indexterm></listitem>
    560 </varlistentry>
    561 
    562 <varlistentry id="smbstatus">
    563 <term><command>smbstatus</command></term>
    564 <listitem><para>reports current <application>Samba</application>
    565 connections.</para>
    566 <indexterm zone="samba3 smbstatus">
    567 <primary sortas="b-smbstatus">smbstatus</primary>
    568 </indexterm></listitem>
    569 </varlistentry>
    570 
    571 <varlistentry id="smbtar">
    572 <term><command>smbtar</command></term>
    573 <listitem><para>is a shell script used for backing up
    574 <acronym>SMB</acronym>/<acronym>CIFS</acronym> shares directly to Linux tape
    575 drives or a file.</para>
    576 <indexterm zone="samba3 smbtar">
    577 <primary sortas="b-smbtar">smbtar</primary>
    578 </indexterm></listitem>
    579 </varlistentry>
    580 
    581 <varlistentry id="smbtree">
    582 <term><command>smbtree</command></term>
    583 <listitem><para>is a text-based <acronym>SMB</acronym> network browser.</para>
    584 <indexterm zone="samba3 smbtree">
    585 <primary sortas="b-smbtree">smbtree</primary>
    586 </indexterm></listitem>
    587 </varlistentry>
    588 
    589 <varlistentry id="smbumount">
    590 <term><command>smbumount</command></term>
    591 <listitem><para>is used by normal users to unmount <acronym>SMB</acronym>
    592 filesystems, provided that it is setuid root.</para>
    593 <indexterm zone="samba3 smbumount">
    594 <primary sortas="b-smbumount">smbumount</primary>
    595 </indexterm></listitem>
    596 </varlistentry>
    597 
    598 <varlistentry id="swat">
    599 <term><command>swat</command></term>
    600 <listitem><para>is the <application>Samba</application> Web Administration
    601 Tool.</para>
    602 <indexterm zone="samba3 swat">
    603 <primary sortas="b-swat">swat</primary>
    604 </indexterm></listitem>
    605 </varlistentry>
    606 
    607 <varlistentry id="tdbbackup">
    608 <term><command>tdbbackup</command></term>
    609 <listitem><para>is a tool for backing up or validating the integrity of
    610 <application>Samba</application> <filename>.tdb</filename> files.</para>
    611 <indexterm zone="samba3 tdbbackup">
    612 <primary sortas="b-tdbbackup">tdbbackup</primary>
    613 </indexterm></listitem>
    614 </varlistentry>
    615 
    616 <varlistentry id="tdbdump">
    617 <term><command>tdbdump</command></term>
    618 <listitem><para> is a tool used to print the contents of a
    619 <application>Samba</application> <filename>.tdb</filename> file.</para>
    620 <indexterm zone="samba3 tdbdump">
    621 <primary sortas="b-tdbdump">tdbdump</primary>
    622 </indexterm></listitem>
    623 </varlistentry>
    624 
    625 <varlistentry id="tdbtool">
    626 <term><command>tdbtool</command></term>
    627 <listitem><para>is a tool which allows simple database manipulation from the
    628 command line.</para>
    629 <indexterm zone="samba3 tdbtool">
    630 <primary sortas="b-tdbtool">tdbtool</primary>
    631 </indexterm></listitem>
    632 </varlistentry>
    633 
    634 <varlistentry id="testparm">
    635 <term><command>testparm</command></term>
    636 <listitem><para>checks an <filename>smb.conf</filename> file for proper
    637 syntax.</para>
    638 <indexterm zone="samba3 testparm">
    639 <primary sortas="b-testparm">testparm</primary>
    640 </indexterm></listitem>
    641 </varlistentry>
    642 
    643 <varlistentry id="testprns">
    644 <term><command>testprns</command></term>
    645 <listitem><para>tests printer names.</para>
    646 <indexterm zone="samba3 testprns">
    647 <primary sortas="b-testprns">testprns</primary>
    648 </indexterm></listitem>
    649 </varlistentry>
    650 
    651 <varlistentry id="wbinfo">
    652 <term><command>wbinfo</command></term>
    653 <listitem><para>queries a running <command>winbindd</command> daemon.</para>
    654 <indexterm zone="samba3 wbinfo">
    655 <primary sortas="b-wbinfo">wbinfo</primary>
    656 </indexterm></listitem>
    657 </varlistentry>
    658 
    659 <varlistentry id="winbindd">
    660 <term><command>winbindd</command></term>
    661 <listitem><para>resolves names from Windows NT servers.</para>
    662 <indexterm zone="samba3 winbindd">
    663 <primary sortas="b-winbindd">winbindd</primary>
    664 </indexterm></listitem>
    665 </varlistentry>
    666 </variablelist>
    667 
    668 </sect2>
     317connect = 902</literal>
     318
     319EOF</userinput></screen>
     320
     321      <para>Restart the <command>stunnel</command> daemon using the following
     322      command as the <systemitem class="username">root</systemitem> user:</para>
     323
     324<screen role="root"><userinput>/etc/rc.d/init.d/stunnel restart</userinput></screen>
     325
     326      <para>SWAT can be launched by pointing your web browser to
     327      <uri>https://<replaceable>[CA_DN_field]</replaceable>:901</uri>.
     328      Substitute the hostname listed in the DN field of the CA certificate
     329      used with <application>Stunnel</application> for
     330      <replaceable>[CA_DN_field]</replaceable>.</para>
     331
     332      <note>
     333        <para>If you linked <application>Linux-PAM</application> into the
     334        <application>Samba</application> build, you'll need to create an
     335        <filename>/etc/pam.d/samba</filename> file.</para>
     336      </note>
     337
     338      <indexterm zone="samba3 samba3-swat-config">
     339        <primary sortas="e-etc-pam.d-samba">/etc/pam.d/samba</primary>
     340      </indexterm>
     341
     342    </sect3>
     343
     344    <sect3>
     345      <title>Printing to SMB Clients</title>
     346
     347      <para>If you use <application>CUPS</application> for print services,
     348      and you wish to print to a printer attached to an SMB client, you
     349      need to create an SMB backend device. To create the device, issue the
     350      following command as the <systemitem class="username">root</systemitem>
     351      user:</para>
     352
     353<screen role="root"><userinput>ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
     354
     355    </sect3>
     356
     357    <sect3 id="samba3-init">
     358      <title>Boot Script</title>
     359
     360      <para>For your convenience, boot scripts have been provided for
     361      <application>Samba</application>. There are two included in the
     362      <xref linkend="intro-important-bootscripts"/> package. The first,
     363      <filename>samba</filename>, will start the <command>smbd</command>
     364      and <command>nmbd</command> daemons needed to provide SMB/CIFS
     365      services. The second script, <filename>winbind</filename>, starts
     366      the <command>winbindd</command> daemon, used for providing Windows
     367      domain services to Linux clients.</para>
     368
     369      <indexterm zone="samba3 samba3-init">
     370        <primary sortas="f-samba">samba</primary>
     371      </indexterm>
     372
     373      <indexterm zone="samba3 samba3-init">
     374        <primary sortas="f-winbind">winbind</primary>
     375      </indexterm>
     376
     377      <para>Install the <filename>samba</filename> script with the following
     378      command issued as the <systemitem class="username">root</systemitem>
     379      user:</para>
     380
     381<screen role="root"><userinput>make install-samba</userinput></screen>
     382
     383      <para>If you also need the <filename>winbind</filename>
     384      script:</para>
     385
     386<screen role="root"><userinput>make install-winbind</userinput></screen>
     387
     388    </sect3>
     389
     390  </sect2>
     391
     392  <sect2 role="content">
     393    <title>Contents</title>
     394
     395    <segmentedlist>
     396      <segtitle>Installed Programs</segtitle>
     397      <segtitle>Installed Libraries</segtitle>
     398      <segtitle>Installed Directories</segtitle>
     399
     400      <seglistitem>
     401        <seg>findsmb, mount.smbfs, net, nmbd, nmblookup, ntlm_auth, pdbedit,
     402        profiles, rpcclient, smbcacls, smbclient, smbcontrol, smbcquotas, smbd,
     403        smbmnt, smbmount, smbpasswd, smbspool, smbstatus, smbtar, smbtree,
     404        smbumount, swat, tdbbackup, tdbdump, tdbtool, testparm, testprns,
     405        wbinfo, and winbindd</seg>
     406        <seg>libnss_winbind.so, libnss_wins.so, libsmbclient.so, the
     407        pam_winbind.so PAM library and assorted character set,
     408        filesystem and support modules.</seg>
     409        <seg>/etc/samba, /usr/lib/samba, /usr/share/samba, /var/cache/samba,
     410        and /var/lib/samba</seg>
     411      </seglistitem>
     412    </segmentedlist>
     413
     414    <variablelist>
     415      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     416      <?dbfo list-presentation="list"?>
     417      <?dbhtml list-presentation="table"?>
     418
     419      <varlistentry id="findsmb">
     420        <term><command>findsmb</command></term>
     421        <listitem>
     422          <para>lists information about machines that respond to
     423          SMB name queries on a subnet.</para>
     424          <indexterm zone="samba3 findsmb">
     425            <primary sortas="b-findsmb">findsmb</primary>
     426          </indexterm>
     427        </listitem>
     428      </varlistentry>
     429
     430      <varlistentry id="mount.smbfs">
     431        <term><command>mount.smbfs</command></term>
     432        <listitem>
     433          <para>is a symlink to <command>mountsmb</command> which provides
     434          <command>/bin/mount</command> with a way to mount remote Windows
     435          (or <application>Samba</application>) fileshares.</para>
     436          <indexterm zone="samba3 mount.smbfs">
     437            <primary sortas="b-mount.smbfs">mount.smbfs</primary>
     438          </indexterm>
     439        </listitem>
     440      </varlistentry>
     441
     442      <varlistentry id="net">
     443        <term><command>net</command></term>
     444        <listitem>
     445          <para>is a tool for administration of
     446          <application>Samba</application> and remote CIFS servers, similar
     447          to the <command>net</command> utility for DOS/Windows.</para>
     448          <indexterm zone="samba3 net">
     449            <primary sortas="b-net">net</primary>
     450          </indexterm>
     451        </listitem>
     452      </varlistentry>
     453
     454      <varlistentry id="nmbd">
     455        <term><command>nmbd</command></term>
     456        <listitem>
     457          <para>is the <application>Samba</application>
     458          NetBIOS name server.</para>
     459          <indexterm zone="samba3 nmbd">
     460            <primary sortas="b-nmbd">nmbd</primary>
     461          </indexterm>
     462        </listitem>
     463      </varlistentry>
     464
     465      <varlistentry id="nmblookup">
     466        <term><command>nmblookup</command></term>
     467        <listitem>
     468          <para>is used to query NetBIOS names and map
     469          them to IP addresses.</para>
     470          <indexterm zone="samba3 nmblookup">
     471            <primary sortas="b-nmblookup">nmblookup</primary>
     472          </indexterm>
     473        </listitem>
     474      </varlistentry>
     475
     476      <varlistentry id="ntlm_auth">
     477        <term><command>ntlm_auth</command></term>
     478        <listitem>
     479          <para>is a tool to allow external access to Winbind's
     480          NTLM authentication function.</para>
     481          <indexterm zone="samba3 ntlm_auth">
     482            <primary sortas="b-ntlm_auth">ntlm_auth</primary>
     483          </indexterm>
     484        </listitem>
     485      </varlistentry>
     486
     487      <varlistentry id="pdbedit">
     488        <term><command>pdbedit</command></term>
     489        <listitem>
     490          <para>is a tool used to manage the SAM database.</para>
     491          <indexterm zone="samba3 pdbedit">
     492            <primary sortas="b-pdbedit">pdbedit</primary>
     493          </indexterm>
     494        </listitem>
     495      </varlistentry>
     496
     497      <varlistentry id="profiles">
     498        <term><command>profiles</command></term>
     499        <listitem>
     500          <para>is a utility that reports and changes SIDs in Windows
     501          registry files. It currently only supports Windows NT.</para>
     502          <indexterm zone="samba3 profiles">
     503            <primary sortas="b-profiles">profiles</primary>
     504          </indexterm>
     505        </listitem>
     506      </varlistentry>
     507
     508      <varlistentry id="rpcclient">
     509        <term><command>rpcclient</command></term>
     510        <listitem>
     511          <para>is used to execute MS-RPC client side functions.</para>
     512          <indexterm zone="samba3 rpcclient">
     513            <primary sortas="b-rpcclient">rpcclient</primary>
     514          </indexterm>
     515        </listitem>
     516      </varlistentry>
     517
     518      <varlistentry id="smbcacls">
     519        <term><command>smbcacls</command></term>
     520        <listitem>
     521          <para>is used to manipulate Windows NT access control lists.</para>
     522          <indexterm zone="samba3 smbcacls">
     523            <primary sortas="b-smbcacls">smbcacls</primary>
     524          </indexterm>
     525        </listitem>
     526      </varlistentry>
     527
     528      <varlistentry id="smbclient">
     529        <term><command>smbclient</command></term>
     530        <listitem>
     531          <para>is a SMB/CIFS access utility, similar to FTP.</para>
     532          <indexterm zone="samba3 smbclient">
     533            <primary sortas="b-smbclient">smbclient</primary>
     534          </indexterm>
     535        </listitem>
     536      </varlistentry>
     537
     538      <varlistentry id="smbcontrol">
     539        <term><command>smbcontrol</command></term>
     540        <listitem>
     541          <para>is used to control running <command>smbd</command>,
     542          <command>nmbd</command> and <command>winbindd</command>
     543          daemons.</para>
     544          <indexterm zone="samba3 smbcontrol">
     545            <primary sortas="b-smbcontrol">smbcontrol</primary>
     546          </indexterm>
     547        </listitem>
     548      </varlistentry>
     549
     550      <varlistentry id="smbcquotas">
     551        <term><command>smbcquotas</command></term>
     552        <listitem>
     553          <para>is used to manipulate Windows NT quotas on
     554          SMB file shares.</para>
     555          <indexterm zone="samba3 smbcquotas">
     556            <primary sortas="b-smbcquotas">smbcquotas</primary>
     557          </indexterm>
     558        </listitem>
     559      </varlistentry>
     560
     561      <varlistentry id="smbd">
     562        <term><command>smbd</command></term>
     563        <listitem>
     564          <para>is the main <application>Samba</application> daemon which
     565          provides SMB/CIFS services to clients.</para>
     566          <indexterm zone="samba3 smbd">
     567            <primary sortas="b-smbd">smbd</primary>
     568          </indexterm>
     569        </listitem>
     570      </varlistentry>
     571
     572      <varlistentry id="smbmnt">
     573        <term><command>smbmnt</command></term>
     574        <listitem>
     575          <para>is a helper application used by the
     576          <command>smbmount</command> program to do the actual mounting of
     577          SMB shares. It can be installed setuid root if you want
     578          normal users to be able to mount their SMB shares.</para>
     579          <indexterm zone="samba3 smbmnt">
     580            <primary sortas="b-smbmnt">smbmnt</primary>
     581          </indexterm>
     582        </listitem>
     583      </varlistentry>
     584
     585      <varlistentry id="smbmount">
     586        <term><command>smbmount</command></term>
     587        <listitem>
     588          <para>is usually invoked as <command>mount.smbfs</command> by the
     589          <command>mount</command> command when using the
     590          <parameter>-t smbfs</parameter> option, mounts a Linux SMB
     591          filesystem.</para>
     592          <indexterm zone="samba3 smbmount">
     593            <primary sortas="b-smbmount">smbmount</primary>
     594          </indexterm>
     595        </listitem>
     596      </varlistentry>
     597
     598      <varlistentry id="smbpasswd">
     599        <term><command>smbpasswd</command></term>
     600        <listitem>
     601          <para>changes a user's <application>Samba</application>
     602          password.</para>
     603          <indexterm zone="samba3 smbpasswd">
     604            <primary sortas="b-smbpasswd">smbpasswd</primary>
     605          </indexterm>
     606        </listitem>
     607      </varlistentry>
     608
     609      <varlistentry id="smbspool">
     610        <term><command>smbspool</command></term>
     611        <listitem>
     612          <para>sends a print job to an SMB printer.</para>
     613          <indexterm zone="samba3 smbspool">
     614            <primary sortas="b-smbspool">smbspool</primary>
     615          </indexterm>
     616        </listitem>
     617      </varlistentry>
     618
     619      <varlistentry id="smbstatus">
     620        <term><command>smbstatus</command></term>
     621        <listitem>
     622          <para>reports current <application>Samba</application>
     623          connections.</para>
     624          <indexterm zone="samba3 smbstatus">
     625            <primary sortas="b-smbstatus">smbstatus</primary>
     626          </indexterm>
     627        </listitem>
     628      </varlistentry>
     629
     630      <varlistentry id="smbtar">
     631        <term><command>smbtar</command></term>
     632        <listitem>
     633          <para>is a shell script used for backing up SMB/CIFS shares
     634          directly to Linux tape drives or a file.</para>
     635          <indexterm zone="samba3 smbtar">
     636            <primary sortas="b-smbtar">smbtar</primary>
     637          </indexterm>
     638        </listitem>
     639      </varlistentry>
     640
     641      <varlistentry id="smbtree">
     642        <term><command>smbtree</command></term>
     643        <listitem>
     644          <para>is a text-based SMB network browser.</para>
     645          <indexterm zone="samba3 smbtree">
     646            <primary sortas="b-smbtree">smbtree</primary>
     647          </indexterm>
     648        </listitem>
     649      </varlistentry>
     650
     651      <varlistentry id="smbumount">
     652        <term><command>smbumount</command></term>
     653        <listitem>
     654          <para>is used by normal users to unmount SMB filesystems,
     655          provided that it is setuid root.</para>
     656          <indexterm zone="samba3 smbumount">
     657            <primary sortas="b-smbumount">smbumount</primary>
     658          </indexterm>
     659        </listitem>
     660      </varlistentry>
     661
     662      <varlistentry id="swat">
     663        <term><command>swat</command></term>
     664        <listitem>
     665          <para>is the <application>Samba</application> Web Administration
     666          Tool.</para>
     667          <indexterm zone="samba3 swat">
     668            <primary sortas="b-swat">swat</primary>
     669          </indexterm>
     670        </listitem>
     671      </varlistentry>
     672
     673      <varlistentry id="tdbbackup">
     674        <term><command>tdbbackup</command></term>
     675        <listitem>
     676          <para>is a tool for backing up or validating the integrity of
     677          <application>Samba</application> <filename>.tdb</filename>
     678          files.</para>
     679          <indexterm zone="samba3 tdbbackup">
     680            <primary sortas="b-tdbbackup">tdbbackup</primary>
     681          </indexterm>
     682        </listitem>
     683      </varlistentry>
     684
     685      <varlistentry id="tdbdump">
     686        <term><command>tdbdump</command></term>
     687        <listitem>
     688          <para> is a tool used to print the contents of a
     689          <application>Samba</application> <filename>.tdb</filename>
     690          file.</para>
     691          <indexterm zone="samba3 tdbdump">
     692            <primary sortas="b-tdbdump">tdbdump</primary>
     693          </indexterm>
     694        </listitem>
     695      </varlistentry>
     696
     697      <varlistentry id="tdbtool">
     698        <term><command>tdbtool</command></term>
     699        <listitem>
     700          <para>is a tool which allows simple database manipulation from the
     701          command line.</para>
     702          <indexterm zone="samba3 tdbtool">
     703            <primary sortas="b-tdbtool">tdbtool</primary>
     704          </indexterm>
     705        </listitem>
     706      </varlistentry>
     707
     708      <varlistentry id="testparm">
     709        <term><command>testparm</command></term>
     710        <listitem>
     711          <para>checks an <filename>smb.conf</filename> file for proper
     712          syntax.</para>
     713          <indexterm zone="samba3 testparm">
     714            <primary sortas="b-testparm">testparm</primary>
     715          </indexterm>
     716        </listitem>
     717      </varlistentry>
     718
     719      <varlistentry id="testprns">
     720        <term><command>testprns</command></term>
     721        <listitem>
     722          <para>tests printer names.</para>
     723          <indexterm zone="samba3 testprns">
     724            <primary sortas="b-testprns">testprns</primary>
     725          </indexterm>
     726        </listitem>
     727      </varlistentry>
     728
     729      <varlistentry id="wbinfo">
     730        <term><command>wbinfo</command></term>
     731        <listitem>
     732          <para>queries a running <command>winbindd</command> daemon.</para>
     733          <indexterm zone="samba3 wbinfo">
     734            <primary sortas="b-wbinfo">wbinfo</primary>
     735          </indexterm>
     736        </listitem>
     737      </varlistentry>
     738
     739      <varlistentry id="winbindd">
     740        <term><command>winbindd</command></term>
     741        <listitem>
     742          <para>resolves names from Windows NT servers.</para>
     743          <indexterm zone="samba3 winbindd">
     744            <primary sortas="b-winbindd">winbindd</primary>
     745          </indexterm>
     746        </listitem>
     747      </varlistentry>
     748
     749    </variablelist>
     750
     751  </sect2>
    669752
    670753</sect1>
    671 
Note: See TracChangeset for help on using the changeset viewer.