source: networking/netprogs/samba.xml@ 60d4af1

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt perl-modules 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 60d4af1 was 60d4af1, checked in by Douglas R. Reno <renodr@…>, 7 years ago

Update to NSS-3.28
Update to Samba-4.5.3
Fix something in the xfsprogs page
Comment out the test suite in Samba until I can add the Python Modules required

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@18113 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 47.2 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://download.samba.org/pub/samba/stable/samba-&samba-version;.tar.gz">
8 <!ENTITY samba-download-ftp " ">
9 <!ENTITY samba-md5sum "6f30eed6dfbd036dfde023e03ed8b311">
10 <!ENTITY samba-size "20 MB">
11 <!ENTITY samba-buildsize "509 MB (add 382 MB for quicktest, and up to 1.6 GB additional for all tests)">
12 <!ENTITY samba-time "5.2 SBU, using parallelism=4 (add 6.0 SBU for quicktest, and up to 218 SBU to run all tests)">
13]>
14
15<sect1 id="samba" xreflabel="Samba-&samba-version;">
16 <?dbhtml filename="samba.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Samba-&samba-version;</title>
24
25 <indexterm zone="samba">
26 <primary sortas="a-Samba">Samba</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Samba</title>
31
32 <para>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 Domain
35 Controller replacement, a file/print server acting as a member of a Windows
36 Active Directory domain and a NetBIOS (rfc1001/1002) nameserver (which
37 among other things provides LAN browsing support).</para>
38
39 &lfs7a_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>Download (HTTP): <ulink url="&samba-download-http;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download (FTP): <ulink url="&samba-download-ftp;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download MD5 sum: &samba-md5sum;</para>
51 </listitem>
52 <listitem>
53 <para>Download size: &samba-size;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated disk space required: &samba-buildsize;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated build time: &samba-time;</para>
60 </listitem>
61 </itemizedlist>
62
63 <bridgehead renderas="sect3">Samba Dependencies</bridgehead>
64
65 <bridgehead renderas="sect4">Required</bridgehead>
66 <para role="required">
67 <xref linkend="python2"/>
68 </para>
69
70 <bridgehead renderas="sect4">Recommended</bridgehead>
71 <para role="recommended">
72 <xref linkend="gpgme"/>,
73 <xref linkend="libtirpc"/>,
74 <xref linkend="libxslt"/> (for documentation),
75 <xref linkend="perl-parse-yapp"/>, and
76 <xref linkend="openldap"/>
77 </para>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <xref linkend="avahi"/>,
82 <xref linkend="cups"/>,
83 <xref linkend="cyrus-sasl"/>,
84 <xref linkend="gdb"/>,
85 <xref linkend="git"/>,
86 <xref linkend="gnutls"/>,
87 <xref linkend="libarchive"/>,
88 <xref linkend="libcap-pam"/>,
89 <xref linkend="libgcrypt"/>,
90 <xref linkend="linux-pam"/>,
91 <xref linkend="mitkrb"/>,
92 <xref linkend="nss"/>,
93 <xref linkend="popt"/>,
94 <xref linkend="python3"/>,
95 <!-- <xref linkend="python-cryptography"/>, -->
96 <!-- <xref linkend="m2crypto"/>, -->
97 <!-- <xref linkend="python-gpgme"/>, -->
98 <xref linkend="talloc"/>,
99 <xref linkend="vala"/>,
100 <xref linkend="valgrind"/> (optionally used by the test suite),
101 <xref linkend="xfsprogs"/>,
102 <ulink url="https://ctdb.samba.org/">ctdb</ulink>,
103 <ulink url="https://people.gnome.org/~veillard/gamin/">Gamin</ulink>,
104 <ulink url="http://www.h5l.org/">Heimdal</ulink>,
105 <ulink url="http://ftp.de.debian.org/debian/pool/main/liba/libaio/">libaio</ulink>,
106 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>,
107 <ulink url="https://www.samba.org/ftp/ldb/">ldb</ulink>,
108 <ulink url="http://www.openafs.org/">OpenAFS</ulink>,
109 <ulink url="https://tevent.samba.org/">tevent</ulink>, and
110 <ulink url="https://tdb.samba.org/">tdb</ulink>
111 </para>
112
113 <para condition="html" role="usernotes">User Notes:
114 <ulink url="&blfs-wiki;/samba4"/></para>
115
116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of Samba</title>
120
121 <note>
122 <para>If you wish to run the test suite after the binaries are built, you
123 must add the <option>--enable-selftest</option> parameter to the
124 <command>configure</command> script below. You may want to run
125 <command>configure</command> with the <option>--help</option> parameter
126 first. There may be other parameters needed to take advantage of optional
127 dependencies.</para>
128 </note>
129
130 <para>Install <application>Samba</application> by running the following
131 commands:</para>
132
133<screen revision="sysv"><userinput>./configure \
134 --prefix=/usr \
135 --sysconfdir=/etc \
136 --localstatedir=/var \
137 --with-piddir=/run/samba \
138 --with-pammodulesdir=/lib/security \
139 --enable-fhs \
140 --without-ad-dc \
141 --without-systemd &amp;&amp;
142make</userinput></screen>
143
144<screen revision="systemd"><userinput>./configure \
145 --prefix=/usr \
146 --sysconfdir=/etc \
147 --localstatedir=/var \
148 --with-piddir=/run/samba \
149 --with-pammodulesdir=/lib/security \
150 --enable-fhs &amp;&amp;
151make</userinput></screen>
152
153<!--
154 <para>According to <application>Samba</application> developers, the
155 limitation to 108 characters of the path length of a unix named pipe socket
156 may be the cause of errors, so that over 1/3 of the tests might fail. For
157 this reason, the switch <option>- -with-selftest-prefix=/tmp/quick</option>
158 (or another path with small number of characters) can be used with
159 configure. Even so, the
160 <quote><replaceable>samba3.raw.eas</replaceable></quote> test may fail,
161 apparently for the same reason. If one quicktest fails, it can be disabled.
162 For example, <quote><replaceable>samba3.raw.eas</replaceable></quote> may
163 be disabled with the following command:</para>
164
165<screen><userinput>sed -i "/samba3.blackbox.failure.failure/i \^samba3.raw.eas" selftest/knownfail</userinput></screen>
166-->
167
168<!-- Commented out until I figure the Python Module situation out.
169 <para>To test the results, as the
170 <systemitem class="username">root</systemitem> user, issue:
171 <command>make quicktest 2>&amp;1 | tee quicktest.log</command>. A summary of
172 the test results and some other information may be obtained with
173 <command>grep -A5 testsuites quicktest.log</command>. There are other
174 targets (test, subunit-test) available, but take a very long time
175 (over 100 SBU).</para>
176-->
177
178 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
179
180<screen role="root"><userinput>make install &amp;&amp;
181
182mv -v /usr/lib/libnss_win{s,bind}.so* /lib &amp;&amp;
183ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so &amp;&amp;
184ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so &amp;&amp;
185
186install -v -m644 examples/smb.conf.default /etc/samba &amp;&amp;
187
188mkdir -pv /etc/openldap/schema &amp;&amp;
189
190install -v -m644 examples/LDAP/README \
191 /etc/openldap/schema/README.LDAP &amp;&amp;
192
193install -v -m644 examples/LDAP/samba* \
194 /etc/openldap/schema &amp;&amp;
195
196install -v -m755 examples/LDAP/{get*,ol*} \
197 /etc/openldap/schema</userinput></screen>
198
199 </sect2>
200
201 <sect2 role="commands">
202 <title>Command Explanations</title>
203
204 <para><parameter>--enable-fhs</parameter>: Assigns all other file paths in
205 a manner compliant with the Filesystem Hierarchy Standard (FHS).</para>
206
207 <para revision="sysv"><parameter>--without-systemd</parameter>: Disable
208 <application>systemd</application> integration, since it is not built
209 in the SYS V version of LFS/BLFS.</para>
210
211 <para revision="sysv"><parameter>--without-ad-dc</parameter>: Disable
212 Active Directory Domain Controller functionality. See <ulink
213 url="https://wiki.samba.org/index.php/Setup_a_Samba_Active_Directory_Domain_Controller">
214 Setup a Samba Active Directory Domain Controller</ulink> for detailed
215 information.</para>
216
217 <para><option>--with-selftest-prefix=SELFTEST_PREFIX</option>: This option
218 specifies the test suite work directory (default=./st).</para>
219
220 <para><command>mv -v /usr/lib/libnss_win{s,bind}.so* /lib</command>:
221 The nss libraries are installed in /usr/lib by default. Move them to
222 /lib.</para>
223
224 <para><command>ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so</command>
225 and <command>ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so</command>:
226 These symlinks are required when applications build against these
227 libraries.</para>
228
229 <para><command>install -v -m644 examples/LDAP/* /etc/openldap/schema</command>:
230 These commands are used to copy sample Samba schemas to the OpenLDAP
231 <filename class='directory'>schema</filename> directory.</para>
232
233 <para><command>install -v -m644 ../examples/smb.conf.default
234 /etc/samba</command>: This copies a default <filename>smb.conf</filename>
235 file into <filename>/etc/samba</filename>. This sample configuration will
236 not work until you copy it to <filename>/etc/samba/smb.conf</filename> and
237 make the appropriate changes for your installation. See the configuration
238 section for minimum values which must be set.</para>
239
240 </sect2>
241
242 <sect2 role="configuration">
243 <title>Configuring Samba</title>
244
245 <sect3 id="samba-config">
246 <title>Config Files</title>
247
248 <para>/etc/samba/smb.conf</para>
249
250 <indexterm zone="samba samba-config">
251 <primary sortas="e-etc-samba-smb.conf">/etc/samba/smb.conf</primary>
252 </indexterm>
253
254 </sect3>
255
256 <sect3>
257 <title>Printing to SMB Clients</title>
258
259 <para>If you use <application>CUPS</application> for print services,
260 and you wish to print to a printer attached to an SMB client, you
261 need to create an SMB backend device. To create the device, issue the
262 following command as the <systemitem class="username">root</systemitem>
263 user:</para>
264
265<screen role="root"><userinput>ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
266
267 </sect3>
268
269 <sect3>
270 <title>Configuration Information</title>
271
272 <para>Due to the complexity and the many various uses for
273 <application>Samba</application>, complete configuration for all the
274 package's capabilities is well beyond the scope of the BLFS book. This
275 section provides instructions to configure the
276 <filename>/etc/samba/smb.conf</filename> file for two common scenarios.
277 The complete contents of <filename>/etc/samba/smb.conf</filename> will
278 depend on the purpose of <application>Samba</application>
279 installation.</para>
280
281 <note>
282 <para>You may find it easier to copy the configuration parameters shown
283 below into an empty <filename>/etc/samba/smb.conf</filename> file
284 instead of copying and editing the default file as mentioned in the
285 <quote>Command Explanations</quote> section. How you create/edit the
286 <filename>/etc/samba/smb.conf</filename> file will be left up to
287 you. Do ensure the file is only writeable by the
288 <systemitem class="username">root</systemitem> user (mode 644).</para>
289 </note>
290
291 <sect4>
292 <title>Scenario 1: Minimal Standalone Client-Only Installation</title>
293
294 <para>Choose this variant if you only want to transfer files using
295 <command>smbclient</command>, mount Windows shares and print to Windows
296 printers, and don't want to share your files and printers to Windows
297 machines.</para>
298
299 <para>A <filename>/etc/samba/smb.conf</filename> file with the following
300 three parameters is sufficient:</para>
301
302<screen role='root'><literal>[global]
303 workgroup = <replaceable>MYGROUP</replaceable>
304 dos charset = <replaceable>cp850</replaceable>
305 unix charset = <replaceable>ISO-8859-1</replaceable></literal></screen>
306
307 <para>The values in this example specify that the computer belongs to a
308 Windows workgroup named
309 <quote><replaceable>MYGROUP</replaceable></quote>, uses the
310 <quote><replaceable>cp850</replaceable></quote> character set on the
311 wire when talking to MS-DOS and MS Windows 9x, and that the filenames
312 are stored in the <quote><replaceable>ISO-8859-1</replaceable></quote>
313 encoding on the disk. Adjust these values appropriately for your
314 installation. The <quote>unix charset</quote> value must be the same as
315 the output of <command>locale charmap</command> when executed with the
316 <envar>LANG</envar> variable set to your preferred locale, otherwise the
317 <command>ls</command> command may not display correct filenames of
318 downloaded files.</para>
319
320 <para>There is no need to run any <application>Samba</application>
321 servers in this scenario, thus you don't need to install the provided
322 bootscripts.</para>
323
324 </sect4>
325
326 <sect4>
327 <title>Scenario 2: Standalone File/Print Server</title>
328
329 <para>Choose this variant if you want to share your files and printers
330 to Windows machines in your workgroup in addition to the capabilities
331 described in Scenario 1.</para>
332
333 <para>In this case, the <filename>/etc/samba/smb.conf.default</filename>
334 file may be a good template to start from. Also add
335 <quote>dos charset</quote> and <quote>unix charset</quote> parameters
336 to the <quote>[global]</quote> section as described in Scenario 1 in
337 order to prevent filename corruption. For security reasons, you may
338 wish to define
339 <replaceable>path = /home/alice/shared-files</replaceable>,
340 assuming your user name is <replaceable>alice</replaceable> and you
341 only want to share the files in that directory, instead of your entire
342 home. Then, replace <replaceable>homes</replaceable> by
343 <replaceable>shared-files</replaceable> and change also the
344 <quote><literal>comment</literal></quote> if used the configuration
345 file below or the <filename>/etc/samba/smb.conf.default</filename>
346 to create yours.</para>
347
348 <para>The following configuration file creates a separate share for each
349 user's home directory and also makes all printers available to Windows
350 machines:</para>
351
352<screen role='root'><literal>[global]
353 workgroup = <replaceable>MYGROUP</replaceable>
354 dos charset = <replaceable>cp850</replaceable>
355 unix charset = <replaceable>ISO-8859-1</replaceable>
356
357[homes]
358 comment = Home Directories
359 browseable = no
360 writable = yes
361
362[printers]
363 comment = All Printers
364 path = /var/spool/samba
365 browseable = no
366 guest ok = no
367 printable = yes</literal></screen>
368
369 <para>Other parameters you may wish to customize in the
370 <quote>[global]</quote> section include:</para>
371
372<screen role='root'><literal> server string =
373 security =
374 hosts allow =
375 load printers =
376 log file =
377 max log size =
378 socket options =
379 local master =</literal></screen>
380
381 <para>Reference the comments in the
382 <filename>/etc/samba/smb.conf.default</filename> file for information
383 regarding these parameters.</para>
384
385 <para>Since the <command>smbd</command> and <command>nmbd</command>
386 daemons are needed in this case, install the <filename>samba</filename>
387 bootscript. Be sure to run <command>smbpasswd</command> (with the
388 <option>-a</option> option to add users) to enable and
389 set passwords for all accounts that need
390 <application>Samba</application> access. Using the default
391 <application>Samba</application> passdb backend, any user you attempt
392 to add will also be required to exist in the
393 <filename>/etc/passwd</filename> file.</para>
394
395 </sect4>
396
397 <sect4>
398 <title>Advanced Requirements</title>
399
400 <para>More complex scenarios involving domain control or membership are
401 possible. Such setups are advanced topics and cannot be adequately
402 covered in BLFS. Many complete books have been written on these topics
403 alone. Note that in some domain membership scenarios, the
404 <command>winbindd</command> daemon and the corresponding bootscript are
405 needed.</para>
406
407 <para>There is quite a bit of documentation available which covers many
408 of these advanced configurations. Point your web browser to the links
409 below to view some of the documentation included with the
410 <application>Samba</application> package:</para>
411
412 <itemizedlist spacing='compact'>
413 <listitem>
414 <para>Using Samba, 2nd Edition; a popular book published by O'Reilly
415 <ulink url="http://www.samba.org/samba/docs/using_samba/toc.html"/></para>
416 </listitem>
417 <listitem>
418 <para>The Official Samba HOWTO and Reference Guide <ulink
419 url="http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/"/>
420 </para>
421 </listitem>
422 <listitem>
423 <para>Samba-3 by Example
424 <ulink url="http://www.samba.org/samba/docs/man/Samba-Guide/"/>
425 </para>
426 </listitem>
427 </itemizedlist>
428
429 </sect4>
430
431 <sect4 id="samba-init" revision="sysv">
432 <title>Boot Script</title>
433
434 <para>For your convenience, boot scripts have been provided for
435 <application>Samba</application>. There are two included in the
436 <xref linkend="bootscripts"/> package. The first,
437 <filename>samba</filename>, will start the <command>smbd</command>
438 and <command>nmbd</command> daemons needed to provide SMB/CIFS
439 services. The second script, <filename>winbind</filename>, starts
440 the <command>winbindd</command> daemon, used for providing Windows
441 domain services to Linux clients.</para>
442
443 <indexterm zone="samba samba-init">
444 <primary sortas="f-samba">samba</primary>
445 </indexterm>
446
447 <indexterm zone="samba samba-init">
448 <primary sortas="f-winbind">winbind</primary>
449 </indexterm>
450
451 <para>The default <application>Samba</application> installation uses the
452 <systemitem class='username'>nobody</systemitem> user for guest access
453 to the server. This can be overridden by setting the
454 <option>guest account =</option> parameter in the
455 <filename>/etc/samba/smb.conf</filename> file. If you utilize the
456 <option>guest account =</option> parameter, ensure this user exists in
457 the <filename>/etc/passwd</filename> file. To use the default user,
458 issue the following commands as the
459 <systemitem class='username'>root</systemitem> user:</para>
460
461<screen role="root"><userinput>groupadd -g 99 nogroup &amp;&amp;
462useradd -c "Unprivileged Nobody" -d /dev/null -g nogroup \
463 -s /bin/false -u 99 nobody</userinput></screen>
464
465 <para>Install the <filename>samba</filename> script with the following
466 command issued as the <systemitem class="username">root</systemitem>
467 user:</para>
468
469<screen role="root"><userinput>make install-samba</userinput></screen>
470
471 <para>If you also need the <filename>winbindd</filename>
472 script to resolve names from Windows clients, run:</para>
473
474<screen role="root"><userinput>make install-winbindd</userinput></screen>
475
476 </sect4>
477
478 <sect4 id="samba-init-sysd" revision="systemd">
479 <title>Systemd Units</title>
480
481 <para>The default <application>Samba</application> installation uses the
482 <systemitem class='username'>nobody</systemitem> user for guest access
483 to the server. This can be overridden by setting the
484 <option>guest account =</option> parameter in the
485 <filename>/etc/samba/smb.conf</filename> file. If you utilize the
486 <option>guest account =</option> parameter, ensure this user exists in
487 the <filename>/etc/passwd</filename> file.</para>
488
489 <para>
490 To start the <application>Samba</application> daemons at boot,
491 install the systemd units from the <xref linkend="systemd-units"/>
492 package by running the following command as the
493 <systemitem class="username">root</systemitem> user:
494 </para>
495
496 <indexterm zone="samba samba-init-sysd">
497 <primary sortas="f-samba">samba</primary>
498 </indexterm>
499
500<screen role="root"><userinput>make install-samba</userinput></screen>
501
502 <para>
503 To start the <command>winbindd</command> daemon at boot,
504 install the systemd unit from the <xref linkend="systemd-units"/>
505 package by running the following command as the
506 <systemitem class="username">root</systemitem> user:
507 </para>
508
509 <indexterm zone="samba samba-init-sysd">
510 <primary sortas="f-winbindd">winbindd</primary>
511 </indexterm>
512
513<screen role="root"><userinput>make install-winbindd</userinput></screen>
514
515 <note>
516 <para>This package comes with two types of units: A service file and a
517 socket file. The service file will start the smbd daemon once at boot
518 and it will keep running until the system shuts down. The socket file
519 will make systemd listen on the smbd port (Default 445, needs to be
520 edited for anything else) and will start the smbd daemon when something
521 tries to connect to that port and stop the daemon when the connection
522 is terminated. This is called socket activation and is analogous to
523 using <application>{,x}inetd</application> on a SysVinit based
524 system.</para>
525
526 <para>By default, the first method is used - the smbd daemon is started
527 at boot and stopped at shutdown. If the socket method is desired, you
528 need to run the following commands as the
529 <systemitem class="username">root</systemitem> user:</para>
530
531<screen role="root"><userinput>systemctl stop smbd &amp;&amp;
532systemctl disable smbd &amp;&amp;
533systemctl enable smbd.socket &amp;&amp;
534systemctl start smbd.socket</userinput></screen>
535
536 <para>Note that only the smbd daemon can be socket activated.</para>
537 </note>
538 </sect4>
539
540 </sect3>
541
542 </sect2>
543
544 <sect2 role="content">
545 <title>Contents</title>
546
547 <segmentedlist>
548 <segtitle>Installed Programs</segtitle>
549 <segtitle>Installed Libraries</segtitle>
550 <segtitle>Installed Directories</segtitle>
551
552 <seglistitem>
553
554 <seg>
555 cifsdd, dbwrap_tool, eventlogadm, gentest, ldbadd, ldbdel,
556 ldbedit, ldbmodify, ldbrename, ldbsearch, locktest, masktest,
557 ndrdump, net, nmbd, nmblookup, ntlm_auth, oLschema2ldif,
558 pdbedit, pidl, profiles, regdiff, regpatch, regshell, regtree,
559 rpcclient, samba, samba_dnsupdate, samba_kcc, samba-regedit,
560 samba_spnupdate, samba-tool, samba_upgradedns, sharesec,
561 smbcacls, smbclient, smbcontrol, smbcquotas, smbd, smbget,
562 smbpasswd, smbspool, smbstatus, smbtar, <!-- smbta-util, -->
563 smbtorture, smbtree, tdbbackup, tdbdump, tdbrestore, tdbtool,
564 testparm, wbinfo, and winbindd
565 </seg>
566
567 <seg>
568 <!-- libdcerpc-atsvc.so, --> libdcerpc-binding.so, libdcerpc-samr.so,
569 libdcerpc-server.so, libdcerpc.so, <!-- libgensec.so, -->
570 libndr-krb5pac.so, libndr-nbt.so, libndr.so, libndr-standard.so,
571 libnetapi.so, libnss_winbind.so, libnss_wins.so,
572 <!-- libregistry.so, --> libsamba-credentials.so, libsamba-errors.so,
573 libsamba-hostconfig.so, libsamba-passdb.so,
574 libsamba-policy.so, libsamba-util.so, libsamdb.so,
575 <!-- libsmbclient-raw.so, --> libsmbclient.so, libsmbconf.so,
576 libsmbldap.so, libtevent-util.so,
577 <!-- libtevent-unix.so, libtorture.so, -->
578 libwbclient.so, <!--mit_samba.so,
579 --> and winbind_krb5_locator.so; the pam_winbind.so
580 <!-- pam_smbpass.so --> PAM library; and assorted character set,
581 filesystem and support modules under
582 /usr/lib/{python&python2-majorver;,samba}
583 </seg>
584
585 <seg>
586 /etc/samba, /run/samba, /usr/include/samba-4.0,
587 /usr/lib/perl5/vendor_perl/5.x.y/Parse/Pidl/{Samba{3,4},Wireshark},
588 /usr/lib/python&python2-majorver;/site-packages/samba,
589 /usr/{lib,share}/samba, and /var/{cache,lib,lock,log,run}/samba
590 </seg>
591
592 </seglistitem>
593 </segmentedlist>
594
595 <variablelist>
596 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
597 <?dbfo list-presentation="list"?>
598 <?dbhtml list-presentation="table"?>
599
600 <varlistentry id="cifsdd">
601 <term><command>cifsdd</command></term>
602 <listitem>
603 <para>is the dd command for SMB.</para>
604 <indexterm zone="samba cifsdd">
605 <primary sortas="b-cifsdd">cifsdd</primary>
606 </indexterm>
607 </listitem>
608 </varlistentry>
609
610 <varlistentry id="dbwrap_tool">
611 <term><command>dbwrap_tool</command></term>
612 <listitem>
613 <para>is used to read and manipulate TDB/CTDB databases using
614 the dbwrap interface.</para>
615 <indexterm zone="samba dbwrap_tool">
616 <primary sortas="b-dbwrap_tool">dbwrap_tool</primary>
617 </indexterm>
618 </listitem>
619 </varlistentry>
620
621 <varlistentry id="eventlogadm">
622 <term><command>eventlogadm</command></term>
623 <listitem>
624 <para>is used to write records to eventlogs from STDIN, add the
625 specified source and DLL eventlog registry entries and display the
626 active eventlog names (from <filename>smb.conf</filename>).</para>
627 <indexterm zone="samba eventlogadm">
628 <primary sortas="b-eventlogadm">eventlogadm</primary>
629 </indexterm>
630 </listitem>
631 </varlistentry>
632
633 <varlistentry id="gentest">
634 <term><command>gentest</command></term>
635 <listitem>
636 <para>is used to run random generic SMB operations against two
637 SMB servers and show the differences in behavior.</para>
638 <indexterm zone="samba gentest">
639 <primary sortas="b-gentest">gentest</primary>
640 </indexterm>
641 </listitem>
642 </varlistentry>
643
644 <varlistentry id="ldbadd">
645 <term><command>ldbadd</command></term>
646 <listitem>
647 <para>is a command-line utility for adding records to an LDB
648 database.</para>
649 <indexterm zone="samba ldbadd">
650 <primary sortas="b-ldbadd">ldbadd</primary>
651 </indexterm>
652 </listitem>
653 </varlistentry>
654
655 <varlistentry id="ldbdel">
656 <term><command>ldbdel</command></term>
657 <listitem>
658 <para>is a command-line program for deleting LDB database
659 records.</para>
660 <indexterm zone="samba ldbdel">
661 <primary sortas="b-ldbdel">ldbdel</primary>
662 </indexterm>
663 </listitem>
664 </varlistentry>
665
666 <varlistentry id="ldbedit">
667 <term><command>ldbedit</command></term>
668 <listitem>
669 <para>allows you to edit LDB databases using your preferred
670 editor.</para>
671 <indexterm zone="samba ldbedit">
672 <primary sortas="b-ldbedit">ldbedit</primary>
673 </indexterm>
674 </listitem>
675 </varlistentry>
676
677 <varlistentry id="ldbmodify">
678 <term><command>ldbmodify</command></term>
679 <listitem>
680 <para>allows you to modify records in an LDB database.</para>
681 <indexterm zone="samba ldbmodify">
682 <primary sortas="b-ldbmodify">ldbmodify</primary>
683 </indexterm>
684 </listitem>
685 </varlistentry>
686
687 <varlistentry id="ldbrename">
688 <term><command>ldbrename</command></term>
689 <listitem>
690 <para>allows you to edit LDB databases using your preferred
691 editor.</para>
692 <indexterm zone="samba ldbrename">
693 <primary sortas="b-ldbrename">ldbrename</primary>
694 </indexterm>
695 </listitem>
696 </varlistentry>
697
698 <varlistentry id="ldbsearch">
699 <term><command>ldbsearch</command></term>
700 <listitem>
701 <para>searches an LDB database for records matching a specified
702 expression.</para>
703 <indexterm zone="samba ldbsearch">
704 <primary sortas="b-ldbsearch">ldbsearch</primary>
705 </indexterm>
706 </listitem>
707 </varlistentry>
708
709 <varlistentry id="locktest">
710 <term><command>locktest</command></term>
711 <listitem>
712 <para>is used to find differences in locking between two SMB
713 servers.</para>
714 <indexterm zone="samba locktest">
715 <primary sortas="b-locktest">locktest</primary>
716 </indexterm>
717 </listitem>
718 </varlistentry>
719
720 <varlistentry id="masktest">
721 <term><command>masktest</command></term>
722 <listitem>
723 <para>is used to find differences in wildcard matching between
724 Samba's implementation and that of a remote server.</para>
725 <indexterm zone="samba masktest">
726 <primary sortas="b-masktest">masktest</primary>
727 </indexterm>
728 </listitem>
729 </varlistentry>
730
731 <varlistentry id="ndrdump">
732 <term><command>ndrdump</command></term>
733 <listitem>
734 <para>is a DCE/RPC Packet Parser and Dumper.</para>
735 <indexterm zone="samba ndrdump">
736 <primary sortas="b-ndrdump">ndrdump</primary>
737 </indexterm>
738 </listitem>
739 </varlistentry>
740
741 <varlistentry id="net">
742 <term><command>net</command></term>
743 <listitem>
744 <para>is a tool for administration of
745 <application>Samba</application> and remote CIFS servers, similar
746 to the <command>net</command> utility for DOS/Windows.</para>
747 <indexterm zone="samba net">
748 <primary sortas="b-net">net</primary>
749 </indexterm>
750 </listitem>
751 </varlistentry>
752
753 <varlistentry id="nmbd">
754 <term><command>nmbd</command></term>
755 <listitem>
756 <para>is the <application>Samba</application>
757 NetBIOS name server.</para>
758 <indexterm zone="samba nmbd">
759 <primary sortas="b-nmbd">nmbd</primary>
760 </indexterm>
761 </listitem>
762 </varlistentry>
763
764 <varlistentry id="nmblookup">
765 <term><command>nmblookup</command></term>
766 <listitem>
767 <para>is used to query NetBIOS names and map
768 them to IP addresses.</para>
769 <indexterm zone="samba nmblookup">
770 <primary sortas="b-nmblookup">nmblookup</primary>
771 </indexterm>
772 </listitem>
773 </varlistentry>
774
775 <varlistentry id="ntlm_auth">
776 <term><command>ntlm_auth</command></term>
777 <listitem>
778 <para>is a tool to allow external access to Winbind's
779 NTLM authentication function.</para>
780 <indexterm zone="samba ntlm_auth">
781 <primary sortas="b-ntlm_auth">ntlm_auth</primary>
782 </indexterm>
783 </listitem>
784 </varlistentry>
785
786 <varlistentry id="oLschema2ldif">
787 <term><command>oLschema2ldif</command></term>
788 <listitem>
789 <para>converts LDAP schema's to LDB-compatible LDIF.</para>
790 <indexterm zone="samba oLschema2ldif">
791 <primary sortas="b-oLschema2ldif">oLschema2ldif</primary>
792 </indexterm>
793 </listitem>
794 </varlistentry>
795
796 <varlistentry id="pdbedit">
797 <term><command>pdbedit</command></term>
798 <listitem>
799 <para>is a tool used to manage the SAM database.</para>
800 <indexterm zone="samba pdbedit">
801 <primary sortas="b-pdbedit">pdbedit</primary>
802 </indexterm>
803 </listitem>
804 </varlistentry>
805
806 <varlistentry id="pidl">
807 <term><command>pidl</command></term>
808 <listitem>
809 <para>is an IDL (Interface Definition Language) compiler
810 written in Perl.</para>
811 <indexterm zone="samba pidl">
812 <primary sortas="b-pidl">pidl</primary>
813 </indexterm>
814 </listitem>
815 </varlistentry>
816
817 <varlistentry id="profiles">
818 <term><command>profiles</command></term>
819 <listitem>
820 <para>is a utility that reports and changes SIDs in Windows
821 registry files. It currently only supports Windows NT.</para>
822 <indexterm zone="samba profiles">
823 <primary sortas="b-profiles">profiles</primary>
824 </indexterm>
825 </listitem>
826 </varlistentry>
827
828 <varlistentry id="regdiff">
829 <term><command>regdiff</command></term>
830 <listitem>
831 <para>is a Diff program for Windows registry files.</para>
832 <indexterm zone="samba regdiff">
833 <primary sortas="b-regdiff">regdiff</primary>
834 </indexterm>
835 </listitem>
836 </varlistentry>
837
838 <varlistentry id="regpatch">
839 <term><command>regpatch</command></term>
840 <listitem>
841 <para>applies registry patches to registry files.</para>
842 <indexterm zone="samba regpatch">
843 <primary sortas="b-regpatch">regpatch</primary>
844 </indexterm>
845 </listitem>
846 </varlistentry>
847
848 <varlistentry id="regshell">
849 <term><command>regshell</command></term>
850 <listitem>
851 <para>is a Windows registry file browser using readline.</para>
852 <indexterm zone="samba regshell">
853 <primary sortas="b-regshell">regshell</primary>
854 </indexterm>
855 </listitem>
856 </varlistentry>
857
858 <varlistentry id="regtree">
859 <term><command>regtree</command></term>
860 <listitem>
861 <para>is a text-mode registry viewer.</para>
862 <indexterm zone="samba regtree">
863 <primary sortas="b-regtree">regtree</primary>
864 </indexterm>
865 </listitem>
866 </varlistentry>
867
868 <varlistentry id="rpcclient">
869 <term><command>rpcclient</command></term>
870 <listitem>
871 <para>is used to execute MS-RPC client side functions.</para>
872 <indexterm zone="samba rpcclient">
873 <primary sortas="b-rpcclient">rpcclient</primary>
874 </indexterm>
875 </listitem>
876 </varlistentry>
877
878 <varlistentry id="samba-prog">
879 <term><command>samba</command></term>
880 <listitem>
881 <para>is a server to provide AD and SMB/CIFS services
882 to clients.</para>
883 <indexterm zone="samba samba-prog">
884 <primary sortas="b-samba-prog">samba</primary>
885 </indexterm>
886 </listitem>
887 </varlistentry>
888
889 <varlistentry id="samba_dnsupdate">
890 <term><command>samba_dnsupdate</command></term>
891 <listitem>
892 <para>is used to update our DNS names using TSIG-GSS.</para>
893 <indexterm zone="samba samba_dnsupdate">
894 <primary sortas="b-samba_dnsupdate">samba_dnsupdate</primary>
895 </indexterm>
896 </listitem>
897 </varlistentry>
898
899 <varlistentry id="samba_kcc">
900 <term><command>samba_kcc</command></term>
901 <listitem>
902 <para>is a script used to compute your KCC (Knowledge
903 Consistency Checker) topology.</para>
904 <indexterm zone="samba samba_kcc">
905 <primary sortas="b-samba_kcc">samba_kcc</primary>
906 </indexterm>
907 </listitem>
908 </varlistentry>
909
910 <varlistentry id="samba-regedit">
911 <term><command>samba-regedit</command></term>
912 <listitem>
913 <para>is a ncurses based tool to manage the Samba registry.</para>
914 <indexterm zone="samba samba-regedit">
915 <primary sortas="b-samba-regedit">samba-regedit</primary>
916 </indexterm>
917 </listitem>
918 </varlistentry>
919
920 <varlistentry id="samba_spnupdate">
921 <term><command>samba_spnupdate</command></term>
922 <listitem>
923 <para>is a script to update the servicePrincipalName
924 names from spn_update_list.</para>
925 <indexterm zone="samba samba_spnupdate">
926 <primary sortas="b-samba_spnupdate">samba_spnupdate</primary>
927 </indexterm>
928 </listitem>
929 </varlistentry>
930
931 <varlistentry id="samba-tool">
932 <term><command>samba-tool</command></term>
933 <listitem>
934 <para>is the main Samba administration tool.</para>
935 <indexterm zone="samba samba-tool">
936 <primary sortas="b-samba-tool">samba-tool</primary>
937 </indexterm>
938 </listitem>
939 </varlistentry>
940
941 <varlistentry id="samba_upgradedns">
942 <term><command>samba_upgradedns</command></term>
943 <listitem>
944 <para>is a Unix SMB/CIFS implementation.</para>
945 <indexterm zone="samba samba_upgradedns">
946 <primary sortas="b-samba_upgradedns">samba_upgradedns</primary>
947 </indexterm>
948 </listitem>
949 </varlistentry>
950
951 <varlistentry id="sharesec">
952 <term><command>sharesec</command></term>
953 <listitem>
954 <para>manipulates share ACL permissions on SMB file shares.</para>
955 <indexterm zone="samba sharesec">
956 <primary sortas="b-sharesec">sharesec</primary>
957 </indexterm>
958 </listitem>
959 </varlistentry>
960
961 <varlistentry id="smbcacls">
962 <term><command>smbcacls</command></term>
963 <listitem>
964 <para>is used to manipulate Windows NT access control lists.</para>
965 <indexterm zone="samba smbcacls">
966 <primary sortas="b-smbcacls">smbcacls</primary>
967 </indexterm>
968 </listitem>
969 </varlistentry>
970
971 <varlistentry id="smbclient">
972 <term><command>smbclient</command></term>
973 <listitem>
974 <para>is a SMB/CIFS access utility, similar to FTP.</para>
975 <indexterm zone="samba smbclient">
976 <primary sortas="b-smbclient">smbclient</primary>
977 </indexterm>
978 </listitem>
979 </varlistentry>
980
981 <varlistentry id="smbcontrol">
982 <term><command>smbcontrol</command></term>
983 <listitem>
984 <para>is used to control running <command>smbd</command>,
985 <command>nmbd</command> and <command>winbindd</command>
986 daemons.</para>
987 <indexterm zone="samba smbcontrol">
988 <primary sortas="b-smbcontrol">smbcontrol</primary>
989 </indexterm>
990 </listitem>
991 </varlistentry>
992
993 <varlistentry id="smbcquotas">
994 <term><command>smbcquotas</command></term>
995 <listitem>
996 <para>is used to manipulate Windows NT quotas on
997 SMB file shares.</para>
998 <indexterm zone="samba smbcquotas">
999 <primary sortas="b-smbcquotas">smbcquotas</primary>
1000 </indexterm>
1001 </listitem>
1002 </varlistentry>
1003
1004 <varlistentry id="smbd">
1005 <term><command>smbd</command></term>
1006 <listitem>
1007 <para>is the main <application>Samba</application> daemon which
1008 provides SMB/CIFS services to clients.</para>
1009 <indexterm zone="samba smbd">
1010 <primary sortas="b-smbd">smbd</primary>
1011 </indexterm>
1012 </listitem>
1013 </varlistentry>
1014
1015 <varlistentry id="smbget">
1016 <term><command>smbget</command></term>
1017 <listitem>
1018 <para>is a simple utility with <command>wget</command>-like
1019 semantics, that can download files from SMB servers. You can specify
1020 the files you would like to download on the command-line.</para>
1021 <indexterm zone="samba smbget">
1022 <primary sortas="b-smbget">smbget</primary>
1023 </indexterm>
1024 </listitem>
1025 </varlistentry>
1026
1027 <varlistentry id="smbpasswd">
1028 <term><command>smbpasswd</command></term>
1029 <listitem>
1030 <para>changes a user's <application>Samba</application>
1031 password.</para>
1032 <indexterm zone="samba smbpasswd">
1033 <primary sortas="b-smbpasswd">smbpasswd</primary>
1034 </indexterm>
1035 </listitem>
1036 </varlistentry>
1037
1038 <varlistentry id="smbspool">
1039 <term><command>smbspool</command></term>
1040 <listitem>
1041 <para>sends a print job to an SMB printer.</para>
1042 <indexterm zone="samba smbspool">
1043 <primary sortas="b-smbspool">smbspool</primary>
1044 </indexterm>
1045 </listitem>
1046 </varlistentry>
1047
1048 <varlistentry id="smbstatus">
1049 <term><command>smbstatus</command></term>
1050 <listitem>
1051 <para>reports current <application>Samba</application>
1052 connections.</para>
1053 <indexterm zone="samba smbstatus">
1054 <primary sortas="b-smbstatus">smbstatus</primary>
1055 </indexterm>
1056 </listitem>
1057 </varlistentry>
1058
1059 <varlistentry id="smbtar">
1060 <term><command>smbtar</command></term>
1061 <listitem>
1062 <para>is a shell script used for backing up SMB/CIFS shares
1063 directly to Linux tape drives or a file.</para>
1064 <indexterm zone="samba smbtar">
1065 <primary sortas="b-smbtar">smbtar</primary>
1066 </indexterm>
1067 </listitem>
1068 </varlistentry>
1069
1070<!--
1071 <varlistentry id="smbta-util">
1072 <term><command>smbta-util</command></term>
1073 <listitem>
1074 <para>is a tool to ease the configuration of the
1075 vfs_smb_traffic_analyzer module regarding data encryption.</para>
1076 <indexterm zone="samba smbta-util">
1077 <primary sortas="b-smbta-util">smbta-util</primary>
1078 </indexterm>
1079 </listitem>
1080 </varlistentry>
1081-->
1082
1083 <varlistentry id="smbtorture">
1084 <term><command>smbtorture</command></term>
1085 <listitem>
1086 <para>is a testsuite that runs several tests against a SMB
1087 server.</para>
1088 <indexterm zone="samba smbtorture">
1089 <primary sortas="b-smbtorture">smbtorture</primary>
1090 </indexterm>
1091 </listitem>
1092 </varlistentry>
1093
1094 <varlistentry id="smbtree">
1095 <term><command>smbtree</command></term>
1096 <listitem>
1097 <para>is a text-based SMB network browser.</para>
1098 <indexterm zone="samba smbtree">
1099 <primary sortas="b-smbtree">smbtree</primary>
1100 </indexterm>
1101 </listitem>
1102 </varlistentry>
1103
1104 <varlistentry id="tdbbackup">
1105 <term><command>tdbbackup</command></term>
1106 <listitem>
1107 <para>is a tool for backing up or validating the integrity of
1108 <application>Samba</application> <filename>.tdb</filename>
1109 files.</para>
1110 <indexterm zone="samba tdbbackup">
1111 <primary sortas="b-tdbbackup">tdbbackup</primary>
1112 </indexterm>
1113 </listitem>
1114 </varlistentry>
1115
1116 <varlistentry id="tdbdump">
1117 <term><command>tdbdump</command></term>
1118 <listitem>
1119 <para> is a tool used to print the contents of a
1120 <application>Samba</application> <filename>.tdb</filename>
1121 file.</para>
1122 <indexterm zone="samba tdbdump">
1123 <primary sortas="b-tdbdump">tdbdump</primary>
1124 </indexterm>
1125 </listitem>
1126 </varlistentry>
1127
1128 <varlistentry id="tdbrestore">
1129 <term><command>tdbrestore</command></term>
1130 <listitem>
1131 <para> is a tool for creating a <application>Samba</application>
1132 <filename>.tdb</filename> file out of a ntdbdump.</para>
1133 <indexterm zone="samba tdbrestore">
1134 <primary sortas="b-tdbrestore">tdbrestore</primary>
1135 </indexterm>
1136 </listitem>
1137 </varlistentry>
1138
1139 <varlistentry id="tdbtool">
1140 <term><command>tdbtool</command></term>
1141 <listitem>
1142 <para>is a tool which allows simple database manipulation from the
1143 command line.</para>
1144 <indexterm zone="samba tdbtool">
1145 <primary sortas="b-tdbtool">tdbtool</primary>
1146 </indexterm>
1147 </listitem>
1148 </varlistentry>
1149
1150 <varlistentry id="testparm">
1151 <term><command>testparm</command></term>
1152 <listitem>
1153 <para>checks an <filename>smb.conf</filename> file for proper
1154 syntax.</para>
1155 <indexterm zone="samba testparm">
1156 <primary sortas="b-testparm">testparm</primary>
1157 </indexterm>
1158 </listitem>
1159 </varlistentry>
1160
1161 <varlistentry id="wbinfo">
1162 <term><command>wbinfo</command></term>
1163 <listitem>
1164 <para>queries a running <command>winbindd</command> daemon.</para>
1165 <indexterm zone="samba wbinfo">
1166 <primary sortas="b-wbinfo">wbinfo</primary>
1167 </indexterm>
1168 </listitem>
1169 </varlistentry>
1170
1171 <varlistentry id="winbindd">
1172 <term><command>winbindd</command></term>
1173 <listitem>
1174 <para>resolves names from Windows NT servers.</para>
1175 <indexterm zone="samba winbindd">
1176 <primary sortas="b-winbindd">winbindd</primary>
1177 </indexterm>
1178 </listitem>
1179 </varlistentry>
1180
1181 <varlistentry id="libnss_winbind">
1182 <term><filename class='libraryfile'>libnss_winbind.so</filename></term>
1183 <listitem>
1184 <para>provides Name Service Switch API functions for resolving names
1185 from NT servers.</para>
1186 <indexterm zone="samba libnss_winbind">
1187 <primary sortas="c-libnss_winbind">libnss_winbind.so</primary>
1188 </indexterm>
1189 </listitem>
1190 </varlistentry>
1191
1192 <varlistentry id="libnss_wins">
1193 <term><filename class='libraryfile'>libnss_wins.so</filename></term>
1194 <listitem>
1195 <para>provides API functions for Samba's implementation of the
1196 Windows Internet Naming Service.</para>
1197 <indexterm zone="samba libnss_wins">
1198 <primary sortas="c-libnss_wins">libnss_wins.so</primary>
1199 </indexterm>
1200 </listitem>
1201 </varlistentry>
1202
1203 <varlistentry id="libnetapi">
1204 <term><filename class='libraryfile'>libnetapi.so</filename></term>
1205 <listitem>
1206 <para>provides the API functions for the administration tools used
1207 for Samba and remote CIFS servers.</para>
1208 <indexterm zone="samba libnetapi">
1209 <primary sortas="c-libnetapi">libnetapi.so</primary>
1210 </indexterm>
1211 </listitem>
1212 </varlistentry>
1213
1214 <varlistentry id="libsmbclient">
1215 <term><filename class='libraryfile'>libsmbclient.so</filename></term>
1216 <listitem>
1217 <para>provides the API functions for the Samba SMB client tools.</para>
1218 <indexterm zone="samba libsmbclient">
1219 <primary sortas="c-libsmbclient">libsmbclient.so</primary>
1220 </indexterm>
1221 </listitem>
1222 </varlistentry>
1223<!--
1224 <varlistentry id="libsmbsharemodes">
1225 <term><filename class='libraryfile'>libsmbsharemodes.so</filename></term>
1226 <listitem>
1227 <para>provides API functions for accessing SMB share modes
1228 (locks etc.)</para>
1229 <indexterm zone="samba libsmbsharemodes">
1230 <primary sortas="c-libsmbsharemodes">libsmbsharemodes.so</primary>
1231 </indexterm>
1232 </listitem>
1233 </varlistentry>-->
1234
1235 <varlistentry id="libwbclient">
1236 <term><filename class='libraryfile'>libwbclient.so</filename></term>
1237 <listitem>
1238 <para>provides API functions for Windows domain client services.</para>
1239 <indexterm zone="samba libwbclient">
1240 <primary sortas="c-libwbclient">libwbclient.so</primary>
1241 </indexterm>
1242 </listitem>
1243 </varlistentry>
1244
1245 </variablelist>
1246
1247 </sect2>
1248
1249</sect1>
Note: See TracBrowser for help on using the repository browser.