source: networking/netprogs/samba.xml@ d2ed3b2

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 d2ed3b2 was d2ed3b2, checked in by Xi Ruoyao <xry111@…>, 16 months ago

samba: prevent to create .so symlink in /lib

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

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