source: networking/netprogs/samba.xml@ 7a9a7b26

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

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