source: networking/netprogs/samba.xml@ 94bdff09

trunk
Last change on this file since 94bdff09 was 94bdff09, checked in by Douglas R. Reno <renodr@…>, 3 months ago

Update to samba-4.14.4 (security update)
Update to fetchmail-6.4.19
Update to apache-ant-1.10.10
Updaet to fuse-3.10.3

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