source: networking/netprogs/samba.xml@ 8b819c5

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

Reference book's pytest instead of external

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