source: networking/netprogs/samba.xml@ e78d0e0

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since e78d0e0 was e78d0e0, checked in by Douglas R. Reno <renodr@…>, 16 months ago

Update to samba-4.12.5 (Security Update)
Update to glib-2.64.4

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

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