source: networking/netprogs/samba.xml@ ca783379

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 xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since ca783379 was 831c4508, checked in by Douglas R. Reno <renodr@…>, 2 years ago

Package Update:

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