source: networking/netprogs/samba.xml@ f07f654

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 xry111/llvm18 xry111/soup3 xry111/xf86-video-removal
Last change on this file since f07f654 was f07f654, checked in by Douglas R. Reno <renodr@…>, 20 months ago

Four package updates

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