source: networking/netprogs/samba.xml@ 603a42b

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 603a42b was 603a42b, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Update to samba-4.4.2.
Update to frie0r-plugins-1.5.0 (from frei0r-snapshot).
Update to XML-LibXML-Simple-0.97.

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