source: networking/netprogs/samba.xml@ 75e3e09

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 75e3e09 was 75e3e09, checked in by Xi Ruoyao <xry111@…>, 20 months ago

networking: URL update

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