source: networking/netprogs/samba.xml@ 614fce8e

10.0 10.1 11.0 11.1 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 614fce8e was 614fce8e, checked in by Douglas R. Reno <renodr@…>, 6 years ago

(systemd/gnome merge staging) Update to gnome-settings-daemon-3.20.1
(systemd/gnome merge staging) Update to zenity-3.20.0
(systemd/gnome merge staging) Update to Nautilus-3.20.1
(systemd/gnome merge staging) Update to gvfs-1.28.2
(systemd/gnome merge staging) Update to gnome-themes-standard-3.20.2
(systemd/gnome merge staging) Update to gnome-bluetooth-3.20.0
(systemd/gnome merge) Copied systemd-specific dependencies in gvfs to trunk
(systemd/gnome merge) Copied gnome-settings-daemon, zenity, and gnome-bluetooth to trunk
Updated dependencies in network-manager-applet to reflect that trunk has ModemManager now and systemd has gnome-bluetooth copied over
Typo Fixes and Tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17570 af4574ff-66df-0310-9fd7-8a98e5e911e0

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