source: networking/netprogs/samba.xml@ b45d8f3

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since b45d8f3 was b45d8f3, checked in by Bruce Dubbs <bdubbs@…>, 10 years ago

Update to samba-4.1.7

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

  • Property mode set to 100644
File size: 34.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 "http://ftp.samba.org/pub/samba/stable/samba-&samba-version;.tar.gz">
8 <!ENTITY samba-download-ftp "ftp://ftp.samba.org/pub/samba/stable/samba-&samba-version;.tar.gz">
9 <!ENTITY samba-md5sum "bc44b0a245468c3574ef07644206ede3">
10 <!ENTITY samba-size "22 MB">
11 <!ENTITY samba-buildsize "504 MB (additional 27 MB for the quicktest,
12 reputedly up to 500 MB additional for all tests)">
13 <!ENTITY samba-time "7.9 SBU (additional 8.7 SBU for the quicktest,
14 reputedly up to 110 SBU to run all tests)">
15]>
16
17<sect1 id="samba" xreflabel="Samba-&samba-version;">
18 <?dbhtml filename="samba.html"?>
19
20 <sect1info>
21 <othername>$LastChangedBy$</othername>
22 <date>$Date$</date>
23 </sect1info>
24
25 <title>Samba-&samba-version;</title>
26
27 <indexterm zone="samba">
28 <primary sortas="a-Samba">Samba</primary>
29 </indexterm>
30
31 <sect2 role="package">
32 <title>Introduction to Samba</title>
33
34 <para>The <application>Samba</application> package provides file and print
35 services to SMB/CIFS clients and Windows networking to Linux clients.
36 <application>Samba</application> can also be configured as a Windows Domain
37 Controller replacement, a file/print server acting as a member of a Windows
38 Active Directory domain and a NetBIOS (rfc1001/1002) nameserver (which
39 among other things provides LAN browsing support).</para>
40
41 &lfs75_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>Download (HTTP): <ulink url="&samba-download-http;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download (FTP): <ulink url="&samba-download-ftp;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download MD5 sum: &samba-md5sum;</para>
53 </listitem>
54 <listitem>
55 <para>Download size: &samba-size;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated disk space required: &samba-buildsize;</para>
59 </listitem>
60 <listitem>
61 <para>Estimated build time: &samba-time;</para>
62 </listitem>
63 </itemizedlist>
64
65 <bridgehead renderas="sect3">Samba Dependencies</bridgehead>
66
67 <bridgehead renderas="sect4">Required</bridgehead>
68 <para role="required">
69 <xref linkend="python2"/>
70 </para>
71
72 <bridgehead renderas="sect4">Optional</bridgehead>
73 <para role="optional">
74 <xref linkend="popt"/>,
75 <xref linkend="linux-pam"/>,
76 <xref linkend="cups"/>,
77 <xref linkend="openldap"/>,
78 <ulink url="https://people.gnome.org/~veillard/gamin/">Gamin</ulink>,
79 <xref linkend="acl"/>,
80 <xref linkend="xfsprogs"/>,
81 <xref linkend="mitkrb"/>,
82 <xref linkend="libxslt"/> (used only for documentation),
83 <ulink url="http://tdb.samba.org/">tdb</ulink>,
84 <ulink url="http://ctdb.samba.org/">ctdb</ulink>,
85 <xref linkend="libcap"/>,
86 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>,
87 <xref linkend="avahi"/>,
88 <ulink url="http://www.openafs.org/">OpenAFS</ulink>, and
89 <xref linkend="valgrind"/> (optionally used by the test suite)
90 </para>
91
92 <para condition="html" role="usernotes">User Notes:
93 <ulink url="&blfs-wiki;/samba4"/></para>
94
95 </sect2>
96
97 <sect2 role="installation">
98 <title>Installation of Samba</title>
99
100 <note>
101 <para>If you wish to run the test suite after the binaries are built,
102 you must add the <option>--enable-socket-wrapper</option>
103 and <option>--enable-selftest</option> parameters to
104 the <command>configure</command> script below. You may want to run
105 <command>configure</command> with the <option>--help</option> parameter
106 first. There may be other parameters needed to take advantage of
107 optional dependencies.</para>
108 </note>
109
110 <para>Install <application>Samba</application> by running the following
111 commands:</para>
112
113<screen><userinput>./configure \
114 --prefix=/usr \
115 --sysconfdir=/etc \
116 --localstatedir=/var \
117 --with-piddir=/run/samba \
118 --with-pammodulesdir=/lib/security \
119 --enable-fhs \
120 --enable-nss-wrapper &amp;&amp;
121
122make</userinput></screen>
123
124 <para>To test the results, as the <systemitem
125 class="username">root</systemitem> user, issue: <command>make
126 quicktest</command>. There are other targets (test, subunit-test)
127 available, but take a very long time (over 100 SBU).</para>
128
129 <para>If one quicktest fails, it can be disabled. For example,
130 <quote><replaceable>samba3.raw.eas</replaceable></quote> has been reported
131 to fail for prior Samba versions. To disable it, run the following
132 command:</para>
133
134<screen><userinput>sed -i "/samba3.blackbox.failure.failure/i \^samba3.raw.eas" selftest/knownfail</userinput></screen>
135
136 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
137
138<screen role="root"><userinput>make install &amp;&amp;
139
140mv -v /usr/lib/libnss_win{s,bind}.so* /lib &amp;&amp;
141ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so &amp;&amp;
142ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so &amp;&amp;
143
144install -v -m644 examples/smb.conf.default /etc/samba &amp;&amp;
145
146mkdir -pv /etc/openldap/schema &amp;&amp;
147
148install -v -m644 examples/LDAP/README \
149 /etc/openldap/schema/README.LDAP &amp;&amp;
150
151install -v -m644 examples/LDAP/samba* \
152 /etc/openldap/schema &amp;&amp;
153
154install -v -m755 examples/LDAP/{get*,ol*} \
155 /etc/openldap/schema &amp;&amp;
156
157install -v -m755 -d /usr/share/doc/samba-&samba-version; &amp;&amp;
158
159install -v -m644 lib/ntdb/doc/design.pdf \
160 /usr/share/doc/samba-&samba-version;</userinput></screen>
161
162 </sect2>
163
164 <sect2 role="commands">
165 <title>Command Explanations</title>
166
167 <para><command>sed -e "s:(Functon ...</command>: Fix build with
168 <application>readline-6.x</application> (x > 2).</para>
169
170 <para><parameter>--enable-fhs</parameter>: Assigns all other file paths in
171 a manner compliant with the Filesystem Hierarchy Standard (FHS).</para>
172
173 <para><parameter>--enable-nss-wrapper</parameter>: Builds the nss-wrapper
174 library.</para>
175
176 <para><option>--enable-socket-wrapper</option> and
177 <option>--enable-selftest</option>: These options are required to run
178 the test suite.</para>
179
180 <para><command>mv -v /usr/lib/libnss_win{s,bind}.so* /lib</command>:
181 The nss libraries are installed in /usr/lib by default. Move them to
182 /lib.</para>
183
184 <para><command>ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so</command>
185 and <command>ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so</command>:
186 These symlinks are required when applicates build against these libraries.</para>
187
188 <para><command>install -v -m644 examples/LDAP/* /etc/openldap/schema</command>:
189 These commands are used to copy sample Samba schemas to the OpenLDAP
190 <filename class='directory'>schema</filename> directory.</para>
191
192 <para><command>install -v -m644 ../examples/smb.conf.default
193 /etc/samba</command>: This copies a default <filename>smb.conf</filename>
194 file into <filename>/etc/samba</filename>. This sample configuration will
195 not work until you copy it to <filename>/etc/samba/smb.conf</filename> and
196 make the appropriate changes for your installation. See the configuration
197 section for minimum values which must be set.</para>
198
199 </sect2>
200
201 <sect2 role="configuration">
202 <title>Configuring Samba</title>
203
204 <sect3 id="samba-config">
205 <title>Config Files</title>
206
207 <para>/etc/samba/smb.conf</para>
208
209 <indexterm zone="samba samba-config">
210 <primary sortas="e-etc-samba-smb.conf">/etc/samba/smb.conf</primary>
211 </indexterm>
212
213 </sect3>
214
215 <sect3>
216 <title>Printing to SMB Clients</title>
217
218 <para>If you use <application>CUPS</application> for print services,
219 and you wish to print to a printer attached to an SMB client, you
220 need to create an SMB backend device. To create the device, issue the
221 following command as the <systemitem class="username">root</systemitem>
222 user:</para>
223
224<screen role="root"><userinput>ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
225
226 </sect3>
227
228 <sect3>
229 <title>Configuration Information</title>
230
231 <para>Due to the complexity and the many various uses for
232 <application>Samba</application>, complete configuration for all the
233 package's capabilities is well beyond the scope of the BLFS book. This
234 section provides instructions to configure the
235 <filename>/etc/samba/smb.conf</filename> file for two common scenarios.
236 The complete contents of <filename>/etc/samba/smb.conf</filename> will
237 depend on the purpose of <application>Samba</application>
238 installation.</para>
239
240 <note>
241 <para>You may find it easier to copy the configuration parameters shown
242 below into an empty <filename>/etc/samba/smb.conf</filename> file
243 instead of copying and editing the default file as mentioned in the
244 <quote>Command Explanations</quote> section. How you create/edit the
245 <filename>/etc/samba/smb.conf</filename> file will be left up to
246 you. Do ensure the file is only writeable by the
247 <systemitem class="username">root</systemitem> user (mode 644).</para>
248 </note>
249
250 <sect4>
251 <title>Scenario 1: Minimal Standalone Client-Only Installation</title>
252
253 <para>Choose this variant if you only want to transfer files using
254 <command>smbclient</command>, mount Windows shares and print to Windows
255 printers, and don't want to share your files and printers to Windows
256 machines.</para>
257
258 <para>A <filename>/etc/samba/smb.conf</filename> file with the following
259 three parameters is sufficient:</para>
260
261<screen role='root'><literal>[global]
262 workgroup = <replaceable>MYGROUP</replaceable>
263 dos charset = <replaceable>cp850</replaceable>
264 unix charset = <replaceable>ISO-8859-1</replaceable></literal></screen>
265
266 <para>The values in this example specify that the computer belongs to a
267 Windows workgroup named
268 <quote><replaceable>MYGROUP</replaceable></quote>, uses the
269 <quote><replaceable>cp850</replaceable></quote> character set on the
270 wire when talking to MS-DOS and MS Windows 9x, and that the filenames
271 are stored in the <quote><replaceable>ISO-8859-1</replaceable></quote>
272 encoding on the disk. Adjust these values appropriately for your
273 installation. The <quote>unix charset</quote> value must be the same as
274 the output of <command>locale charmap</command> when executed with the
275 <envar>LANG</envar> variable set to your preferred locale, otherwise the
276 <command>ls</command> command may not display correct filenames of
277 downloaded files.</para>
278
279 <para>There is no need to run any <application>Samba</application>
280 servers in this scenario, thus you don't need to install the provided
281 bootscripts.</para>
282
283 </sect4>
284
285 <sect4>
286 <title>Scenario 2: Standalone File/Print Server</title>
287
288 <para>Choose this variant if you want to share your files and printers
289 to Windows machines in your workgroup in addition to the capabilities
290 described in Scenario 1.</para>
291
292 <para>In this case, the <filename>/etc/samba/smb.conf.default</filename>
293 file may be a good template to start from. Also add
294 <quote>dos charset</quote> and <quote>unix charset</quote> parameters
295 to the <quote>[global]</quote> section as described in Scenario 1 in
296 order to prevent filename corruption. For security reasons, you may
297 wish to define
298 <replaceable>path = /home/alice/shared-files</replaceable>,
299 assuming your user name is <replaceable>alice</replaceable> and you
300 only want to share the files in that directory, instead of your entire
301 home. Then, replace <replaceable>homes</replaceable> by
302 <replaceable>shared-files</replaceable> and change also the
303 <quote><literal>comment</literal></quote> if used the configuration
304 file below or the <filename>/etc/samba/smb.conf.default</filename>
305 to create yours.</para>
306
307 <para>The following configuration file creates a separate share for each
308 user's home directory and also makes all printers available to Windows
309 machines:</para>
310
311<screen role='root'><literal>[global]
312 workgroup = <replaceable>MYGROUP</replaceable>
313 dos charset = <replaceable>cp850</replaceable>
314 unix charset = <replaceable>ISO-8859-1</replaceable>
315
316[homes]
317 comment = Home Directories
318 browseable = no
319 writable = yes
320
321[printers]
322 comment = All Printers
323 path = /var/spool/samba
324 browseable = no
325 guest ok = no
326 printable = yes</literal></screen>
327
328 <para>Other parameters you may wish to customize in the
329 <quote>[global]</quote> section include:</para>
330
331<screen role='root'><literal> server string =
332 security =
333 hosts allow =
334 load printers =
335 log file =
336 max log size =
337 socket options =
338 local master =</literal></screen>
339
340 <para>Reference the comments in the
341 <filename>/etc/samba/smb.conf.default</filename> file for information
342 regarding these parameters.</para>
343
344 <para>Since the <command>smbd</command> and <command>nmbd</command>
345 daemons are needed in this case, install the <filename>samba</filename>
346 bootscript. Be sure to run <command>smbpasswd</command> (with the
347 <option>-a</option> option to add users) to enable and
348 set passwords for all accounts that need
349 <application>Samba</application> access. Using the default
350 <application>Samba</application> passdb backend, any user you attempt
351 to add will also be required to exist in the
352 <filename>/etc/passwd</filename> file.</para>
353
354 </sect4>
355
356 <sect4>
357 <title>Advanced Requirements</title>
358
359 <para>More complex scenarios involving domain control or membership are
360 possible. Such setups are advanced topics and cannot be adequately
361 covered in BLFS. Many complete books have been written on these topics
362 alone. Note that in some domain membership scenarios, the
363 <command>winbindd</command> daemon and the corresponding bootscript are
364 needed.</para>
365
366 <para>There is quite a bit of documentation available which covers many
367 of these advanced configurations. Point your web browser to the links
368 below to view some of the documentation included with the
369 <application>Samba</application> package:</para>
370
371 <itemizedlist spacing='compact'>
372 <listitem>
373 <para>Using Samba, 2nd Edition; a popular book published by O'Reilly
374 <ulink url="http://www.samba.org/samba/docs/using_samba/toc.html"/></para>
375 </listitem>
376 <listitem>
377 <para>The Official Samba HOWTO and Reference Guide <ulink
378 url="http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/"/>
379 </para>
380 </listitem>
381 <listitem>
382 <para>Samba-3 by Example
383 <ulink url="http://www.samba.org/samba/docs/man/Samba-Guide/"/>
384 </para>
385 </listitem>
386 </itemizedlist>
387
388 </sect4>
389
390 <sect4 id="samba-init">
391 <title>Boot Script</title>
392
393 <para>For your convenience, boot scripts have been provided for
394 <application>Samba</application>. There are two included in the
395 <xref linkend="bootscripts"/> package. The first,
396 <filename>samba</filename>, will start the <command>smbd</command>
397 and <command>nmbd</command> daemons needed to provide SMB/CIFS
398 services. The second script, <filename>winbind</filename>, starts
399 the <command>winbindd</command> daemon, used for providing Windows
400 domain services to Linux clients.</para>
401
402 <indexterm zone="samba samba-init">
403 <primary sortas="f-samba">samba</primary>
404 </indexterm>
405
406 <indexterm zone="samba samba-init">
407 <primary sortas="f-winbind">winbind</primary>
408 </indexterm>
409
410 <para>The default <application>Samba</application> installation uses the
411 <systemitem class='username'>nobody</systemitem> user for guest access
412 to the server. This can be overridden by setting the
413 <option>guest account =</option> parameter in the
414 <filename>/etc/samba/smb.conf</filename> file. If you utilize the
415 <option>guest account =</option> parameter, ensure this user exists in
416 the <filename>/etc/passwd</filename> file. To use the default user,
417 issue the following commands as the
418 <systemitem class='username'>root</systemitem> user:</para>
419
420<screen role="root"><userinput>groupadd -g 99 nogroup &amp;&amp;
421useradd -c "Unprivileged Nobody" -d /dev/null -g nogroup \
422 -s /bin/false -u 99 nobody</userinput></screen>
423
424 <para>Install the <filename>samba</filename> script with the following
425 command issued as the <systemitem class="username">root</systemitem>
426 user:</para>
427
428<screen role="root"><userinput>make install-samba</userinput></screen>
429
430 <para>If you also need the <filename>winbindd</filename>
431 script to resolve names from Windows clients, run:</para>
432
433<screen role="root"><userinput>make install-winbindd</userinput></screen>
434
435 </sect4>
436
437 </sect3>
438
439 </sect2>
440
441 <sect2 role="content">
442 <title>Contents</title>
443
444 <segmentedlist>
445 <segtitle>Installed Programs</segtitle>
446 <segtitle>Installed Libraries</segtitle>
447 <segtitle>Installed Directories</segtitle>
448
449 <seglistitem>
450
451 <seg>cifsdd, dbwrap_tool, eventlogadm, gentest, ldbadd, ldbdel, ldbedit,
452 ldbmodify, ldbrename, ldbsearch, locktest, masktest, ndrdump, net, nmbd,
453 nmblookup, nmblookup4, ntdbbackup, ntdbdump, ntdbrestore, ntdbtool,
454 ntlm_auth, oLschema2ldif, pdbedit, pidl, profiles, regdiff, regpatch,
455 regshell, regtree, rpcclient, samba, samba_dnsupdate, samba_kcc,
456 samba-regedit, samba_spnupdate, samba-tool, samba_upgradedns, sharesec,
457 smbcacls, smbclient, smbclient4, smbcontrol, smbcquotas, smbd, smbget,
458 smbpasswd, smbspool, smbstatus, smbtar, smbta-util, smbtorture, smbtree,
459 tdbbackup, tdbdump, tdbrestore, tdbtool, testparm, wbinfo, and
460 winbindd</seg>
461
462 <seg>libdcerpc-atsvc.so, libdcerpc-binding.so, libdcerpc-samr.so,
463 libdcerpc-server.so, libdcerpc.so, libgensec.so, libndr-krb5pac.so,
464 libndr-nbt.so, libndr.so, libndr-standard.so, libnetapi.so,
465 libnss_winbind.so, libnss_wins.so, libpdb.so, libregistry.so,
466 libsamba-credentials.so, libsamba-hostconfig.so, libsamba-policy.so,
467 libsamba-util.so, libsamdb.so, libsmbclient-raw.so, libsmbclient.so,
468 libsmbconf.so, libsmbldap.so, libsmbsharemodes.so, libtevent-util.so,
469 libtorture.so, libwbclient.so, mit_samba.so, the pam_winbind.so and
470 pam_smbpass.so PAM libraries, winbind_krb5_locator.so, and assorted
471 character set, filesystem and support modules.</seg>
472
473 <seg>/etc/samba, /run/samba, /usr/include/samba-4.0,
474 /usr/lib/python&python2-majorver;/site-packages/samba,
475 /usr/lib/samba, /usr/share/doc/samba-&samba-version;,
476 /usr/share/perl5/Parse/Pidl/Samba{3,4},
477 /usr/share/samba, /var/cache/samba, /var/lib/samba, /var/lock/samba,
478 /var/log/samba, and /var/run/samba</seg>
479
480 </seglistitem>
481 </segmentedlist>
482
483 <variablelist>
484 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
485 <?dbfo list-presentation="list"?>
486 <?dbhtml list-presentation="table"?>
487
488 <varlistentry id="eventlogadm">
489 <term><command>eventlogadm</command></term>
490 <listitem>
491 <para>is used to write records to eventlogs from STDIN, add the
492 specified source and DLL eventlog registry entries and display the
493 active eventlog names (from <filename>smb.conf</filename>).</para>
494 <indexterm zone="samba eventlogadm">
495 <primary sortas="b-eventlogadm">eventlogadm</primary>
496 </indexterm>
497 </listitem>
498 </varlistentry>
499
500 <varlistentry id="ldbadd">
501 <term><command>ldbadd</command></term>
502 <listitem>
503 <para>is a command-line utility for adding records to an LDB
504 database.</para>
505 <indexterm zone="samba ldbadd">
506 <primary sortas="b-ldbadd">ldbadd</primary>
507 </indexterm>
508 </listitem>
509 </varlistentry>
510
511 <varlistentry id="ldbdel">
512 <term><command>ldbdel</command></term>
513 <listitem>
514 <para>is a command-line program for deleting LDB database
515 records.</para>
516 <indexterm zone="samba ldbdel">
517 <primary sortas="b-ldbdel">ldbdel</primary>
518 </indexterm>
519 </listitem>
520 </varlistentry>
521
522 <varlistentry id="ldbedit">
523 <term><command>ldbedit</command></term>
524 <listitem>
525 <para>allows you to edit LDB databases using your preferred
526 editor.</para>
527 <indexterm zone="samba ldbedit">
528 <primary sortas="b-ldbedit">ldbedit</primary>
529 </indexterm>
530 </listitem>
531 </varlistentry>
532
533 <varlistentry id="ldbmodify">
534 <term><command>ldbmodify</command></term>
535 <listitem>
536 <para>allows you to modify records in an LDB database.</para>
537 <indexterm zone="samba ldbmodify">
538 <primary sortas="b-ldbmodify">ldbmodify</primary>
539 </indexterm>
540 </listitem>
541 </varlistentry>
542
543 <varlistentry id="ldbrename">
544 <term><command>ldbrename</command></term>
545 <listitem>
546 <para>allows you to edit LDB databases using your preferred
547 editor.</para>
548 <indexterm zone="samba ldbrename">
549 <primary sortas="b-ldbrename">ldbrename</primary>
550 </indexterm>
551 </listitem>
552 </varlistentry>
553
554 <varlistentry id="ldbsearch">
555 <term><command>ldbsearch</command></term>
556 <listitem>
557 <para>searches an LDB database for records matching a specified
558 expression.</para>
559 <indexterm zone="samba ldbsearch">
560 <primary sortas="b-ldbsearch">ldbsearch</primary>
561 </indexterm>
562 </listitem>
563 </varlistentry>
564
565 <varlistentry id="net">
566 <term><command>net</command></term>
567 <listitem>
568 <para>is a tool for administration of
569 <application>Samba</application> and remote CIFS servers, similar
570 to the <command>net</command> utility for DOS/Windows.</para>
571 <indexterm zone="samba net">
572 <primary sortas="b-net">net</primary>
573 </indexterm>
574 </listitem>
575 </varlistentry>
576
577 <varlistentry id="nmbd">
578 <term><command>nmbd</command></term>
579 <listitem>
580 <para>is the <application>Samba</application>
581 NetBIOS name server.</para>
582 <indexterm zone="samba nmbd">
583 <primary sortas="b-nmbd">nmbd</primary>
584 </indexterm>
585 </listitem>
586 </varlistentry>
587
588 <varlistentry id="nmblookup">
589 <term><command>nmblookup</command></term>
590 <listitem>
591 <para>is used to query NetBIOS names and map
592 them to IP addresses.</para>
593 <indexterm zone="samba nmblookup">
594 <primary sortas="b-nmblookup">nmblookup</primary>
595 </indexterm>
596 </listitem>
597 </varlistentry>
598
599 <varlistentry id="ntlm_auth">
600 <term><command>ntlm_auth</command></term>
601 <listitem>
602 <para>is a tool to allow external access to Winbind's
603 NTLM authentication function.</para>
604 <indexterm zone="samba ntlm_auth">
605 <primary sortas="b-ntlm_auth">ntlm_auth</primary>
606 </indexterm>
607 </listitem>
608 </varlistentry>
609
610 <varlistentry id="pdbedit">
611 <term><command>pdbedit</command></term>
612 <listitem>
613 <para>is a tool used to manage the SAM database.</para>
614 <indexterm zone="samba pdbedit">
615 <primary sortas="b-pdbedit">pdbedit</primary>
616 </indexterm>
617 </listitem>
618 </varlistentry>
619
620 <varlistentry id="profiles">
621 <term><command>profiles</command></term>
622 <listitem>
623 <para>is a utility that reports and changes SIDs in Windows
624 registry files. It currently only supports Windows NT.</para>
625 <indexterm zone="samba profiles">
626 <primary sortas="b-profiles">profiles</primary>
627 </indexterm>
628 </listitem>
629 </varlistentry>
630
631 <varlistentry id="rpcclient">
632 <term><command>rpcclient</command></term>
633 <listitem>
634 <para>is used to execute MS-RPC client side functions.</para>
635 <indexterm zone="samba rpcclient">
636 <primary sortas="b-rpcclient">rpcclient</primary>
637 </indexterm>
638 </listitem>
639 </varlistentry>
640
641 <varlistentry id="sharesec">
642 <term><command>sharesec</command></term>
643 <listitem>
644 <para>manipulates share ACL permissions on SMB file shares.</para>
645 <indexterm zone="samba sharesec">
646 <primary sortas="b-sharesec">sharesec</primary>
647 </indexterm>
648 </listitem>
649 </varlistentry>
650
651 <varlistentry id="smbcacls">
652 <term><command>smbcacls</command></term>
653 <listitem>
654 <para>is used to manipulate Windows NT access control lists.</para>
655 <indexterm zone="samba smbcacls">
656 <primary sortas="b-smbcacls">smbcacls</primary>
657 </indexterm>
658 </listitem>
659 </varlistentry>
660
661 <varlistentry id="smbclient">
662 <term><command>smbclient</command></term>
663 <listitem>
664 <para>is a SMB/CIFS access utility, similar to FTP.</para>
665 <indexterm zone="samba smbclient">
666 <primary sortas="b-smbclient">smbclient</primary>
667 </indexterm>
668 </listitem>
669 </varlistentry>
670
671 <varlistentry id="smbcontrol">
672 <term><command>smbcontrol</command></term>
673 <listitem>
674 <para>is used to control running <command>smbd</command>,
675 <command>nmbd</command> and <command>winbindd</command>
676 daemons.</para>
677 <indexterm zone="samba smbcontrol">
678 <primary sortas="b-smbcontrol">smbcontrol</primary>
679 </indexterm>
680 </listitem>
681 </varlistentry>
682
683 <varlistentry id="smbcquotas">
684 <term><command>smbcquotas</command></term>
685 <listitem>
686 <para>is used to manipulate Windows NT quotas on
687 SMB file shares.</para>
688 <indexterm zone="samba smbcquotas">
689 <primary sortas="b-smbcquotas">smbcquotas</primary>
690 </indexterm>
691 </listitem>
692 </varlistentry>
693
694 <varlistentry id="smbd">
695 <term><command>smbd</command></term>
696 <listitem>
697 <para>is the main <application>Samba</application> daemon which
698 provides SMB/CIFS services to clients.</para>
699 <indexterm zone="samba smbd">
700 <primary sortas="b-smbd">smbd</primary>
701 </indexterm>
702 </listitem>
703 </varlistentry>
704
705 <varlistentry id="smbget">
706 <term><command>smbget</command></term>
707 <listitem>
708 <para>is a simple utility with <command>wget</command>-like
709 semantics, that can download files from SMB servers. You can specify
710 the files you would like to download on the command-line.</para>
711 <indexterm zone="samba smbget">
712 <primary sortas="b-smbget">smbget</primary>
713 </indexterm>
714 </listitem>
715 </varlistentry>
716
717 <varlistentry id="smbpasswd">
718 <term><command>smbpasswd</command></term>
719 <listitem>
720 <para>changes a user's <application>Samba</application>
721 password.</para>
722 <indexterm zone="samba smbpasswd">
723 <primary sortas="b-smbpasswd">smbpasswd</primary>
724 </indexterm>
725 </listitem>
726 </varlistentry>
727
728 <varlistentry id="smbspool">
729 <term><command>smbspool</command></term>
730 <listitem>
731 <para>sends a print job to an SMB printer.</para>
732 <indexterm zone="samba smbspool">
733 <primary sortas="b-smbspool">smbspool</primary>
734 </indexterm>
735 </listitem>
736 </varlistentry>
737
738 <varlistentry id="smbstatus">
739 <term><command>smbstatus</command></term>
740 <listitem>
741 <para>reports current <application>Samba</application>
742 connections.</para>
743 <indexterm zone="samba smbstatus">
744 <primary sortas="b-smbstatus">smbstatus</primary>
745 </indexterm>
746 </listitem>
747 </varlistentry>
748
749 <varlistentry id="smbtar">
750 <term><command>smbtar</command></term>
751 <listitem>
752 <para>is a shell script used for backing up SMB/CIFS shares
753 directly to Linux tape drives or a file.</para>
754 <indexterm zone="samba smbtar">
755 <primary sortas="b-smbtar">smbtar</primary>
756 </indexterm>
757 </listitem>
758 </varlistentry>
759
760 <varlistentry id="smbtree">
761 <term><command>smbtree</command></term>
762 <listitem>
763 <para>is a text-based SMB network browser.</para>
764 <indexterm zone="samba smbtree">
765 <primary sortas="b-smbtree">smbtree</primary>
766 </indexterm>
767 </listitem>
768 </varlistentry>
769
770 <varlistentry id="tdbbackup">
771 <term><command>tdbbackup</command></term>
772 <listitem>
773 <para>is a tool for backing up or validating the integrity of
774 <application>Samba</application> <filename>.tdb</filename>
775 files.</para>
776 <indexterm zone="samba tdbbackup">
777 <primary sortas="b-tdbbackup">tdbbackup</primary>
778 </indexterm>
779 </listitem>
780 </varlistentry>
781
782 <varlistentry id="tdbdump">
783 <term><command>tdbdump</command></term>
784 <listitem>
785 <para> is a tool used to print the contents of a
786 <application>Samba</application> <filename>.tdb</filename>
787 file.</para>
788 <indexterm zone="samba tdbdump">
789 <primary sortas="b-tdbdump">tdbdump</primary>
790 </indexterm>
791 </listitem>
792 </varlistentry>
793
794 <varlistentry id="tdbtool">
795 <term><command>tdbtool</command></term>
796 <listitem>
797 <para>is a tool which allows simple database manipulation from the
798 command line.</para>
799 <indexterm zone="samba tdbtool">
800 <primary sortas="b-tdbtool">tdbtool</primary>
801 </indexterm>
802 </listitem>
803 </varlistentry>
804
805 <varlistentry id="testparm">
806 <term><command>testparm</command></term>
807 <listitem>
808 <para>checks an <filename>smb.conf</filename> file for proper
809 syntax.</para>
810 <indexterm zone="samba testparm">
811 <primary sortas="b-testparm">testparm</primary>
812 </indexterm>
813 </listitem>
814 </varlistentry>
815
816 <varlistentry id="wbinfo">
817 <term><command>wbinfo</command></term>
818 <listitem>
819 <para>queries a running <command>winbindd</command> daemon.</para>
820 <indexterm zone="samba wbinfo">
821 <primary sortas="b-wbinfo">wbinfo</primary>
822 </indexterm>
823 </listitem>
824 </varlistentry>
825
826 <varlistentry id="winbindd">
827 <term><command>winbindd</command></term>
828 <listitem>
829 <para>resolves names from Windows NT servers.</para>
830 <indexterm zone="samba winbindd">
831 <primary sortas="b-winbindd">winbindd</primary>
832 </indexterm>
833 </listitem>
834 </varlistentry>
835
836 <varlistentry id="libnss_winbind">
837 <term><filename class='libraryfile'>libnss_winbind.so</filename></term>
838 <listitem>
839 <para>provides Name Service Switch API functions for resolving names
840 from NT servers.</para>
841 <indexterm zone="samba libnss_winbind">
842 <primary sortas="c-libnss_winbind">libnss_winbind.so</primary>
843 </indexterm>
844 </listitem>
845 </varlistentry>
846
847 <varlistentry id="libnss_wins">
848 <term><filename class='libraryfile'>libnss_wins.so</filename></term>
849 <listitem>
850 <para>provides API functions for Samba's implementation of the
851 Windows Internet Naming Service.</para>
852 <indexterm zone="samba libnss_wins">
853 <primary sortas="c-libnss_wins">libnss_wins.so</primary>
854 </indexterm>
855 </listitem>
856 </varlistentry>
857
858 <varlistentry id="libnetapi">
859 <term><filename class='libraryfile'>libnetapi.so</filename></term>
860 <listitem>
861 <para>provides the API functions for the administration tools used
862 for Samba and remote CIFS servers.</para>
863 <indexterm zone="samba libnetapi">
864 <primary sortas="c-libnetapi">libnetapi.so</primary>
865 </indexterm>
866 </listitem>
867 </varlistentry>
868
869 <varlistentry id="libsmbclient">
870 <term><filename class='libraryfile'>libsmbclient.so</filename></term>
871 <listitem>
872 <para>provides the API functions for the Samba SMB client tools.</para>
873 <indexterm zone="samba libsmbclient">
874 <primary sortas="c-libsmbclient">libsmbclient.so</primary>
875 </indexterm>
876 </listitem>
877 </varlistentry>
878
879 <varlistentry id="libsmbsharemodes">
880 <term><filename class='libraryfile'>libsmbsharemodes.so</filename></term>
881 <listitem>
882 <para>provides API functions for accessing SMB share modes
883 (locks etc.)</para>
884 <indexterm zone="samba libsmbsharemodes">
885 <primary sortas="c-libsmbsharemodes">libsmbsharemodes.so</primary>
886 </indexterm>
887 </listitem>
888 </varlistentry>
889
890 <varlistentry id="libwbclient">
891 <term><filename class='libraryfile'>libwbclient.so</filename></term>
892 <listitem>
893 <para>provides API functions for Windows domain client services.</para>
894 <indexterm zone="samba libwbclient">
895 <primary sortas="c-libwbclient">libwbclient.so</primary>
896 </indexterm>
897 </listitem>
898 </varlistentry>
899
900 </variablelist>
901
902 </sect2>
903
904</sect1>
Note: See TracBrowser for help on using the repository browser.