source: networking/netprogs/samba.xml@ d9e0208

10.0 10.1 11.0 11.1 11.2 7.10 7.9 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/soup3 xry111/test-20220226
Last change on this file since d9e0208 was d9e0208, checked in by Fernando de Oliveira <fernando@…>, 7 years ago
  • Update to samba-4.3.1.

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

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