source: networking/netprogs/samba.xml@ 4586f00

trunk
Last change on this file since 4586f00 was 4586f00, checked in by Xi Ruoyao <xry111@…>, 2 months ago

samba: stop to move libs into /lib (merged /usr)

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