source: networking/netprogs/samba.xml@ 71d2d759

lazarus qt5new trunk upgradedb
Last change on this file since 71d2d759 was 71d2d759, checked in by Douglas R. Reno <renodr@…>, 3 months ago

Package Update:

Update to samba-4.15.1 (Security Update)

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