source: networking/netprogs/samba.xml@ 29e27d02

11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 29e27d02 was dcf242f, checked in by Douglas R. Reno <renodr@…>, 3 years ago

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