source: networking/netprogs/samba.xml@ 42203276

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 42203276 was 42203276, checked in by Douglas R. Reno <renodr@…>, 16 months ago

Package update

Update to samba-4.14.6

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