source: networking/netprogs/samba.xml@ 3fdc9b0

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 nosym 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 3fdc9b0 was 3fdc9b0, checked in by Douglas R. Reno <renodr@…>, 8 years ago

Update to freetype-2.6.4
Update to LLVM-3.8.1
Update to Samba-4.4.5
Update to gnome-online-accounts-3.20.2 (systemd)
Update to Weston-1.11.0 (systemd)
Fix the build of GDM (systemd)
Tags and Text Fixes

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