source: networking/netprogs/samba.xml@ adf6dd9a

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 adf6dd9a was adf6dd9a, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Archive unneeded packages: pkgconfig,

bc, ibus, udev, slib, gamin, and notify-python

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