source: networking/netprogs/samba.xml@ f4302700

11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since f4302700 was f4302700, checked in by Xi Ruoyao <xry111@…>, 3 years ago

CFLAGS/CPPFLAGS cleanup

Move -I and -D into CPPFLAGS, and for others use ${CFLAGS:--O2 -g} to
prevent from building "non-optimized" binary.

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

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