source: networking/netprogs/samba.xml@ 676876ba

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 676876ba was 676876ba, checked in by Pierre Labastie <pierre.labastie@…>, 2 years ago

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