source: networking/netprogs/samba.xml@ 514797f

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.9 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 514797f was 514797f, checked in by Fernando de Oliveira <fernando@…>, 8 years ago
  • Update to poppler-0.39.0.
  • Update to ruby-2.2.4.
  • Update to samba-4.3.3.
  • Update to libreoffice-5.0.4 (libreoffice-5.0.4.2).
  • Update to boost_1_60_0.
  • Update to libcroco-0.6.11.
  • Update to Archive-Zip-1.56 (perl module).
  • Update to php-7.0.1.
  • Update to cups-filters-1.5.0.

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