source: networking/netprogs/samba.xml@ 627c062

10.0 10.1 11.0 11.1 11.2 7.10 7.8 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 627c062 was 627c062, checked in by Pierre Labastie <pieere@…>, 7 years ago

Tag networking and server, except bind

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

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