source: networking/netprogs/samba.xml@ 67e58a5

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

Updates to libsecret-0.18, gnome-video-effects-0.4.1, mpg123-1.19.0, cups-filters-1.0.48, libfm-1.2.0, pcmanfm-1.2.0 and Samba 4.1.6. Archive LXShortcut-0.1.2. Thanks Armin K. for fixes in libsecret-0.18 and Samba 4.1.6.

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