source: networking/netprogs/samba.xml@ c7f6a7e1

11.0 11.1 11.2 lazarus qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since c7f6a7e1 was c7f6a7e1, checked in by Xi Ruoyao <xry111@…>, 18 months ago

update to samba-4.14.2

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

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