source: networking/netprogs/samba.xml@ e44952d

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 e44952d was e44952d, checked in by Douglas R. Reno <renodr@…>, 2 years ago

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