source: networking/netprogs/samba.xml@ 216b521

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.5 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 216b521 was 216b521, checked in by Igor Živković <igor@…>, 10 years ago

updated link to samba blfs wiki

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