source: networking/netprogs/samba.xml@ 6e2729c

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
Last change on this file since 6e2729c was 6e2729c, checked in by Douglas R. Reno <renodr@…>, 3 years ago

Update to samba-4.14.0
Update to mercurial-5.7.1
Update to git-2.30.2
Update to Thunderbird-78.8.1
Update to iso-codes-4.6.0

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

  • Property mode set to 100644
File size: 53.9 KB
RevLine 
[0931098]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[0931098]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[8dfc5c3]7 <!ENTITY samba-download-http "https://www.samba.org/ftp/samba/stable/samba-&samba-version;.tar.gz">
[1c73261]8 <!ENTITY samba-download-ftp " ">
[6e2729c]9 <!ENTITY samba-md5sum "b1001900f542116e509b514e7e639875">
[c8635a0]10 <!ENTITY samba-size "18 MB">
[6e2729c]11 <!ENTITY samba-buildsize "620 MB (add 380 MB for quicktest)">
12 <!ENTITY samba-time "3.1 SBU (using parallelism=4; add 4.7 SBU for quicktest)">
[0931098]13]>
14
[45f56ac]15<sect1 id="samba" xreflabel="Samba-&samba-version;">
16 <?dbhtml filename="samba.html"?>
[99ef1fc]17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
[45f56ac]23 <title>Samba-&samba-version;</title>
[99ef1fc]24
[45f56ac]25 <indexterm zone="samba">
[99ef1fc]26 <primary sortas="a-Samba">Samba</primary>
27 </indexterm>
28
[4e82a189]29 <sect2 role="package">
[99ef1fc]30 <title>Introduction to Samba</title>
31
[b51fe6e]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>
[99ef1fc]40
[a4c3c48]41 &lfs101_checked;
[ee792ef]42
[99ef1fc]43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
[b51fe6e]46 <para>
47 Download (HTTP): <ulink url="&samba-download-http;"/>
48 </para>
[99ef1fc]49 </listitem>
50 <listitem>
[b51fe6e]51 <para>
52 Download (FTP): <ulink url="&samba-download-ftp;"/>
53 </para>
[99ef1fc]54 </listitem>
55 <listitem>
[b51fe6e]56 <para>
57 Download MD5 sum: &samba-md5sum;
58 </para>
[99ef1fc]59 </listitem>
60 <listitem>
[b51fe6e]61 <para>
62 Download size: &samba-size;
63 </para>
[99ef1fc]64 </listitem>
65 <listitem>
[b51fe6e]66 <para>
67 Estimated disk space required: &samba-buildsize;
68 </para>
[99ef1fc]69 </listitem>
70 <listitem>
[b51fe6e]71 <para>
72 Estimated build time: &samba-time;
73 </para>
[99ef1fc]74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">Samba Dependencies</bridgehead>
78
[e85edcc]79 <bridgehead renderas="sect4">Required</bridgehead>
[7cae14c]80 <para role="required">
[bfa397b]81 <xref linkend="gnutls"/>,
[7d25056d]82 <xref linkend="jansson"/>,
[51f8de3]83 <xref linkend="libtirpc"/>,
[6b705bd]84 <xref linkend="lmdb"/>, and
85 <!--<xref linkend="python3"/>, and-->
[51f8de3]86 <xref linkend="rpcsvc-proto"/>
[7cae14c]87 </para>
[e85edcc]88
[6e08e9c0]89 <bridgehead renderas="sect4">Recommended</bridgehead>
[e242b9a]90 <para role="recommended">
[d514a90]91 <phrase revision="sysv"><xref linkend="dbus"/> (for vfs_snapper, which is
92 useful on systems that support Volume Shadow Copies on Windows),</phrase>
[d38746e]93 <xref linkend="fuse3"/>,
[60d4af1]94 <xref linkend="gpgme"/>,
[c8635a0]95 <xref linkend="icu"/>,
[2f81d97a]96 <xref linkend="libxslt"/> (for documentation),
[195b246]97 <xref linkend="linux-pam"/>,
[4392a40]98 <xref linkend="perl-parse-yapp"/>,
[ceafde50]99 <xref linkend="pycryptodome"/>, and
[94b42903]100 <xref linkend="openldap"/>
[6e08e9c0]101 </para>
102
[99ef1fc]103 <bridgehead renderas="sect4">Optional</bridgehead>
[7cae14c]104 <para role="optional">
[5f1ca9f]105 <xref linkend="avahi"/>,
[8c602db7]106 <xref linkend="bind"/>,
[7cae14c]107 <xref linkend="cups"/>,
[3fdc9b0]108 <xref linkend="cyrus-sasl"/>,
109 <xref linkend="gdb"/>,
110 <xref linkend="git"/>,
[f89b587]111 <xref linkend="gnupg2"/> (required for ADS and testsuite),
[d38746e]112 <xref linkend="libaio"/>,
[defca61]113 <xref linkend="libarchive"/>,
[5f1ca9f]114 <xref linkend="libcap-pam"/>,
[3fdc9b0]115 <xref linkend="libgcrypt"/>,
[3310eeb1]116 <xref linkend="libnsl"/>,
[5ca14bdd]117 <xref linkend="mitkrb"/>,
[3fdc9b0]118 <xref linkend="nss"/>,
[5f1ca9f]119 <xref linkend="popt"/>,
[e5f33088]120 <xref linkend="talloc"/> (included),
[3fdc9b0]121 <xref linkend="vala"/>,
[5f1ca9f]122 <xref linkend="valgrind"/> (optionally used by the test suite),
[6f3f40f3]123 <!--<xref linkend="wireshark"/> (module installed),-->
[7cae14c]124 <xref linkend="xfsprogs"/>,
[e650cfe9]125 <ulink url="https://cmocka.org/">cmocka</ulink>,
[6e2729c]126 <ulink url="https://cryptography.io/en/latest/">cryptography</ulink>,
[e5f33088]127 <ulink url="https://ctdb.samba.org/">ctdb</ulink> (included),
[8c602db7]128 <ulink url="https://cwrap.org/">cwrap</ulink>,
129 <ulink url="&pypi;/dnspython/">dnspython</ulink>,
[c7b1dcc]130 <ulink url="https://packages.debian.org/stretch/fam">FAM</ulink>,
[5f1ca9f]131 <ulink url="https://people.gnome.org/~veillard/gamin/">Gamin</ulink>,
[0f5f10b]132 <ulink url="https://www.gluster.org/">GlusterFS</ulink>,
[a5f7042]133 <ulink url="https://github.com/heimdal/">Heimdal</ulink> (included),
[6e2729c]134 <ulink url="https://pypi.org/project/iso8601/">iso8601</ulink>,
[7cae14c]135 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>,
[f89b587]136 <ulink url="https://ldb.samba.org/">ldb</ulink> (included),
[e5f33088]137 <ulink url="&pypi;/m2crypto">M2Crypto</ulink> (required for ADS),
[defca61]138 <ulink url="http://www.openafs.org/">OpenAFS</ulink>,
[6e2729c]139 <ulink url="https://pypi.org/project/pyasn1/">pyasn1</ulink>,
[e5f33088]140 <ulink url="&pypi;/pygpgme/">PyGPGME</ulink> (recommended for ADS),
141 <ulink url="https://tevent.samba.org/">tevent</ulink> (included), and
142 <ulink url="https://tdb.samba.org/">tdb</ulink> (included)
[f1607a4]143 </para>
[6dcdcde]144
[e5f33088]145 <bridgehead renderas="sect4">Optional (for the Developer Test Suite)</bridgehead>
[b51fe6e]146 <para role="optional">
147 Install in listed order:
148 <xref linkend="six"/>,
149 <ulink url="&pypi;/argparse/">argparse</ulink>,
150 <ulink url="&pypi;/extras/">extras</ulink>,
151 <ulink url="&pypi;/py/">py</ulink>,
152 <ulink url="&pypi;/enum34/">enum34</ulink>,
153 <ulink url="&pypi;/hypothesis/">hypothesis</ulink>,
154 <ulink url="&pypi;/pytest/">pytest</ulink>,
155 <ulink url="&pypi;/coverage/">coverage</ulink>,
156 <ulink url="&pypi;/pytest-cov/">pytest-cov</ulink>,
157 <ulink url="&pypi;/doctools/">doctools</ulink>,
158 <ulink url="&pypi;/unittest2/">unittest2</ulink>,
159 <ulink url="&pypi;/testtools/">testtools</ulink>,
160 <ulink url="&pypi;/fixtures/">fixtures</ulink>,
161 <ulink url="&pypi;/python-mimeparse/">python-mimeparse</ulink>,
162 <ulink url="&pypi;/contextlib2/">contextlib2</ulink>,
163 <ulink url="&pypi;/traceback2/">traceback2</ulink>,
164 <ulink url="&pypi;/linecache2/">linecache2</ulink>,
165 <ulink url="&pypi;/testscenarios/">testscenarios</ulink>,
166 <ulink url="&pypi;/testresources/">testresources</ulink>,
167 <ulink url="&pypi;/virtualenv/">virtualenv</ulink>,
168 <ulink url="&pypi;/pbr/">pbr</ulink>, and
169 <ulink url="&pypi;/python-subunit/">python-subunit</ulink>
170 </para>
[e5f33088]171
[3cb0c57]172 <para condition="html" role="usernotes">User Notes:
[216b521]173 <ulink url="&blfs-wiki;/samba4"/></para>
[3cb0c57]174
[99ef1fc]175 </sect2>
176
177 <sect2 role="installation">
178 <title>Installation of Samba</title>
[2ae8864]179
[6e2729c]180 <para>
181 If you wish to run the test suite, install some python modules first:
182 </para>
183
184<screen role="root"><userinput remap="pre">pip3 install cryptography pyasn1 iso8601</userinput></screen>
185
[e1dfbee4]186 <para>
[b51fe6e]187 Fix a test that always fails:
188 </para>
[a6e9ec1]189
190<screen><userinput>echo "^samba4.rpc.echo.*on.*ncacn_np.*with.*object.*nt4_dc" >> selftest/knownfail</userinput></screen>
191
[b51fe6e]192 <para>
193 Install <application>Samba</application> by running the following
194 commands:
195 </para>
[65dea1b]196
[f4302700]197<screen revision="sysv"><userinput>CPPFLAGS="-I/usr/include/tirpc" \
[51f8de3]198LDFLAGS="-ltirpc" \
[8c602db7]199./configure \
[dbcebcf]200 --prefix=/usr \
201 --sysconfdir=/etc \
202 --localstatedir=/var \
203 --with-piddir=/run/samba \
204 --with-pammodulesdir=/lib/security \
[5ca14bdd]205 --enable-fhs \
206 --without-ad-dc \
[e5f33088]207 --without-systemd \
208 --enable-selftest &amp;&amp;
[7cae14c]209make</userinput></screen>
[2ae8864]210
[f4302700]211<screen revision="systemd"><userinput>CPPFLAGS="-I/usr/include/tirpc" \
[51f8de3]212LDFLAGS="-ltirpc" \
[8c602db7]213./configure \
[7b478500]214 --prefix=/usr \
215 --sysconfdir=/etc \
216 --localstatedir=/var \
217 --with-piddir=/run/samba \
218 --with-pammodulesdir=/lib/security \
[e5f33088]219 --enable-fhs \
220 --without-ad-dc \
221 --enable-selftest &amp;&amp;
[7b478500]222make</userinput></screen>
223
[b51fe6e]224 <para>
225 To test the results, as the
226 <systemitem class="username">root</systemitem> user, issue:
227 <command>make quicktest</command>. The test suite will produce lines that
228 look like failures, but these are innocuous. The last few lines of output
229 should report <emphasis>"ALL OK"</emphasis> for a good test run. A summary
230 of any failures can be found in
[6f3f40f3]231 <filename class="directory">./st/summary</filename>. With Samba-4.12.0,
232 many tests are known to fail.
[b51fe6e]233 </para>
234
235 <!--
236 If doing a security update or a new minor version (point releases do not
237 apply here), run 'make testenv' before running 'make test' and 'make
238 subunit-test'. This will setup the test environment and make the tests
239 run faster, as well as point out any glaring issues that might affect
240 the new Samba installation. With 4.10.4, I got 236 failures, 73 errors,
241 and 2 unexpected successes. These were all known upstream, and you can
242 find them in the knownfail list in their git repo. This is per
243 Upstream's recommendation over IRC.
244 -->
[8c602db7]245
[e5f33088]246 <note>
[b51fe6e]247 <para>
248 Additionally, developer test suites are available. If you've installed
249 the optional python modules above, you can run these tests with
250 <command>make test</command>. It is not recommended for the average
251 builder at around 290 SBU and over a gigabyte of disk space, and you
252 should expect ~73 errors and ~30 failures from the 3000+ tests.
253 </para>
[e5f33088]254 </note>
[0f53ca47]255
[b51fe6e]256 <para>
257 Now, as the <systemitem class="username">root</systemitem> user:
258 </para>
[38b41c2]259
[214b9ac]260<screen role="root"><userinput>make install &amp;&amp;
261
[d2ed3b2]262mv -v /usr/lib/libnss_win{s,bind}.so.* /lib &amp;&amp;
[7cae14c]263ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so &amp;&amp;
264ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so &amp;&amp;
[214b9ac]265
[b0ed6bdf]266install -v -m644 examples/smb.conf.default /etc/samba &amp;&amp;
[214b9ac]267
[7cae14c]268mkdir -pv /etc/openldap/schema &amp;&amp;
269
270install -v -m644 examples/LDAP/README \
271 /etc/openldap/schema/README.LDAP &amp;&amp;
[f3429309]272
[7cae14c]273install -v -m644 examples/LDAP/samba* \
274 /etc/openldap/schema &amp;&amp;
[f3429309]275
[96770a19]276install -v -m755 examples/LDAP/{get*,ol*} \
[d9e0208]277 /etc/openldap/schema</userinput></screen>
[7cae14c]278
[99ef1fc]279 </sect2>
280
281 <sect2 role="commands">
282 <title>Command Explanations</title>
283
[b51fe6e]284 <para>
285 <parameter>--enable-fhs</parameter>: Assigns all other file paths in
286 a manner compliant with the Filesystem Hierarchy Standard (FHS).
287 </para>
[99ef1fc]288
[b51fe6e]289 <para revision="sysv">
290 <parameter>--without-systemd</parameter>: Disable
291 <application>systemd</application> integration, since it is not built
292 in the System V version of LFS/BLFS.
293 </para>
[5ca14bdd]294
[b51fe6e]295 <para>
[204252e]296 <parameter>--without-ad-dc</parameter>: Disables
[b51fe6e]297 Active Directory Domain Controller functionality. See <ulink url=
298 "https://wiki.samba.org/index.php/Setup_a_Samba_Active_Directory_Domain_Controller">
299 Setup a Samba Active Directory Domain Controller</ulink> for detailed
300 information. Remove this switch if you've installed the Python modules
301 needed for ADS support. Note that BLFS does not provide a samba bootscript
[65a15acc]302 or systemd unit for an Active Directory domain controller.
[b51fe6e]303 </para>
[6dcdcde]304
[b51fe6e]305 <para>
306 <option>--with-selftest-prefix=SELFTEST_PREFIX</option>: This option
307 specifies the test suite work directory (default=./st).
308 </para>
[99ece5d]309
[b51fe6e]310 <para>
311 <command>mv -v /usr/lib/libnss_win{s,bind}.so* /lib</command>:
312 The nss libraries are installed in
313 <filename class="directory">/usr/lib</filename> by default. Move them to
314 <filename class="directory">/lib</filename>.
315 </para>
[e85edcc]316
[b51fe6e]317 <para>
318 <command>ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so</command>
319 and <command>ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so</command>:
320 These symlinks are required when applications build against these
321 libraries.
322 </para>
[5e8ab95]323
[b51fe6e]324 <para>
325 <command>install -v -m644 examples/LDAP/* /etc/openldap/schema</command>:
326 These commands are used to copy sample Samba schemas to the OpenLDAP
327 <filename class='directory'>schema</filename> directory.
328 </para>
[99ef1fc]329
[b51fe6e]330 <para>
331 <command>install -v -m644 ../examples/smb.conf.default
332 /etc/samba</command>: This copies a default <filename>smb.conf</filename>
333 file into <filename>/etc/samba</filename>. This sample configuration will
334 not work until you copy it to <filename>/etc/samba/smb.conf</filename> and
335 make the appropriate changes for your installation. See the configuration
336 section for minimum values which must be set.
337 </para>
[99ef1fc]338
339 </sect2>
340
341 <sect2 role="configuration">
342 <title>Configuring Samba</title>
343
[45f56ac]344 <sect3 id="samba-config">
[99ef1fc]345 <title>Config Files</title>
346
[b51fe6e]347 <para>
348 /etc/samba/smb.conf
349 </para>
[99ef1fc]350
[45f56ac]351 <indexterm zone="samba samba-config">
[99ef1fc]352 <primary sortas="e-etc-samba-smb.conf">/etc/samba/smb.conf</primary>
353 </indexterm>
354
355 </sect3>
[e75747d1]356
[2ccb0dc]357 <sect3>
[fc290c7]358 <title>Printing to SMB Clients</title>
[2ccb0dc]359
[b51fe6e]360 <para>
361 If you use <application>CUPS</application> for print services, and you
362 wish to print to a printer attached to an SMB client, you need to
363 create an SMB backend device. To create the device, issue the following
364 command as the <systemitem class="username">root</systemitem> user:
365 </para>
[2ccb0dc]366
[b51fe6e]367<screen role="root"><userinput>install -dvm 755 /usr/lib/cups/backend &amp;&amp;
368ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
[2ccb0dc]369
370 </sect3>
371
[99ef1fc]372 <sect3>
[fc290c7]373 <title>Configuration Information</title>
[99ef1fc]374
[b51fe6e]375 <para>
376 Due to the complexity and the many various uses for
377 <application>Samba</application>, complete configuration for all the
378 package's capabilities is well beyond the scope of the BLFS book. This
379 section provides instructions to configure the
380 <filename>/etc/samba/smb.conf</filename> file for two common scenarios.
381 The complete contents of <filename>/etc/samba/smb.conf</filename> will
382 depend on the purpose of <application>Samba</application>
383 installation.
384 </para>
[fc290c7]385
386 <note>
[b51fe6e]387 <para>
388 You may find it easier to copy the configuration parameters shown
389 below into an empty <filename>/etc/samba/smb.conf</filename> file
390 instead of copying and editing the default file as mentioned in the
391 <quote>Command Explanations</quote> section. How you create/edit the
392 <filename>/etc/samba/smb.conf</filename> file will be left up to
393 you. Do ensure the file is only writeable by the
394 <systemitem class="username">root</systemitem> user (mode 644).
395 </para>
[fc290c7]396 </note>
397
398 <sect4>
399 <title>Scenario 1: Minimal Standalone Client-Only Installation</title>
400
[b51fe6e]401 <para>
402 Choose this variant if you only want to transfer files using
403 <command>smbclient</command>, mount Windows shares and print to
404 Windows printers, and don't want to share your files and printers to
405 Windows machines.
406 </para>
[fc290c7]407
[b51fe6e]408 <para>
409 A <filename>/etc/samba/smb.conf</filename> file with the following
410 three parameters is sufficient:
411 </para>
[fc290c7]412
413<screen role='root'><literal>[global]
414 workgroup = <replaceable>MYGROUP</replaceable>
415 dos charset = <replaceable>cp850</replaceable>
416 unix charset = <replaceable>ISO-8859-1</replaceable></literal></screen>
417
[b51fe6e]418 <para>
419 The values in this example specify that the computer belongs to a
420 Windows workgroup named
421 <quote><replaceable>MYGROUP</replaceable></quote>, uses the
422 <quote><replaceable>cp850</replaceable></quote> character set on the
423 wire when talking to MS-DOS and MS Windows 9x, and that the filenames
424 are stored in the <quote><replaceable>ISO-8859-1</replaceable></quote>
425 encoding on the disk. Adjust these values appropriately for your
426 installation. The <quote>unix charset</quote> value must be the same
427 as the output of <command>locale charmap</command> when executed with
428 the <envar>LANG</envar> variable set to your preferred locale,
429 otherwise the <command>ls</command> command may not display correct
430 filenames of downloaded files.
431 </para>
432
433 <para>
434 There is no need to run any <application>Samba</application>
435 servers in this scenario, thus you don't need to install the provided
436 bootscripts.
437 </para>
[fc290c7]438
439 </sect4>
440
441 <sect4>
442 <title>Scenario 2: Standalone File/Print Server</title>
443
[b51fe6e]444 <para>
445 Choose this variant if you want to share your files and printers
446 to Windows machines in your workgroup in addition to the capabilities
447 described in Scenario 1.
448 </para>
449
450 <para>
451 In this case, the <filename>/etc/samba/smb.conf.default</filename>
452 file may be a good template to start from. Also add
453 <quote>dos charset</quote> and <quote>unix charset</quote> parameters
454 to the <quote>[global]</quote> section as described in Scenario 1 in
455 order to prevent filename corruption. For security reasons, you may
456 wish to define
457 <replaceable>path = /home/alice/shared-files</replaceable>,
458 assuming your user name is <replaceable>alice</replaceable> and you
459 only want to share the files in that directory, instead of your entire
460 home. Then, replace <replaceable>homes</replaceable> by
461 <replaceable>shared-files</replaceable> and change also the
462 <quote><literal>comment</literal></quote> if used the configuration
463 file below or the <filename>/etc/samba/smb.conf.default</filename>
464 to create yours.
465 </para>
466
467 <para>
468 The following configuration file creates a separate share for each
469 user's home directory and also makes all printers available to Windows
470 machines:
471 </para>
[fc290c7]472
473<screen role='root'><literal>[global]
474 workgroup = <replaceable>MYGROUP</replaceable>
475 dos charset = <replaceable>cp850</replaceable>
476 unix charset = <replaceable>ISO-8859-1</replaceable>
477
478[homes]
479 comment = Home Directories
480 browseable = no
481 writable = yes
482
483[printers]
484 comment = All Printers
485 path = /var/spool/samba
486 browseable = no
487 guest ok = no
488 printable = yes</literal></screen>
489
[b51fe6e]490 <para>
491 Other parameters you may wish to customize in the
492 <quote>[global]</quote> section include:
493 </para>
[fc290c7]494
495<screen role='root'><literal> server string =
496 security =
497 hosts allow =
498 load printers =
499 log file =
500 max log size =
501 socket options =
502 local master =</literal></screen>
503
[b51fe6e]504 <para>
505 Reference the comments in the
506 <filename>/etc/samba/smb.conf.default</filename> file for information
507 regarding these parameters.
508 </para>
[fc290c7]509
[b51fe6e]510 <para>
511 Since the <command>smbd</command> and <command>nmbd</command> daemons
512 are needed in this case, install the <filename>samba</filename>
513 bootscript. Be sure to run <command>smbpasswd</command> (with the
514 <option>-a</option> option to add users) to enable and set passwords
515 for all accounts that need <application>Samba</application> access.
516 Using the default <application>Samba</application> passdb backend,
517 any user you attempt to add will also be required to exist in the
518 <filename>/etc/passwd</filename> file.
519 </para>
[fc290c7]520
521 </sect4>
522
523 <sect4>
524 <title>Advanced Requirements</title>
525
[b51fe6e]526 <para>
527 More complex scenarios involving domain control or membership are
528 possible. Such setups are advanced topics and cannot be adequately
529 covered in BLFS. Many complete books have been written on these topics
530 alone. Note that in some domain membership scenarios, the
531 <command>winbindd</command> daemon and the corresponding bootscript
532 are needed.
533 </para>
[fc290c7]534
[e78d0e0]535 <!-- All of these docs are years out of date. These were written for Samba 3,
536 and still mention Windows XP Professional as the current OS, dating them
537 back to before 2006 (When Windows Vista Business was released).
[b51fe6e]538 <para>
539 There is quite a bit of documentation available which covers many
540 of these advanced configurations. Point your web browser to the links
541 below to view some of the documentation included with the
542 <application>Samba</application> package:
543 </para>
[fc290c7]544
545 <itemizedlist spacing='compact'>
546 <listitem>
[b51fe6e]547 <para>
548 Using Samba, 2nd Edition; a popular book published by O'Reilly
549 <ulink url=
550 "http://www.samba.org/samba/docs/using_samba/toc.html"/>
551 </para>
[fc290c7]552 </listitem>
553 <listitem>
[b51fe6e]554 <para>
555 The Official Samba HOWTO and Reference Guide <ulink url=
556 "http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/"/>
[fc290c7]557 </para>
558 </listitem>
559 <listitem>
[b51fe6e]560 <para>
561 Samba-3 by Example
562 <ulink url="http://www.samba.org/samba/docs/man/Samba-Guide/"/>
[fc290c7]563 </para>
564 </listitem>
565 </itemizedlist>
[e78d0e0]566 -->
[fc290c7]567 </sect4>
[99ef1fc]568
[8c2155e]569 <sect4>
570 <title>Guest account</title>
571
[b51fe6e]572 <para>
573 The default <application>Samba</application> installation uses the
574 <systemitem class='username'>nobody</systemitem> user for guest
575 access to the server. This can be overridden by setting the
576 <option>guest account =</option> parameter in the
577 <filename>/etc/samba/smb.conf</filename> file. If you utilize the
578 <option>guest account =</option> parameter, ensure this user exists
579 in the <filename>/etc/passwd</filename> file.
580 </para>
[8c2155e]581
582 </sect4>
583
[7b478500]584 <sect4 id="samba-init" revision="sysv">
[75f9474f]585 <title>Boot Script</title>
[0d7900a]586
[b51fe6e]587 <para>
588 For your convenience, boot scripts have been provided for
589 <application>Samba</application>. There are two included in the
590 <xref linkend="bootscripts"/> package. The first,
591 <filename>samba</filename>, will start the <command>smbd</command>
592 and <command>nmbd</command> daemons needed to provide SMB/CIFS
593 services. The second script, <filename>winbind</filename>, starts
594 the <command>winbindd</command> daemon, used for providing Windows
595 domain services to Linux clients.
596 </para>
[0d7900a]597
[45f56ac]598 <indexterm zone="samba samba-init">
[75f9474f]599 <primary sortas="f-samba">samba</primary>
[fc290c7]600 </indexterm>
[0d7900a]601
[45f56ac]602 <indexterm zone="samba samba-init">
[75f9474f]603 <primary sortas="f-winbind">winbind</primary>
[fc290c7]604 </indexterm>
[0d7900a]605
[75f9474f]606<screen role="root"><userinput>make install-samba</userinput></screen>
[99ef1fc]607
[97926ab]608<screen role="root"><userinput>make install-winbindd</userinput></screen>
[99ef1fc]609
[7b478500]610 </sect4>
611
612 <sect4 id="samba-init-sysd" revision="systemd">
613 <title>Systemd Units</title>
614
615 <para>
616 To start the <application>Samba</application> daemons at boot,
617 install the systemd units from the <xref linkend="systemd-units"/>
618 package by running the following command as the
619 <systemitem class="username">root</systemitem> user:
620 </para>
621
622 <indexterm zone="samba samba-init-sysd">
623 <primary sortas="f-samba">samba</primary>
624 </indexterm>
625
626<screen role="root"><userinput>make install-samba</userinput></screen>
627
628 <para>
629 To start the <command>winbindd</command> daemon at boot,
630 install the systemd unit from the <xref linkend="systemd-units"/>
631 package by running the following command as the
632 <systemitem class="username">root</systemitem> user:
633 </para>
634
635 <indexterm zone="samba samba-init-sysd">
636 <primary sortas="f-winbindd">winbindd</primary>
637 </indexterm>
638
639<screen role="root"><userinput>make install-winbindd</userinput></screen>
640
641 <note>
[b51fe6e]642 <para>
643 This package comes with two types of units: A service file and a
644 socket file. The service file will start the smbd daemon once at
645 boot and it will keep running until the system shuts down. The
646 socket file will make systemd listen on the smbd port (Default 445,
647 needs to be edited for anything else) and will start the smbd
648 daemon when something tries to connect to that port and stop the
649 daemon when the connection is terminated. This is called socket
650 activation and is analogous to using
651 <application>{,x}inetd</application> on a SysVinit based system.
652 </para>
653
654 <para>
655 By default, the first method is used - the smbd daemon is started
656 at boot and stopped at shutdown. If the socket method is desired,
657 you need to run the following commands as the <systemitem
658 class="username">root</systemitem> user:
659 </para>
[7b478500]660
661<screen role="root"><userinput>systemctl stop smbd &amp;&amp;
662systemctl disable smbd &amp;&amp;
663systemctl enable smbd.socket &amp;&amp;
664systemctl start smbd.socket</userinput></screen>
665
[b51fe6e]666 <para>
667 Note that only the smbd daemon can be socket activated.
668 </para>
[7b478500]669 </note>
670 </sect4>
[99ef1fc]671
[75f9474f]672 </sect3>
[99ef1fc]673
674 </sect2>
675
676 <sect2 role="content">
677 <title>Contents</title>
678
679 <segmentedlist>
680 <segtitle>Installed Programs</segtitle>
681 <segtitle>Installed Libraries</segtitle>
682 <segtitle>Installed Directories</segtitle>
683
684 <seglistitem>
[7cae14c]685
[defca61]686 <seg>
[9f5acea]687 cifsdd, dbwrap_tool, dumpmscat, eventlogadm, findsmb,gentest,
688 ldbadd, ldbdel, ldbedit, ldbmodify, ldbrename, ldbsearch, locktest,
[6f3f40f3]689 masktest, mdfind, mvxattr, ndrdump, net, nmbd, nmblookup, ntlm_auth,
690 oLschema2ldif, pdbedit, <!--pidl,--> profiles, regdiff, regpatch,
691 regshell, regtree, rpcclient, samba, samba_dnsupdate,
692 samba_downgrade_db, samba_kcc, samba-gpupdate, samba-regedit,
693 samba_spnupdate, samba-tool, samba_upgradedns, sharesec, smbcacls,
694 smbclient, smbcontrol, smbcquotas, smbd, smbget, smbpasswd, smbspool,
695 smbstatus, smbtar, <!-- smbta-util, --> smbtorture, smbtree,
696 tdbbackup, tdbdump, tdbrestore, tdbtool, testparm, wbinfo, and winbindd
[defca61]697 </seg>
698
699 <seg>
[2dbb5526]700 <!-- libdcerpc-atsvc.so, --> libdcerpc-binding.so, libdcerpc-samr.so,
[6f3f40f3]701 libdcerpc-server-core.so, libdcerpc-server.so, libdcerpc.so,
702 <!-- libgensec.so, --> libndr-krb5pac.so, libndr-nbt.so, libndr.so,
703 libndr-standard.so, libnetapi.so, libnss_winbind.so, libnss_wins.so,
[2dbb5526]704 <!-- libregistry.so, --> libsamba-credentials.so, libsamba-errors.so,
[3fdc9b0]705 libsamba-hostconfig.so, libsamba-passdb.so,
[6f3f40f3]706 libsamba-policy.cpython-38-x86_64-linux-gnu.so, libsamba-util.so,
707 libsamdb.so, <!-- libsmbclient-raw.so, --> libsmbclient.so,
708 libsmbconf.so, libsmbldap.so, libtevent-util.so,
[2dbb5526]709 <!-- libtevent-unix.so, libtorture.so, -->
[3fdc9b0]710 libwbclient.so, <!--mit_samba.so,
[2dbb5526]711 --> and winbind_krb5_locator.so; the pam_winbind.so
712 <!-- pam_smbpass.so --> PAM library; and assorted character set,
713 filesystem and support modules under
[6f3f40f3]714 /usr/lib/{python&python3-majorver;,samba}
[defca61]715 </seg>
[f3429309]716
[defca61]717 <seg>
718 /etc/samba, /run/samba, /usr/include/samba-4.0,
[6f3f40f3]719 <!--/usr/lib/perl5/vendor_perl/5.x.y/Parse/Pidl/{Samba{3,4},Wireshark},-->
[9f5acea]720 /usr/lib/python&python3-majorver;/site-packages/samba,
721 /usr/libexec/samba, /usr/{lib,share}/samba,
722 and /var/{cache,lib,lock,log,run}/samba
[defca61]723 </seg>
[7cae14c]724
[99ef1fc]725 </seglistitem>
726 </segmentedlist>
727
728 <variablelist>
729 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
730 <?dbfo list-presentation="list"?>
731 <?dbhtml list-presentation="table"?>
732
[72d90b67]733 <varlistentry id="cifsdd">
734 <term><command>cifsdd</command></term>
735 <listitem>
[b51fe6e]736 <para>
[4c24eb0a]737 is the dd command for SMB
[b51fe6e]738 </para>
[72d90b67]739 <indexterm zone="samba cifsdd">
740 <primary sortas="b-cifsdd">cifsdd</primary>
741 </indexterm>
742 </listitem>
743 </varlistentry>
744
745 <varlistentry id="dbwrap_tool">
746 <term><command>dbwrap_tool</command></term>
747 <listitem>
[b51fe6e]748 <para>
749 is used to read and manipulate TDB/CTDB databases using
[4c24eb0a]750 the dbwrap interface
[b51fe6e]751 </para>
[72d90b67]752 <indexterm zone="samba dbwrap_tool">
753 <primary sortas="b-dbwrap_tool">dbwrap_tool</primary>
754 </indexterm>
755 </listitem>
756 </varlistentry>
757
[a8ecf657]758 <varlistentry id="eventlogadm">
759 <term><command>eventlogadm</command></term>
760 <listitem>
[b51fe6e]761 <para>
762 is used to write records to eventlogs from STDIN, add the
763 specified source and DLL eventlog registry entries and display the
[4c24eb0a]764 active eventlog names (from <filename>smb.conf</filename>)
[b51fe6e]765 </para>
[45f56ac]766 <indexterm zone="samba eventlogadm">
[a8ecf657]767 <primary sortas="b-eventlogadm">eventlogadm</primary>
768 </indexterm>
769 </listitem>
770 </varlistentry>
771
[a6e9ec1]772 <varlistentry id="findsmb">
773 <term><command>findsmb</command></term>
774 <listitem>
[b51fe6e]775 <para>
776 is used to list info about machines that respond to SMB name
[4c24eb0a]777 queries on a subnet
[b51fe6e]778 </para>
[a6e9ec1]779 <indexterm zone="samba findsmb">
780 <primary sortas="b-findsmb">findsmb</primary>
781 </indexterm>
782 </listitem>
783 </varlistentry>
784
[72d90b67]785 <varlistentry id="gentest">
786 <term><command>gentest</command></term>
787 <listitem>
[b51fe6e]788 <para>
789 is used to run random generic SMB operations against two
[4c24eb0a]790 SMB servers and show the differences in behavior
[b51fe6e]791 </para>
[72d90b67]792 <indexterm zone="samba gentest">
793 <primary sortas="b-gentest">gentest</primary>
794 </indexterm>
795 </listitem>
796 </varlistentry>
797
[f4c0a45]798 <varlistentry id="ldbadd">
799 <term><command>ldbadd</command></term>
800 <listitem>
[b51fe6e]801 <para>
802 is a command-line utility for adding records to an LDB
[4c24eb0a]803 database
[b51fe6e]804 </para>
[45f56ac]805 <indexterm zone="samba ldbadd">
[f4c0a45]806 <primary sortas="b-ldbadd">ldbadd</primary>
807 </indexterm>
808 </listitem>
809 </varlistentry>
810
811 <varlistentry id="ldbdel">
812 <term><command>ldbdel</command></term>
813 <listitem>
[b51fe6e]814 <para>
[4c24eb0a]815 is a command-line program for deleting LDB database records
[b51fe6e]816 </para>
[45f56ac]817 <indexterm zone="samba ldbdel">
[f4c0a45]818 <primary sortas="b-ldbdel">ldbdel</primary>
819 </indexterm>
820 </listitem>
821 </varlistentry>
822
823 <varlistentry id="ldbedit">
824 <term><command>ldbedit</command></term>
825 <listitem>
[b51fe6e]826 <para>
[4c24eb0a]827 allows you to edit LDB databases using your preferred editor
[b51fe6e]828 </para>
[45f56ac]829 <indexterm zone="samba ldbedit">
[f4c0a45]830 <primary sortas="b-ldbedit">ldbedit</primary>
831 </indexterm>
832 </listitem>
833 </varlistentry>
834
835 <varlistentry id="ldbmodify">
836 <term><command>ldbmodify</command></term>
837 <listitem>
[b51fe6e]838 <para>
[4c24eb0a]839 allows you to modify records in an LDB database
[b51fe6e]840 </para>
[45f56ac]841 <indexterm zone="samba ldbmodify">
[f4c0a45]842 <primary sortas="b-ldbmodify">ldbmodify</primary>
843 </indexterm>
844 </listitem>
845 </varlistentry>
846
847 <varlistentry id="ldbrename">
848 <term><command>ldbrename</command></term>
849 <listitem>
[b51fe6e]850 <para>
[4c24eb0a]851 allows you to rename LDB databases
[b51fe6e]852 </para>
[45f56ac]853 <indexterm zone="samba ldbrename">
[f4c0a45]854 <primary sortas="b-ldbrename">ldbrename</primary>
855 </indexterm>
856 </listitem>
857 </varlistentry>
858
859 <varlistentry id="ldbsearch">
860 <term><command>ldbsearch</command></term>
861 <listitem>
[b51fe6e]862 <para>
863 searches an LDB database for records matching a specified
[4c24eb0a]864 expression
[b51fe6e]865 </para>
[45f56ac]866 <indexterm zone="samba ldbsearch">
[f4c0a45]867 <primary sortas="b-ldbsearch">ldbsearch</primary>
868 </indexterm>
869 </listitem>
870 </varlistentry>
871
[72d90b67]872 <varlistentry id="locktest">
873 <term><command>locktest</command></term>
874 <listitem>
[b51fe6e]875 <para>
[4c24eb0a]876 is used to find differences in locking between two SMB servers
[b51fe6e]877 </para>
[72d90b67]878 <indexterm zone="samba locktest">
879 <primary sortas="b-locktest">locktest</primary>
880 </indexterm>
881 </listitem>
882 </varlistentry>
883
884 <varlistentry id="masktest">
885 <term><command>masktest</command></term>
886 <listitem>
[b51fe6e]887 <para>
888 is used to find differences in wildcard matching between
[4c24eb0a]889 Samba's implementation and that of a remote server
[b51fe6e]890 </para>
[72d90b67]891 <indexterm zone="samba masktest">
892 <primary sortas="b-masktest">masktest</primary>
[a6e9ec1]893 </indexterm>
894 </listitem>
895 </varlistentry>
896
[6f3f40f3]897 <varlistentry id="mdfind">
898 <term><command>mdfind</command></term>
899 <listitem>
900 <para>
901 runs <application>Spotlight</application> searches against a SMB
[4c24eb0a]902 server
[6f3f40f3]903 </para>
904 <indexterm zone="samba mdfind">
905 <primary sortas="b-mdfind">mdfind</primary>
906 </indexterm>
907 </listitem>
908 </varlistentry>
909
[a6e9ec1]910 <varlistentry id="mvxattr">
911 <term><command>mvxattr</command></term>
912 <listitem>
[b51fe6e]913 <para>
[4c24eb0a]914 is used to recursively rename extended attributes
[b51fe6e]915 </para>
[a6e9ec1]916 <indexterm zone="samba mvxattr">
917 <primary sortas="b-mvxattr">mvxattr</primary>
[72d90b67]918 </indexterm>
919 </listitem>
920 </varlistentry>
921
922 <varlistentry id="ndrdump">
923 <term><command>ndrdump</command></term>
924 <listitem>
[b51fe6e]925 <para>
[4c24eb0a]926 is a DCE/RPC Packet Parser and Dumper
[b51fe6e]927 </para>
[72d90b67]928 <indexterm zone="samba ndrdump">
929 <primary sortas="b-ndrdump">ndrdump</primary>
930 </indexterm>
931 </listitem>
932 </varlistentry>
933
[99ef1fc]934 <varlistentry id="net">
935 <term><command>net</command></term>
936 <listitem>
[b51fe6e]937 <para>
938 is a tool for administration of <application>Samba</application>
939 and remote CIFS servers, similar to the <command>net</command>
[4c24eb0a]940 utility for DOS/Windows
[b51fe6e]941 </para>
[45f56ac]942 <indexterm zone="samba net">
[99ef1fc]943 <primary sortas="b-net">net</primary>
944 </indexterm>
945 </listitem>
946 </varlistentry>
947
948 <varlistentry id="nmbd">
949 <term><command>nmbd</command></term>
950 <listitem>
[b51fe6e]951 <para>
[4c24eb0a]952 is the <application>Samba</application> NetBIOS name server
[b51fe6e]953 </para>
[45f56ac]954 <indexterm zone="samba nmbd">
[99ef1fc]955 <primary sortas="b-nmbd">nmbd</primary>
956 </indexterm>
957 </listitem>
958 </varlistentry>
959
960 <varlistentry id="nmblookup">
961 <term><command>nmblookup</command></term>
962 <listitem>
[b51fe6e]963 <para>
[4c24eb0a]964 is used to query NetBIOS names and map them to IP addresses
[b51fe6e]965 </para>
[45f56ac]966 <indexterm zone="samba nmblookup">
[99ef1fc]967 <primary sortas="b-nmblookup">nmblookup</primary>
968 </indexterm>
969 </listitem>
970 </varlistentry>
971
972 <varlistentry id="ntlm_auth">
973 <term><command>ntlm_auth</command></term>
974 <listitem>
[b51fe6e]975 <para>
976 is a tool to allow external access to Winbind's
[4c24eb0a]977 NTLM authentication function
[b51fe6e]978 </para>
[45f56ac]979 <indexterm zone="samba ntlm_auth">
[99ef1fc]980 <primary sortas="b-ntlm_auth">ntlm_auth</primary>
981 </indexterm>
982 </listitem>
983 </varlistentry>
984
[72d90b67]985 <varlistentry id="oLschema2ldif">
986 <term><command>oLschema2ldif</command></term>
987 <listitem>
[b51fe6e]988 <para>
[4c24eb0a]989 converts LDAP schema's to LDB-compatible LDIF
[b51fe6e]990 </para>
[72d90b67]991 <indexterm zone="samba oLschema2ldif">
992 <primary sortas="b-oLschema2ldif">oLschema2ldif</primary>
993 </indexterm>
994 </listitem>
995 </varlistentry>
996
[99ef1fc]997 <varlistentry id="pdbedit">
998 <term><command>pdbedit</command></term>
999 <listitem>
[b51fe6e]1000 <para>
[4c24eb0a]1001 is a tool used to manage the SAM database
[b51fe6e]1002 </para>
[45f56ac]1003 <indexterm zone="samba pdbedit">
[99ef1fc]1004 <primary sortas="b-pdbedit">pdbedit</primary>
1005 </indexterm>
1006 </listitem>
1007 </varlistentry>
1008
[6f3f40f3]1009 <!--
[72d90b67]1010 <varlistentry id="pidl">
1011 <term><command>pidl</command></term>
1012 <listitem>
[b51fe6e]1013 <para>
1014 is an IDL (Interface Definition Language) compiler
1015 written in Perl.
1016 </para>
[72d90b67]1017 <indexterm zone="samba pidl">
1018 <primary sortas="b-pidl">pidl</primary>
1019 </indexterm>
1020 </listitem>
1021 </varlistentry>
[6f3f40f3]1022 -->
[72d90b67]1023
[99ef1fc]1024 <varlistentry id="profiles">
1025 <term><command>profiles</command></term>
1026 <listitem>
[b51fe6e]1027 <para>
1028 is a utility that reports and changes SIDs in Windows
[4c24eb0a]1029 registry files. It currently only supports Windows NT
[b51fe6e]1030 </para>
[45f56ac]1031 <indexterm zone="samba profiles">
[99ef1fc]1032 <primary sortas="b-profiles">profiles</primary>
1033 </indexterm>
1034 </listitem>
1035 </varlistentry>
1036
[72d90b67]1037 <varlistentry id="regdiff">
1038 <term><command>regdiff</command></term>
1039 <listitem>
[b51fe6e]1040 <para>
[4c24eb0a]1041 is a Diff program for Windows registry files
[b51fe6e]1042 </para>
[72d90b67]1043 <indexterm zone="samba regdiff">
1044 <primary sortas="b-regdiff">regdiff</primary>
1045 </indexterm>
1046 </listitem>
1047 </varlistentry>
1048
1049 <varlistentry id="regpatch">
1050 <term><command>regpatch</command></term>
1051 <listitem>
[b51fe6e]1052 <para>
[4c24eb0a]1053 applies registry patches to registry files
[b51fe6e]1054 </para>
[72d90b67]1055 <indexterm zone="samba regpatch">
1056 <primary sortas="b-regpatch">regpatch</primary>
1057 </indexterm>
1058 </listitem>
1059 </varlistentry>
1060
1061 <varlistentry id="regshell">
1062 <term><command>regshell</command></term>
1063 <listitem>
[b51fe6e]1064 <para>
[4c24eb0a]1065 is a Windows registry file browser using readline
[b51fe6e]1066 </para>
[72d90b67]1067 <indexterm zone="samba regshell">
1068 <primary sortas="b-regshell">regshell</primary>
1069 </indexterm>
1070 </listitem>
1071 </varlistentry>
1072
1073 <varlistentry id="regtree">
1074 <term><command>regtree</command></term>
1075 <listitem>
[b51fe6e]1076 <para>
[4c24eb0a]1077 is a text-mode registry viewer
[b51fe6e]1078 </para>
[72d90b67]1079 <indexterm zone="samba regtree">
1080 <primary sortas="b-regtree">regtree</primary>
1081 </indexterm>
1082 </listitem>
1083 </varlistentry>
1084
[99ef1fc]1085 <varlistentry id="rpcclient">
1086 <term><command>rpcclient</command></term>
1087 <listitem>
[b51fe6e]1088 <para>
[4c24eb0a]1089 is used to execute MS-RPC client side functions
[b51fe6e]1090 </para>
[45f56ac]1091 <indexterm zone="samba rpcclient">
[99ef1fc]1092 <primary sortas="b-rpcclient">rpcclient</primary>
1093 </indexterm>
1094 </listitem>
1095 </varlistentry>
1096
[72d90b67]1097 <varlistentry id="samba-prog">
1098 <term><command>samba</command></term>
1099 <listitem>
[b51fe6e]1100 <para>
1101 is a server to provide AD and SMB/CIFS services
[4c24eb0a]1102 to clients
[b51fe6e]1103 </para>
[72d90b67]1104 <indexterm zone="samba samba-prog">
1105 <primary sortas="b-samba-prog">samba</primary>
1106 </indexterm>
1107 </listitem>
1108 </varlistentry>
1109
1110 <varlistentry id="samba_dnsupdate">
1111 <term><command>samba_dnsupdate</command></term>
1112 <listitem>
[b51fe6e]1113 <para>
[4c24eb0a]1114 is used to update the DNS names using TSIG-GSS
[b51fe6e]1115 </para>
[72d90b67]1116 <indexterm zone="samba samba_dnsupdate">
1117 <primary sortas="b-samba_dnsupdate">samba_dnsupdate</primary>
1118 </indexterm>
1119 </listitem>
1120 </varlistentry>
1121
[6f3f40f3]1122 <varlistentry id="samba_downgrade_db">
1123 <term><command>samba_downgrade_db</command></term>
1124 <listitem>
1125 <para>
1126 downgrades the Samba AD database to be compatible with a previous
[4c24eb0a]1127 version of Samba
[6f3f40f3]1128 </para>
1129 <indexterm zone="samba samba_downgrade_db">
1130 <primary sortas="b-samba_downgrade_db">samba_downgrade_db</primary>
1131 </indexterm>
1132 </listitem>
1133 </varlistentry>
1134
[72d90b67]1135 <varlistentry id="samba_kcc">
1136 <term><command>samba_kcc</command></term>
1137 <listitem>
[b51fe6e]1138 <para>
1139 is a script used to compute your KCC (Knowledge
[4c24eb0a]1140 Consistency Checker) topology
[b51fe6e]1141 </para>
[72d90b67]1142 <indexterm zone="samba samba_kcc">
1143 <primary sortas="b-samba_kcc">samba_kcc</primary>
1144 </indexterm>
1145 </listitem>
1146 </varlistentry>
1147
[7d25056d]1148 <varlistentry id="samba-gpupdate">
1149 <term><command>samba-gpupdate</command></term>
1150 <listitem>
[b51fe6e]1151 <para>
[4c24eb0a]1152 allows you to edit Microsoft Group Policy Objects (GPOs)
[b51fe6e]1153 </para>
[7d25056d]1154 <indexterm zone="samba samba-gpupdate">
1155 <primary sortas="b-samba-gpupdate">samba-gpupdate</primary>
1156 </indexterm>
1157 </listitem>
1158 </varlistentry>
1159
[72d90b67]1160 <varlistentry id="samba-regedit">
1161 <term><command>samba-regedit</command></term>
1162 <listitem>
[b51fe6e]1163 <para>
[4c24eb0a]1164 is a ncurses based tool to manage the Samba registry
[b51fe6e]1165 </para>
[72d90b67]1166 <indexterm zone="samba samba-regedit">
1167 <primary sortas="b-samba-regedit">samba-regedit</primary>
1168 </indexterm>
1169 </listitem>
1170 </varlistentry>
1171
1172 <varlistentry id="samba_spnupdate">
1173 <term><command>samba_spnupdate</command></term>
1174 <listitem>
[b51fe6e]1175 <para>
1176 is a script to update the servicePrincipalName
[4c24eb0a]1177 names from spn_update_list
[b51fe6e]1178 </para>
[72d90b67]1179 <indexterm zone="samba samba_spnupdate">
1180 <primary sortas="b-samba_spnupdate">samba_spnupdate</primary>
1181 </indexterm>
1182 </listitem>
1183 </varlistentry>
1184
1185 <varlistentry id="samba-tool">
1186 <term><command>samba-tool</command></term>
1187 <listitem>
[b51fe6e]1188 <para>
[4c24eb0a]1189 is the main Samba administration tool
[b51fe6e]1190 </para>
[72d90b67]1191 <indexterm zone="samba samba-tool">
1192 <primary sortas="b-samba-tool">samba-tool</primary>
1193 </indexterm>
1194 </listitem>
1195 </varlistentry>
1196
1197 <varlistentry id="samba_upgradedns">
1198 <term><command>samba_upgradedns</command></term>
1199 <listitem>
[b51fe6e]1200 <para>
[4c24eb0a]1201 upgrades the DNS records in a Samba server to a newer version
[b51fe6e]1202 </para>
[72d90b67]1203 <indexterm zone="samba samba_upgradedns">
1204 <primary sortas="b-samba_upgradedns">samba_upgradedns</primary>
1205 </indexterm>
1206 </listitem>
1207 </varlistentry>
1208
[f4c0a45]1209 <varlistentry id="sharesec">
1210 <term><command>sharesec</command></term>
1211 <listitem>
[b51fe6e]1212 <para>
[4c24eb0a]1213 manipulates share ACL permissions on SMB file shares
[b51fe6e]1214 </para>
[45f56ac]1215 <indexterm zone="samba sharesec">
[f4c0a45]1216 <primary sortas="b-sharesec">sharesec</primary>
1217 </indexterm>
1218 </listitem>
1219 </varlistentry>
1220
[99ef1fc]1221 <varlistentry id="smbcacls">
1222 <term><command>smbcacls</command></term>
1223 <listitem>
[b51fe6e]1224 <para>
[4c24eb0a]1225 is used to manipulate Windows NT access control lists
[b51fe6e]1226 </para>
[45f56ac]1227 <indexterm zone="samba smbcacls">
[99ef1fc]1228 <primary sortas="b-smbcacls">smbcacls</primary>
1229 </indexterm>
1230 </listitem>
1231 </varlistentry>
1232
1233 <varlistentry id="smbclient">
1234 <term><command>smbclient</command></term>
1235 <listitem>
[b51fe6e]1236 <para>
[4c24eb0a]1237 is a SMB/CIFS access utility, similar to FTP
[b51fe6e]1238 </para>
[45f56ac]1239 <indexterm zone="samba smbclient">
[99ef1fc]1240 <primary sortas="b-smbclient">smbclient</primary>
1241 </indexterm>
1242 </listitem>
1243 </varlistentry>
1244
1245 <varlistentry id="smbcontrol">
1246 <term><command>smbcontrol</command></term>
1247 <listitem>
[b51fe6e]1248 <para>
1249 is used to control running <command>smbd</command>,
[4c24eb0a]1250 <command>nmbd</command> and <command>winbindd</command> daemons
[b51fe6e]1251 </para>
[45f56ac]1252 <indexterm zone="samba smbcontrol">
[99ef1fc]1253 <primary sortas="b-smbcontrol">smbcontrol</primary>
1254 </indexterm>
1255 </listitem>
1256 </varlistentry>
1257
1258 <varlistentry id="smbcquotas">
1259 <term><command>smbcquotas</command></term>
1260 <listitem>
[b51fe6e]1261 <para>
[4c24eb0a]1262 is used to manipulate Windows NT quotas on SMB file shares
[b51fe6e]1263 </para>
[45f56ac]1264 <indexterm zone="samba smbcquotas">
[99ef1fc]1265 <primary sortas="b-smbcquotas">smbcquotas</primary>
1266 </indexterm>
1267 </listitem>
1268 </varlistentry>
1269
1270 <varlistentry id="smbd">
1271 <term><command>smbd</command></term>
1272 <listitem>
[b51fe6e]1273 <para>
1274 is the main <application>Samba</application> daemon which
[4c24eb0a]1275 provides SMB/CIFS services to clients
[b51fe6e]1276 </para>
[45f56ac]1277 <indexterm zone="samba smbd">
[99ef1fc]1278 <primary sortas="b-smbd">smbd</primary>
1279 </indexterm>
1280 </listitem>
1281 </varlistentry>
1282
[a8ecf657]1283 <varlistentry id="smbget">
1284 <term><command>smbget</command></term>
1285 <listitem>
[b51fe6e]1286 <para>
1287 is a simple utility with <command>wget</command>-like semantics,
1288 that can download files from SMB servers. You can specify the
[4c24eb0a]1289 files you would like to download on the command-line
[b51fe6e]1290 </para>
[45f56ac]1291 <indexterm zone="samba smbget">
[a8ecf657]1292 <primary sortas="b-smbget">smbget</primary>
1293 </indexterm>
1294 </listitem>
1295 </varlistentry>
1296
[99ef1fc]1297 <varlistentry id="smbpasswd">
1298 <term><command>smbpasswd</command></term>
1299 <listitem>
[b51fe6e]1300 <para>
[4c24eb0a]1301 changes a user's <application>Samba</application> password
[b51fe6e]1302 </para>
[45f56ac]1303 <indexterm zone="samba smbpasswd">
[99ef1fc]1304 <primary sortas="b-smbpasswd">smbpasswd</primary>
1305 </indexterm>
1306 </listitem>
1307 </varlistentry>
1308
1309 <varlistentry id="smbspool">
1310 <term><command>smbspool</command></term>
1311 <listitem>
[b51fe6e]1312 <para>
[4c24eb0a]1313 sends a print job to an SMB printer
[b51fe6e]1314 </para>
[45f56ac]1315 <indexterm zone="samba smbspool">
[99ef1fc]1316 <primary sortas="b-smbspool">smbspool</primary>
1317 </indexterm>
1318 </listitem>
1319 </varlistentry>
1320
1321 <varlistentry id="smbstatus">
1322 <term><command>smbstatus</command></term>
1323 <listitem>
[b51fe6e]1324 <para>
[4c24eb0a]1325 reports current <application>Samba</application> connections
[b51fe6e]1326 </para>
[45f56ac]1327 <indexterm zone="samba smbstatus">
[99ef1fc]1328 <primary sortas="b-smbstatus">smbstatus</primary>
1329 </indexterm>
1330 </listitem>
1331 </varlistentry>
1332
1333 <varlistentry id="smbtar">
1334 <term><command>smbtar</command></term>
1335 <listitem>
[b51fe6e]1336 <para>
1337 is a shell script used for backing up SMB/CIFS shares
[4c24eb0a]1338 directly to Linux tape drives or a file
[b51fe6e]1339 </para>
[45f56ac]1340 <indexterm zone="samba smbtar">
[99ef1fc]1341 <primary sortas="b-smbtar">smbtar</primary>
1342 </indexterm>
1343 </listitem>
1344 </varlistentry>
1345
[2dbb5526]1346<!--
[72d90b67]1347 <varlistentry id="smbta-util">
1348 <term><command>smbta-util</command></term>
1349 <listitem>
[b51fe6e]1350 <para>
1351 is a tool to ease the configuration of the
1352 vfs_smb_traffic_analyzer module regarding data encryption.
1353 </para>
[72d90b67]1354 <indexterm zone="samba smbta-util">
1355 <primary sortas="b-smbta-util">smbta-util</primary>
1356 </indexterm>
1357 </listitem>
1358 </varlistentry>
[2dbb5526]1359-->
[72d90b67]1360
1361 <varlistentry id="smbtorture">
1362 <term><command>smbtorture</command></term>
1363 <listitem>
[b51fe6e]1364 <para>
[4c24eb0a]1365 is a testsuite that runs several tests against a SMB server
[b51fe6e]1366 </para>
[72d90b67]1367 <indexterm zone="samba smbtorture">
1368 <primary sortas="b-smbtorture">smbtorture</primary>
1369 </indexterm>
1370 </listitem>
1371 </varlistentry>
1372
[99ef1fc]1373 <varlistentry id="smbtree">
1374 <term><command>smbtree</command></term>
1375 <listitem>
[b51fe6e]1376 <para>
[4c24eb0a]1377 is a text-based SMB network browser
[b51fe6e]1378 </para>
[45f56ac]1379 <indexterm zone="samba smbtree">
[99ef1fc]1380 <primary sortas="b-smbtree">smbtree</primary>
1381 </indexterm>
1382 </listitem>
1383 </varlistentry>
1384
1385 <varlistentry id="tdbbackup">
1386 <term><command>tdbbackup</command></term>
1387 <listitem>
[b51fe6e]1388 <para>
1389 is a tool for backing up or validating the integrity of
[4c24eb0a]1390 <application>Samba</application> <filename>.tdb</filename> files
[b51fe6e]1391 </para>
[45f56ac]1392 <indexterm zone="samba tdbbackup">
[99ef1fc]1393 <primary sortas="b-tdbbackup">tdbbackup</primary>
1394 </indexterm>
1395 </listitem>
1396 </varlistentry>
1397
1398 <varlistentry id="tdbdump">
1399 <term><command>tdbdump</command></term>
1400 <listitem>
[b51fe6e]1401 <para>
1402 is a tool used to print the contents of a
[4c24eb0a]1403 <application>Samba</application> <filename>.tdb</filename> file
[b51fe6e]1404 </para>
[45f56ac]1405 <indexterm zone="samba tdbdump">
[99ef1fc]1406 <primary sortas="b-tdbdump">tdbdump</primary>
1407 </indexterm>
[72d90b67]1408 </listitem>
1409 </varlistentry>
1410
1411 <varlistentry id="tdbrestore">
1412 <term><command>tdbrestore</command></term>
1413 <listitem>
[b51fe6e]1414 <para>
1415 is a tool for creating a <application>Samba</application>
[4c24eb0a]1416 <filename>.tdb</filename> file out of a ntdbdump
[b51fe6e]1417 </para>
[72d90b67]1418 <indexterm zone="samba tdbrestore">
1419 <primary sortas="b-tdbrestore">tdbrestore</primary>
1420 </indexterm>
[99ef1fc]1421 </listitem>
1422 </varlistentry>
1423
1424 <varlistentry id="tdbtool">
1425 <term><command>tdbtool</command></term>
1426 <listitem>
[b51fe6e]1427 <para>
1428 is a tool which allows simple database manipulation from the
[4c24eb0a]1429 command line
[b51fe6e]1430 </para>
[45f56ac]1431 <indexterm zone="samba tdbtool">
[99ef1fc]1432 <primary sortas="b-tdbtool">tdbtool</primary>
1433 </indexterm>
1434 </listitem>
1435 </varlistentry>
1436
1437 <varlistentry id="testparm">
1438 <term><command>testparm</command></term>
1439 <listitem>
[b51fe6e]1440 <para>
[4c24eb0a]1441 checks an <filename>smb.conf</filename> file for proper syntax
[b51fe6e]1442 </para>
[45f56ac]1443 <indexterm zone="samba testparm">
[99ef1fc]1444 <primary sortas="b-testparm">testparm</primary>
1445 </indexterm>
1446 </listitem>
1447 </varlistentry>
1448
1449 <varlistentry id="wbinfo">
1450 <term><command>wbinfo</command></term>
1451 <listitem>
[b51fe6e]1452 <para>
[4c24eb0a]1453 queries a running <command>winbindd</command> daemon
[b51fe6e]1454 </para>
[45f56ac]1455 <indexterm zone="samba wbinfo">
[99ef1fc]1456 <primary sortas="b-wbinfo">wbinfo</primary>
1457 </indexterm>
1458 </listitem>
1459 </varlistentry>
1460
1461 <varlistentry id="winbindd">
1462 <term><command>winbindd</command></term>
1463 <listitem>
[b51fe6e]1464 <para>
[4c24eb0a]1465 resolves names from Windows NT servers
[b51fe6e]1466 </para>
[45f56ac]1467 <indexterm zone="samba winbindd">
[99ef1fc]1468 <primary sortas="b-winbindd">winbindd</primary>
1469 </indexterm>
1470 </listitem>
1471 </varlistentry>
1472
[f4c0a45]1473 <varlistentry id="libnss_winbind">
[4c24eb0a]1474 <term><filename class="libraryfile">libnss_winbind.so</filename></term>
[f4c0a45]1475 <listitem>
[b51fe6e]1476 <para>
1477 provides Name Service Switch API functions for resolving names
[4c24eb0a]1478 from NT servers
[b51fe6e]1479 </para>
[45f56ac]1480 <indexterm zone="samba libnss_winbind">
[f4c0a45]1481 <primary sortas="c-libnss_winbind">libnss_winbind.so</primary>
1482 </indexterm>
1483 </listitem>
1484 </varlistentry>
1485
1486 <varlistentry id="libnss_wins">
[4c24eb0a]1487 <term><filename class="libraryfile">libnss_wins.so</filename></term>
[f4c0a45]1488 <listitem>
[b51fe6e]1489 <para>
1490 provides API functions for Samba's implementation of the
[4c24eb0a]1491 Windows Internet Naming Service
[b51fe6e]1492 </para>
[45f56ac]1493 <indexterm zone="samba libnss_wins">
[f4c0a45]1494 <primary sortas="c-libnss_wins">libnss_wins.so</primary>
1495 </indexterm>
1496 </listitem>
1497 </varlistentry>
1498
1499 <varlistentry id="libnetapi">
[4c24eb0a]1500 <term><filename class="libraryfile">libnetapi.so</filename></term>
[f4c0a45]1501 <listitem>
[b51fe6e]1502 <para>
1503 provides the API functions for the administration tools used
[4c24eb0a]1504 for Samba and remote CIFS servers
[b51fe6e]1505 </para>
[45f56ac]1506 <indexterm zone="samba libnetapi">
[f4c0a45]1507 <primary sortas="c-libnetapi">libnetapi.so</primary>
1508 </indexterm>
1509 </listitem>
1510 </varlistentry>
1511
1512 <varlistentry id="libsmbclient">
[4c24eb0a]1513 <term><filename class="libraryfile">libsmbclient.so</filename></term>
[f4c0a45]1514 <listitem>
[b51fe6e]1515 <para>
[4c24eb0a]1516 provides the API functions for the Samba SMB client tools
[b51fe6e]1517 </para>
[45f56ac]1518 <indexterm zone="samba libsmbclient">
[f4c0a45]1519 <primary sortas="c-libsmbclient">libsmbclient.so</primary>
1520 </indexterm>
1521 </listitem>
1522 </varlistentry>
[defca61]1523<!--
[f4c0a45]1524 <varlistentry id="libsmbsharemodes">
[4c24eb0a]1525 <term><filename class="libraryfile">libsmbsharemodes.so</filename></term>
[f4c0a45]1526 <listitem>
[b51fe6e]1527 <para>
1528 provides API functions for accessing SMB share modes (locks etc.)
1529 </para>
[45f56ac]1530 <indexterm zone="samba libsmbsharemodes">
[f4c0a45]1531 <primary sortas="c-libsmbsharemodes">libsmbsharemodes.so</primary>
1532 </indexterm>
1533 </listitem>
[defca61]1534 </varlistentry>-->
[f4c0a45]1535
1536 <varlistentry id="libwbclient">
[4c24eb0a]1537 <term><filename class="libraryfile">libwbclient.so</filename></term>
[f4c0a45]1538 <listitem>
[b51fe6e]1539 <para>
[4c24eb0a]1540 provides API functions for Windows domain client services
[b51fe6e]1541 </para>
[45f56ac]1542 <indexterm zone="samba libwbclient">
[f4c0a45]1543 <primary sortas="c-libwbclient">libwbclient.so</primary>
1544 </indexterm>
1545 </listitem>
1546 </varlistentry>
1547
[99ef1fc]1548 </variablelist>
1549
1550 </sect2>
1551
1552</sect1>
Note: See TracBrowser for help on using the repository browser.