source: networking/netprogs/samba.xml@ 8761710

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 8761710 was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 19 months ago

Remove sect1info tags

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