source: networking/netprogs/samba.xml@ 45ab6c7

trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 4 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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