source: networking/netprogs/samba.xml@ 73b06df

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 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 73b06df was 73b06df, checked in by Fernando de Oliveira <fernando@…>, 9 years ago

Archive LXPolkit-0.1.0. Commented out references in gparted and network-manager-applet.
Update to nss-3.17.3.
Update to libgusb-0.2.3.
Update to mercurial-3.2.2.
Update to samba-4.1.14.
Update to gnome-themes-standard-3.14.2.3.
Update to xfce4-power-manager-1.4.2.
Update to thunderbird-31.3.0. Notice the removal of the option MOZ_OBJDIR=@TOPSRCDIR@, and no fix is needed anymore.

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