source: networking/netprogs/samba.xml@ 3ec1600

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

Update to Samba-4.13.2
Update to asciidoc-9.0.4
Update to git-2.29.2
telepathy-glib: Port to python3, fix tests with glib-2.46 and later, port to modern build machinery, and fix memory leaks

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