source: networking/netprogs/samba.xml@ 0f48e3a

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 0f48e3a was 81158c37, checked in by Douglas R. Reno <renodr@…>, 4 years ago

Update to samba-4.12.2
Update to cups-2.3.3
Update to gjs-1.64.2

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

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