source: networking/netprogs/samba.xml@ ff0b8752

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 ff0b8752 was ff0b8752, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Reformat a sed
  • Property mode set to 100644
File size: 52.1 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 "2245f5b1258b782702ad644c5e9d2857">
10 <!ENTITY samba-size "18 MB">
11 <!ENTITY samba-buildsize "628 MB (add 210 MB for quicktest)">
12 <!ENTITY samba-time "2.1 SBU (using parallelism=4; add 3.4 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 &lfs110a_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="libtirpc"/>,
87 <xref linkend="lmdb"/>, and
88 <xref linkend="rpcsvc-proto"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <phrase revision="sysv"><xref linkend="dbus"/> (for vfs_snapper, which is
94 useful on systems that support Volume Shadow Copies on Windows),</phrase>
95 <xref linkend="fuse3"/>,
96 <xref linkend="gpgme"/>,
97 <xref linkend="icu"/>,
98 <xref linkend="libtasn1"/>,
99 <xref linkend="libxslt"/> (for documentation),
100 <xref linkend="linux-pam"/>,
101 <xref linkend="perl-parse-yapp"/>, and
102 <xref linkend="openldap"/>
103 </para>
104
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref linkend="avahi"/>,
108 <xref linkend="bind"/>,
109 <xref linkend="cups"/>,
110 <xref linkend="cyrus-sasl"/>,
111 <xref linkend="gdb"/>,
112 <xref linkend="git"/>,
113 <xref linkend="gnupg2"/> (required for ADS and testsuite),
114 <xref linkend="libaio"/>,
115 <xref linkend="libarchive"/>,
116 <xref linkend="libcap-pam"/>,
117 <xref linkend="libgcrypt"/>,
118 <xref linkend="libnsl"/>,
119 <xref linkend="mitkrb"/>,
120 <xref linkend="nss"/>,
121 <xref linkend="popt"/>,
122 <xref linkend="talloc"/> (included),
123 <xref linkend="vala"/>,
124 <xref linkend="valgrind"/> (optionally used by the test suite),
125 <!--<xref linkend="wireshark"/> (module installed),-->
126 <xref linkend="xfsprogs"/>,
127 <ulink url="https://cmocka.org/">cmocka</ulink>,
128 <ulink url="https://cryptography.io/en/latest/">cryptography</ulink>,
129 <ulink url="https://ctdb.samba.org/">ctdb</ulink> (included),
130 <ulink url="https://cwrap.org/">cwrap</ulink>,
131 <ulink url="&pypi;/dnspython/">dnspython</ulink>,
132 <ulink url="https://packages.debian.org/stretch/fam">FAM</ulink>,
133 <ulink url="https://people.gnome.org/~veillard/gamin/">Gamin</ulink>,
134 <ulink url="https://www.gluster.org/">GlusterFS</ulink>,
135 <ulink url="https://github.com/heimdal/">Heimdal</ulink> (included),
136 <ulink url="https://pypi.org/project/iso8601/">iso8601</ulink>,
137 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>,
138 <ulink url="https://ldb.samba.org/">ldb</ulink> (included),
139 <ulink url="&pypi;/m2crypto">M2Crypto</ulink> (required for ADS),
140 <ulink url="http://www.openafs.org/">OpenAFS</ulink>,
141 <ulink url="https://pypi.org/project/pyasn1/">pyasn1</ulink>,
142 <ulink url="&pypi;/pygpgme/">PyGPGME</ulink> (recommended for ADS),
143 <ulink url="https://tevent.samba.org/">tevent</ulink> (included),
144 <ulink url="https://tdb.samba.org/">tdb</ulink> (included), and
145 <ulink url="https://download.gnome.org/sources/tracker/2.3/">tracker-2</ulink>
146 </para>
147
148 <bridgehead renderas="sect4">Optional (for the Developer Test Suite)</bridgehead>
149 <para role="optional">
150 Install in listed order:
151 <xref linkend="six"/>,
152 <ulink url="&pypi;/argparse/">argparse</ulink>,
153 <ulink url="&pypi;/extras/">extras</ulink>,
154 <ulink url="&pypi;/py/">py</ulink>,
155 <!--<ulink url="&pypi;/enum34/">enum34</ulink>,-->
156 <ulink url="&pypi;/hypothesis/">hypothesis</ulink>,
157 <ulink url="&pypi;/pytest/">pytest</ulink>,
158 <ulink url="&pypi;/coverage/">coverage</ulink>,
159 <ulink url="&pypi;/pytest-cov/">pytest-cov</ulink>,
160 <ulink url="&pypi;/doctools/">doctools</ulink>,
161 <ulink url="&pypi;/unittest2/">unittest2</ulink>,
162 <ulink url="&pypi;/testtools/">testtools</ulink>,
163 <ulink url="&pypi;/fixtures/">fixtures</ulink>,
164 <ulink url="&pypi;/python-mimeparse/">python-mimeparse</ulink>,
165 <ulink url="&pypi;/contextlib2/">contextlib2</ulink>,
166 <ulink url="&pypi;/traceback2/">traceback2</ulink>,
167 <ulink url="&pypi;/linecache2/">linecache2</ulink>,
168 <ulink url="&pypi;/testscenarios/">testscenarios</ulink>,
169 <ulink url="&pypi;/testresources/">testresources</ulink>,
170 <ulink url="&pypi;/virtualenv/">virtualenv</ulink>,
171 <ulink url="&pypi;/pbr/">pbr</ulink>, and
172 <ulink url="&pypi;/python-subunit/">python-subunit</ulink>
173 </para>
174
175 <para condition="html" role="usernotes">User Notes:
176 <ulink url="&blfs-wiki;/samba4"/></para>
177
178 </sect2>
179
180 <sect2 role="installation">
181 <title>Installation of Samba</title>
182
183 <para>
184 To support the test suite, set up a Python virtual environment
185 for some Python modules out of the scope of BLFS:
186 </para>
187
188<screen><userinput remap="pre">python3 -m venv pyvenv &amp;&amp;
189./pyvenv/bin/pip3 install cryptography pyasn1 iso8601</userinput></screen>
190
191 <para>
192 Fix a test that always fails:
193 </para>
194
195<screen><userinput>echo "^samba4.rpc.echo.*on.*ncacn_np.*with.*object.*nt4_dc" >> selftest/knownfail</userinput></screen>
196
197 <para>
198 Fix a known regression with Samba-4.15.2:
199 </para>
200
201<screen><userinput remap="pre">sed -e 's/!is_allowed/secure_channel_type == SEC_CHAN_NULL \&amp;\&amp; &amp;/' \
202 -i source3/winbindd/winbindd_util.c</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>. With Samba-4.14.4,
246 many tests are known to fail.
247 </para>
248
249 <!--
250 If doing a security update or a new minor version (point releases do not
251 apply here), run 'make testenv' before running 'make test' and 'make
252 subunit-test'. This will setup the test environment and make the tests
253 run faster, as well as point out any glaring issues that might affect
254 the new Samba installation. With 4.10.4, I got 236 failures, 73 errors,
255 and 2 unexpected successes. These were all known upstream, and you can
256 find them in the knownfail list in their git repo. This is per
257 Upstream's recommendation over IRC.
258 -->
259
260 <note>
261 <para>
262 Additionally, developer test suites are available. If you've installed
263 the optional python modules above in the Python virtual environment
264 for building this package, you can run these tests with
265 <command>make test</command>. It is not recommended for the average
266 builder at around 290 SBU and over a gigabyte of disk space, and you
267 should expect ~73 errors and ~30 failures from the 3000+ tests.
268 </para>
269 </note>
270
271 <para>
272 Fix a hard coded path to Python 3 interpreter:
273 </para>
274
275<screen><userinput>sed '1s@^.*$@#!/usr/bin/python3@' \
276 -i ./bin/default/source4/scripting/bin/samba-gpupdate.inst</userinput></screen>
277
278 <para>
279 If upgrading from an old version of samba, as the
280 <systemitem class="username">root</systemitem> user, remove the old
281 Python support files to prevent some issues:
282 </para>
283
284<screen role="root"><userinput>rm -rf /usr/lib/python&python3-majorver;/site-packages/samba</userinput></screen>
285
286 <para>
287 Still as the <systemitem class="username">root</systemitem> user,
288 install the package:
289 </para>
290
291<screen role="root"><userinput>make install &amp;&amp;
292
293install -v -m644 examples/smb.conf.default /etc/samba &amp;&amp;
294
295sed -e "s;log file =.*;log file = /var/log/samba/%m.log;" \
296 -e "s;path = /usr/spool/samba;path = /var/spool/samba;" \
297 -i /etc/samba/smb.conf.default &amp;&amp;
298
299mkdir -pv /etc/openldap/schema &amp;&amp;
300
301install -v -m644 examples/LDAP/README \
302 /etc/openldap/schema/README.LDAP &amp;&amp;
303
304install -v -m644 examples/LDAP/samba* \
305 /etc/openldap/schema &amp;&amp;
306
307install -v -m755 examples/LDAP/{get*,ol*} \
308 /etc/openldap/schema</userinput></screen>
309
310 </sect2>
311
312 <sect2 role="commands">
313 <title>Command Explanations</title>
314
315 <para>
316 <parameter>--enable-fhs</parameter>: Assigns all other file paths in
317 a manner compliant with the Filesystem Hierarchy Standard (FHS).
318 </para>
319
320 <para revision="sysv">
321 <parameter>--without-systemd</parameter>: Disable
322 <application>systemd</application> integration, since it is not built
323 in the System V version of LFS/BLFS.
324 </para>
325
326 <para>
327 <parameter>--without-ad-dc</parameter>: Disables
328 Active Directory Domain Controller functionality. See <ulink url=
329 "https://wiki.samba.org/index.php/Setup_a_Samba_Active_Directory_Domain_Controller">
330 Setup a Samba Active Directory Domain Controller</ulink> for detailed
331 information. Remove this switch if you've installed the Python modules
332 needed for ADS support. Note that BLFS does not provide a samba bootscript
333 or systemd unit for an Active Directory domain controller.
334 </para>
335
336 <para>
337 <option>--with-selftest-prefix=SELFTEST_PREFIX</option>: This option
338 specifies the test suite work directory (default=./st).
339 </para>
340
341<!-- FIXME removed during merged-/usr transition.
342 <para>
343 <command>mv -v /usr/lib/libnss_win{s,bind}.so* /lib</command>:
344 The nss libraries are installed in
345 <filename class="directory">/usr/lib</filename> by default. Move them to
346 <filename class="directory">/lib</filename>.
347 </para>
348
349 <para>
350 <command>ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so</command>
351 and <command>ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so</command>:
352 These symlinks are required when applications build against these
353 libraries.
354 </para>
355-->
356
357 <para>
358 <command>install -v -m644 examples/LDAP/* /etc/openldap/schema</command>:
359 These commands are used to copy sample Samba schemas to the OpenLDAP
360 <filename class='directory'>schema</filename> directory.
361 </para>
362
363 <para>
364 <command>install -v -m644 ../examples/smb.conf.default
365 /etc/samba</command>: This copies a default <filename>smb.conf</filename>
366 file into <filename>/etc/samba</filename>. This sample configuration will
367 not work until you copy it to <filename>/etc/samba/smb.conf</filename> and
368 make the appropriate changes for your installation. See the configuration
369 section for minimum values which must be set.
370 </para>
371
372 </sect2>
373
374 <sect2 role="configuration">
375 <title>Configuring Samba</title>
376
377 <sect3 id="samba-config">
378 <title>Config Files</title>
379
380 <para>
381 /etc/samba/smb.conf
382 </para>
383
384 <indexterm zone="samba samba-config">
385 <primary sortas="e-etc-samba-smb.conf">/etc/samba/smb.conf</primary>
386 </indexterm>
387
388 </sect3>
389
390 <sect3>
391 <title>Printing to SMB Clients</title>
392
393 <para>
394 If you use <application>CUPS</application> for print services, and you
395 wish to print to a printer attached to an SMB client, you need to
396 create an SMB backend device. To create the device, issue the following
397 command as the <systemitem class="username">root</systemitem> user:
398 </para>
399
400<screen role="root"><userinput>install -dvm 755 /usr/lib/cups/backend &amp;&amp;
401ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
402
403 </sect3>
404
405 <sect3>
406 <title>Configuration Information</title>
407
408 <para>
409 Due to the complexity and the many various uses for
410 <application>Samba</application>, complete configuration for all the
411 package's capabilities is well beyond the scope of the BLFS book. This
412 section provides instructions to configure the
413 <filename>/etc/samba/smb.conf</filename> file for two common scenarios.
414 The complete contents of <filename>/etc/samba/smb.conf</filename> will
415 depend on the purpose of <application>Samba</application>
416 installation.
417 </para>
418
419 <note>
420 <para>
421 You may find it easier to copy the configuration parameters shown
422 below into an empty <filename>/etc/samba/smb.conf</filename> file
423 instead of copying and editing the default file as mentioned in the
424 <quote>Command Explanations</quote> section. How you create/edit the
425 <filename>/etc/samba/smb.conf</filename> file will be left up to
426 you. Do ensure the file is only writeable by the
427 <systemitem class="username">root</systemitem> user (mode 644).
428 </para>
429 </note>
430
431 <sect4>
432 <title>Scenario 1: Minimal Standalone Client-Only Installation</title>
433
434 <para>
435 Choose this variant if you only want to transfer files using
436 <command>smbclient</command>, mount Windows shares and print to
437 Windows printers, and don't want to share your files and printers to
438 Windows machines.
439 </para>
440
441 <para>
442 A <filename>/etc/samba/smb.conf</filename> file with the following
443 three parameters is sufficient:
444 </para>
445
446<screen role='root'><literal>[global]
447 workgroup = <replaceable>WORKGROUP</replaceable>
448 dos charset = <replaceable>cp850</replaceable>
449 unix charset = <replaceable>ISO-8859-1</replaceable></literal></screen>
450
451 <para>
452 The values in this example specify that the computer belongs to a
453 Windows workgroup named
454 <quote><replaceable>WORKGROUP</replaceable></quote>, uses the
455 <quote><replaceable>cp850</replaceable></quote> character set on the
456 wire when talking to MS-DOS and MS Windows 9x, and that the filenames
457 are stored in the <quote><replaceable>ISO-8859-1</replaceable></quote>
458 encoding on the disk. Adjust these values appropriately for your
459 installation. The <quote>unix charset</quote> value must be the same
460 as the output of <command>locale charmap</command> when executed with
461 the <envar>LANG</envar> variable set to your preferred locale,
462 otherwise the <command>ls</command> command may not display correct
463 filenames of downloaded files.
464 </para>
465
466 <para>
467 There is no need to run any <application>Samba</application>
468 servers in this scenario, thus you don't need to install the provided
469 <phrase revision="sysv">bootscripts.</phrase>
470 <phrase revision="systemd">systemd units.</phrase>
471 </para>
472
473 </sect4>
474
475 <sect4>
476 <title>Scenario 2: Standalone File/Print Server</title>
477
478 <para>
479 Choose this variant if you want to share your files and printers
480 to Windows machines in your workgroup in addition to the capabilities
481 described in Scenario 1.
482 </para>
483
484 <para>
485 In this case, the <filename>/etc/samba/smb.conf.default</filename>
486 file may be a good template to start from. Also, you should add the
487 <quote>dos charset</quote> and <quote>unix charset</quote> parameters
488 to the <quote>[global]</quote> section as described in Scenario 1 in
489 order to prevent filename corruption. For security reasons, you may
490 wish to define
491 <replaceable>path = /home/alice/shared-files</replaceable>,
492 assuming your user name is <replaceable>alice</replaceable> and you
493 only want to share the files in that directory, instead of your entire
494 home. Then, replace <replaceable>homes</replaceable> by
495 <replaceable>shared-files</replaceable> and change also the
496 <quote><literal>comment</literal></quote> if used the configuration
497 file below or the <filename>/etc/samba/smb.conf.default</filename>
498 to create yours.
499 </para>
500
501 <para>
502 The following configuration file creates a separate share for each
503 user's home directory and also makes all printers available to Windows
504 machines:
505 </para>
506
507<screen role='root'><literal>[global]
508 workgroup = <replaceable>WORKGROUP</replaceable>
509 dos charset = <replaceable>cp850</replaceable>
510 unix charset = <replaceable>ISO-8859-1</replaceable>
511
512[homes]
513 comment = Home Directories
514 browseable = no
515 writable = yes
516
517[printers]
518 comment = All Printers
519 path = /var/spool/samba
520 browseable = no
521 guest ok = no
522 printable = yes</literal></screen>
523
524 <para>
525 Other parameters you may wish to customize in the
526 <quote>[global]</quote> section include:
527 </para>
528
529<screen role='root'><literal> server string =
530 security =
531 hosts allow =
532 load printers =
533 log file =
534 max log size =
535 socket options =
536 local master =</literal></screen>
537
538 <para>
539 Reference the comments in the
540 <filename>/etc/samba/smb.conf.default</filename> file for information
541 regarding these parameters.
542 </para>
543
544 <para>
545 Since the <command>smbd</command> and <command>nmbd</command> daemons
546 are needed in this case, install the <filename>samba</filename>
547 <phrase revision="sysv">bootscript.</phrase>
548 <phrase revision="systemd">systemd unit.</phrase>
549 Be sure to run <command>smbpasswd</command> (with the
550 <option>-a</option> option to add users) to enable and set passwords
551 for all accounts that need <application>Samba</application> access.
552 Using the default <application>Samba</application> passdb backend,
553 any user you attempt to add will also be required to exist in the
554 <filename>/etc/passwd</filename> file.
555 </para>
556
557 </sect4>
558
559 <sect4>
560 <title>Advanced Requirements</title>
561
562 <para>
563 More complex scenarios involving domain control or membership are
564 possible. Such setups are advanced topics and cannot be adequately
565 covered in BLFS. Many complete books have been written on these topics
566 alone. Note that in some domain membership scenarios, the
567 <command>winbindd</command> daemon and the corresponding
568 <phrase revision="sysv">bootscript</phrase>
569 <phrase revision="systemd">systemd unit</phrase> are needed.
570 </para>
571
572 <!-- All of these docs are years out of date. These were written for Samba 3,
573 and still mention Windows XP Professional as the current OS, dating them
574 back to before 2006 (When Windows Vista Business was released).
575 <para>
576 There is quite a bit of documentation available which covers many
577 of these advanced configurations. Point your web browser to the links
578 below to view some of the documentation included with the
579 <application>Samba</application> package:
580 </para>
581
582 <itemizedlist spacing='compact'>
583 <listitem>
584 <para>
585 Using Samba, 2nd Edition; a popular book published by O'Reilly
586 <ulink url=
587 "http://www.samba.org/samba/docs/using_samba/toc.html"/>
588 </para>
589 </listitem>
590 <listitem>
591 <para>
592 The Official Samba HOWTO and Reference Guide <ulink url=
593 "http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/"/>
594 </para>
595 </listitem>
596 <listitem>
597 <para>
598 Samba-3 by Example
599 <ulink url="http://www.samba.org/samba/docs/man/Samba-Guide/"/>
600 </para>
601 </listitem>
602 </itemizedlist>
603 -->
604 </sect4>
605
606 <sect4>
607 <title>Guest account</title>
608
609 <para>
610 The default <application>Samba</application> installation uses the
611 <systemitem class='username'>nobody</systemitem> user for guest
612 access to the server. This can be overridden by setting the
613 <option>guest account =</option> parameter in the
614 <filename>/etc/samba/smb.conf</filename> file. If you utilize the
615 <option>guest account =</option> parameter, ensure this user exists
616 in the <filename>/etc/passwd</filename> file.
617 </para>
618
619 </sect4>
620
621 <sect4 id="samba-init" revision="sysv">
622 <title>Boot Script</title>
623
624 <para>
625 For your convenience, boot scripts have been provided for
626 <application>Samba</application>. There are two included in the
627 <xref linkend="bootscripts"/> package. The first,
628 <filename>samba</filename>, will start the <command>smbd</command>
629 and <command>nmbd</command> daemons needed to provide SMB/CIFS
630 services. The second script, <filename>winbind</filename>, starts
631 the <command>winbindd</command> daemon, used for providing Windows
632 domain services to Linux clients.
633 </para>
634
635 <indexterm zone="samba samba-init">
636 <primary sortas="f-samba">samba</primary>
637 </indexterm>
638
639 <indexterm zone="samba samba-init">
640 <primary sortas="f-winbind">winbind</primary>
641 </indexterm>
642
643<screen role="root"><userinput>make install-samba</userinput></screen>
644
645<screen role="root"><userinput>make install-winbindd</userinput></screen>
646
647 </sect4>
648
649 <sect4 id="samba-init-sysd" revision="systemd">
650 <title>Systemd Units</title>
651
652 <para>
653 To start the <application>Samba</application> daemons at boot,
654 install the systemd units from the <xref linkend="systemd-units"/>
655 package by running the following command as the
656 <systemitem class="username">root</systemitem> user:
657 </para>
658
659 <indexterm zone="samba samba-init-sysd">
660 <primary sortas="f-samba">samba</primary>
661 </indexterm>
662
663<screen role="root"><userinput>make install-samba</userinput></screen>
664
665 <para>
666 To start the <command>winbindd</command> daemon at boot,
667 install the systemd unit from the <xref linkend="systemd-units"/>
668 package by running the following command as the
669 <systemitem class="username">root</systemitem> user:
670 </para>
671
672 <indexterm zone="samba samba-init-sysd">
673 <primary sortas="f-winbindd">winbindd</primary>
674 </indexterm>
675
676<screen role="root"><userinput>make install-winbindd</userinput></screen>
677
678 <note>
679 <para>
680 This package comes with two types of units: A service file and a
681 socket file. The service file will start the smbd daemon once at
682 boot and it will keep running until the system shuts down. The
683 socket file will make systemd listen on the smbd port (Default 445,
684 needs to be edited for anything else) and will start the smbd
685 daemon when something tries to connect to that port and stop the
686 daemon when the connection is terminated. This is called socket
687 activation and is analogous to using
688 <application>{,x}inetd</application> on a SysVinit based system.
689 </para>
690
691 <para>
692 By default, the first method is used - the smbd daemon is started
693 at boot and stopped at shutdown. If the socket method is desired,
694 you need to run the following commands as the <systemitem
695 class="username">root</systemitem> user:
696 </para>
697
698<screen role="root"><userinput>systemctl stop smbd &amp;&amp;
699systemctl disable smbd &amp;&amp;
700systemctl enable smbd.socket &amp;&amp;
701systemctl start smbd.socket</userinput></screen>
702
703 <para>
704 Note that only the smbd daemon can be socket activated.
705 </para>
706 </note>
707 </sect4>
708
709 </sect3>
710
711 </sect2>
712
713 <sect2 role="content">
714 <title>Contents</title>
715
716 <segmentedlist>
717 <segtitle>Installed Programs</segtitle>
718 <segtitle>Installed Libraries</segtitle>
719 <segtitle>Installed Directories</segtitle>
720
721 <seglistitem>
722
723 <seg>
724 cifsdd, dbwrap_tool, dumpmscat, eventlogadm, gentest,
725 ldbadd, ldbdel, ldbedit, ldbmodify, ldbrename, ldbsearch, locktest,
726 masktest, mdsearch, mvxattr, ndrdump, net, nmbd, nmblookup, ntlm_auth,
727 oLschema2ldif, pdbedit, profiles, regdiff, regpatch, regshell,
728 regtree, rpcclient, samba (in /usr/libexec), samba-gpupdate,
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/libexec/samba, /usr/{lib,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 <varlistentry id="samba-prog">
1113 <term><command>samba</command></term>
1114 <listitem>
1115 <para>
1116 is a server to provide AD and SMB/CIFS services
1117 to clients
1118 </para>
1119 <indexterm zone="samba samba-prog">
1120 <primary sortas="b-samba-prog">samba</primary>
1121 </indexterm>
1122 </listitem>
1123 </varlistentry>
1124
1125 <varlistentry id="samba-gpupdate">
1126 <term><command>samba-gpupdate</command></term>
1127 <listitem>
1128 <para>
1129 allows you to edit Microsoft Group Policy Objects (GPOs)
1130 </para>
1131 <indexterm zone="samba samba-gpupdate">
1132 <primary sortas="b-samba-gpupdate">samba-gpupdate</primary>
1133 </indexterm>
1134 </listitem>
1135 </varlistentry>
1136
1137 <varlistentry id="samba-regedit">
1138 <term><command>samba-regedit</command></term>
1139 <listitem>
1140 <para>
1141 is a ncurses based tool to manage the Samba registry
1142 </para>
1143 <indexterm zone="samba samba-regedit">
1144 <primary sortas="b-samba-regedit">samba-regedit</primary>
1145 </indexterm>
1146 </listitem>
1147 </varlistentry>
1148
1149 <varlistentry id="samba-tool">
1150 <term><command>samba-tool</command></term>
1151 <listitem>
1152 <para>
1153 is the main Samba administration tool
1154 </para>
1155 <indexterm zone="samba samba-tool">
1156 <primary sortas="b-samba-tool">samba-tool</primary>
1157 </indexterm>
1158 </listitem>
1159 </varlistentry>
1160
1161 <varlistentry id="sharesec">
1162 <term><command>sharesec</command></term>
1163 <listitem>
1164 <para>
1165 manipulates share ACL permissions on SMB file shares
1166 </para>
1167 <indexterm zone="samba sharesec">
1168 <primary sortas="b-sharesec">sharesec</primary>
1169 </indexterm>
1170 </listitem>
1171 </varlistentry>
1172
1173 <varlistentry id="smbcacls">
1174 <term><command>smbcacls</command></term>
1175 <listitem>
1176 <para>
1177 is used to manipulate Windows NT access control lists
1178 </para>
1179 <indexterm zone="samba smbcacls">
1180 <primary sortas="b-smbcacls">smbcacls</primary>
1181 </indexterm>
1182 </listitem>
1183 </varlistentry>
1184
1185 <varlistentry id="smbclient">
1186 <term><command>smbclient</command></term>
1187 <listitem>
1188 <para>
1189 is a SMB/CIFS access utility, similar to FTP
1190 </para>
1191 <indexterm zone="samba smbclient">
1192 <primary sortas="b-smbclient">smbclient</primary>
1193 </indexterm>
1194 </listitem>
1195 </varlistentry>
1196
1197 <varlistentry id="smbcontrol">
1198 <term><command>smbcontrol</command></term>
1199 <listitem>
1200 <para>
1201 is used to control running <command>smbd</command>,
1202 <command>nmbd</command> and <command>winbindd</command> daemons
1203 </para>
1204 <indexterm zone="samba smbcontrol">
1205 <primary sortas="b-smbcontrol">smbcontrol</primary>
1206 </indexterm>
1207 </listitem>
1208 </varlistentry>
1209
1210 <varlistentry id="smbcquotas">
1211 <term><command>smbcquotas</command></term>
1212 <listitem>
1213 <para>
1214 is used to manipulate Windows NT quotas on SMB file shares
1215 </para>
1216 <indexterm zone="samba smbcquotas">
1217 <primary sortas="b-smbcquotas">smbcquotas</primary>
1218 </indexterm>
1219 </listitem>
1220 </varlistentry>
1221
1222 <varlistentry id="smbd">
1223 <term><command>smbd</command></term>
1224 <listitem>
1225 <para>
1226 is the main <application>Samba</application> daemon which
1227 provides SMB/CIFS services to clients
1228 </para>
1229 <indexterm zone="samba smbd">
1230 <primary sortas="b-smbd">smbd</primary>
1231 </indexterm>
1232 </listitem>
1233 </varlistentry>
1234
1235 <varlistentry id="smbget">
1236 <term><command>smbget</command></term>
1237 <listitem>
1238 <para>
1239 is a simple utility with <command>wget</command>-like semantics,
1240 that can download files from SMB servers. You can specify the
1241 files you would like to download on the command-line
1242 </para>
1243 <indexterm zone="samba smbget">
1244 <primary sortas="b-smbget">smbget</primary>
1245 </indexterm>
1246 </listitem>
1247 </varlistentry>
1248
1249 <varlistentry id="smbpasswd">
1250 <term><command>smbpasswd</command></term>
1251 <listitem>
1252 <para>
1253 changes a user's <application>Samba</application> password
1254 </para>
1255 <indexterm zone="samba smbpasswd">
1256 <primary sortas="b-smbpasswd">smbpasswd</primary>
1257 </indexterm>
1258 </listitem>
1259 </varlistentry>
1260
1261 <varlistentry id="smbspool">
1262 <term><command>smbspool</command></term>
1263 <listitem>
1264 <para>
1265 sends a print job to an SMB printer
1266 </para>
1267 <indexterm zone="samba smbspool">
1268 <primary sortas="b-smbspool">smbspool</primary>
1269 </indexterm>
1270 </listitem>
1271 </varlistentry>
1272
1273 <varlistentry id="smbstatus">
1274 <term><command>smbstatus</command></term>
1275 <listitem>
1276 <para>
1277 reports current <application>Samba</application> connections
1278 </para>
1279 <indexterm zone="samba smbstatus">
1280 <primary sortas="b-smbstatus">smbstatus</primary>
1281 </indexterm>
1282 </listitem>
1283 </varlistentry>
1284
1285 <varlistentry id="smbtar">
1286 <term><command>smbtar</command></term>
1287 <listitem>
1288 <para>
1289 is a shell script used for backing up SMB/CIFS shares
1290 directly to Linux tape drives or a file
1291 </para>
1292 <indexterm zone="samba smbtar">
1293 <primary sortas="b-smbtar">smbtar</primary>
1294 </indexterm>
1295 </listitem>
1296 </varlistentry>
1297
1298 <varlistentry id="smbtorture">
1299 <term><command>smbtorture</command></term>
1300 <listitem>
1301 <para>
1302 is a testsuite that runs several tests against a SMB server
1303 </para>
1304 <indexterm zone="samba smbtorture">
1305 <primary sortas="b-smbtorture">smbtorture</primary>
1306 </indexterm>
1307 </listitem>
1308 </varlistentry>
1309
1310 <varlistentry id="smbtree">
1311 <term><command>smbtree</command></term>
1312 <listitem>
1313 <para>
1314 is a text-based SMB network browser
1315 </para>
1316 <indexterm zone="samba smbtree">
1317 <primary sortas="b-smbtree">smbtree</primary>
1318 </indexterm>
1319 </listitem>
1320 </varlistentry>
1321
1322 <varlistentry id="tdbbackup">
1323 <term><command>tdbbackup</command></term>
1324 <listitem>
1325 <para>
1326 is a tool for backing up or validating the integrity of
1327 <application>Samba</application> <filename>.tdb</filename> files
1328 </para>
1329 <indexterm zone="samba tdbbackup">
1330 <primary sortas="b-tdbbackup">tdbbackup</primary>
1331 </indexterm>
1332 </listitem>
1333 </varlistentry>
1334
1335 <varlistentry id="tdbdump">
1336 <term><command>tdbdump</command></term>
1337 <listitem>
1338 <para>
1339 is a tool used to print the contents of a
1340 <application>Samba</application> <filename>.tdb</filename> file
1341 </para>
1342 <indexterm zone="samba tdbdump">
1343 <primary sortas="b-tdbdump">tdbdump</primary>
1344 </indexterm>
1345 </listitem>
1346 </varlistentry>
1347
1348 <varlistentry id="tdbrestore">
1349 <term><command>tdbrestore</command></term>
1350 <listitem>
1351 <para>
1352 is a tool for creating a <application>Samba</application>
1353 <filename>.tdb</filename> file out of a ntdbdump
1354 </para>
1355 <indexterm zone="samba tdbrestore">
1356 <primary sortas="b-tdbrestore">tdbrestore</primary>
1357 </indexterm>
1358 </listitem>
1359 </varlistentry>
1360
1361 <varlistentry id="tdbtool">
1362 <term><command>tdbtool</command></term>
1363 <listitem>
1364 <para>
1365 is a tool which allows simple database manipulation from the
1366 command line
1367 </para>
1368 <indexterm zone="samba tdbtool">
1369 <primary sortas="b-tdbtool">tdbtool</primary>
1370 </indexterm>
1371 </listitem>
1372 </varlistentry>
1373
1374 <varlistentry id="testparm">
1375 <term><command>testparm</command></term>
1376 <listitem>
1377 <para>
1378 checks an <filename>smb.conf</filename> file for proper syntax
1379 </para>
1380 <indexterm zone="samba testparm">
1381 <primary sortas="b-testparm">testparm</primary>
1382 </indexterm>
1383 </listitem>
1384 </varlistentry>
1385
1386 <varlistentry id="wbinfo">
1387 <term><command>wbinfo</command></term>
1388 <listitem>
1389 <para>
1390 queries a running <command>winbindd</command> daemon
1391 </para>
1392 <indexterm zone="samba wbinfo">
1393 <primary sortas="b-wbinfo">wbinfo</primary>
1394 </indexterm>
1395 </listitem>
1396 </varlistentry>
1397
1398 <varlistentry id="winbindd">
1399 <term><command>winbindd</command></term>
1400 <listitem>
1401 <para>
1402 resolves names from Windows NT servers
1403 </para>
1404 <indexterm zone="samba winbindd">
1405 <primary sortas="b-winbindd">winbindd</primary>
1406 </indexterm>
1407 </listitem>
1408 </varlistentry>
1409
1410 <varlistentry id="libnss_winbind">
1411 <term><filename class="libraryfile">libnss_winbind.so</filename></term>
1412 <listitem>
1413 <para>
1414 provides Name Service Switch API functions for resolving names
1415 from NT servers
1416 </para>
1417 <indexterm zone="samba libnss_winbind">
1418 <primary sortas="c-libnss_winbind">libnss_winbind.so</primary>
1419 </indexterm>
1420 </listitem>
1421 </varlistentry>
1422
1423 <varlistentry id="libnss_wins">
1424 <term><filename class="libraryfile">libnss_wins.so</filename></term>
1425 <listitem>
1426 <para>
1427 provides API functions for Samba's implementation of the
1428 Windows Internet Naming Service
1429 </para>
1430 <indexterm zone="samba libnss_wins">
1431 <primary sortas="c-libnss_wins">libnss_wins.so</primary>
1432 </indexterm>
1433 </listitem>
1434 </varlistentry>
1435
1436 <varlistentry id="libnetapi">
1437 <term><filename class="libraryfile">libnetapi.so</filename></term>
1438 <listitem>
1439 <para>
1440 provides API functions for the administration tools used
1441 for Samba and remote CIFS servers
1442 </para>
1443 <indexterm zone="samba libnetapi">
1444 <primary sortas="c-libnetapi">libnetapi.so</primary>
1445 </indexterm>
1446 </listitem>
1447 </varlistentry>
1448
1449 <varlistentry id="libsmbclient">
1450 <term><filename class="libraryfile">libsmbclient.so</filename></term>
1451 <listitem>
1452 <para>
1453 provides API functions for the Samba SMB client tools
1454 </para>
1455 <indexterm zone="samba libsmbclient">
1456 <primary sortas="c-libsmbclient">libsmbclient.so</primary>
1457 </indexterm>
1458 </listitem>
1459 </varlistentry>
1460<!--
1461 <varlistentry id="libsmbsharemodes">
1462 <term><filename class="libraryfile">libsmbsharemodes.so</filename></term>
1463 <listitem>
1464 <para>
1465 provides API functions for accessing SMB share modes (locks etc.)
1466 </para>
1467 <indexterm zone="samba libsmbsharemodes">
1468 <primary sortas="c-libsmbsharemodes">libsmbsharemodes.so</primary>
1469 </indexterm>
1470 </listitem>
1471 </varlistentry>-->
1472
1473 <varlistentry id="libwbclient">
1474 <term><filename class="libraryfile">libwbclient.so</filename></term>
1475 <listitem>
1476 <para>
1477 provides API functions for Windows domain client services
1478 </para>
1479 <indexterm zone="samba libwbclient">
1480 <primary sortas="c-libwbclient">libwbclient.so</primary>
1481 </indexterm>
1482 </listitem>
1483 </varlistentry>
1484
1485 </variablelist>
1486
1487 </sect2>
1488
1489</sect1>
Note: See TracBrowser for help on using the repository browser.