source: networking/netprogs/samba.xml@ a45ebfa4

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a45ebfa4 was a45ebfa4, checked in by Fernando de Oliveira <fernando@…>, 8 years ago

Updates to Lynx 2.8.8rel.2, Python-3.3.5, MesaLib-10.1.0 and samba-4.1.5. Fix md5sum of mercurial-2.9.1.tar.gz.

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

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