source: networking/netprogs/samba.xml@ 7c4f32b

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

LXQt 0.9.1: typos.
Xorg-Server-1.17.2: typo.
PIN-Entry-0.9.5: attempt to clarify fixes when building pinentry-qt4.
WebKitGTK+-2.8.4: include switch to build and install MiniBrowser, good
test if there are build problems and can be useful for simple browsing.
Update to NetworkManager-1.0.4.
Update to network-manager-applet-1.0.4.
Update to Samba-4.2.3.
Update to libepoxy-1.3.1.

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