source: networking/netprogs/samba.xml@ 17aa21c

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since 17aa21c was 3bdc4eb, checked in by Pierre Labastie <pierre.labastie@…>, 16 months ago

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