source: networking/netprogs/samba.xml@ e1dfbee4

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 e1dfbee4 was e1dfbee4, checked in by Xi Ruoyao <xry111@…>, 4 years ago

samba: fix FTBFS with Glibc-2.32

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

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