source: networking/netprogs/samba.xml@ d18b639

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

update to samba-4.0.10

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@11965 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 39.0 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 "220740f75035b2221e3b9a848e19d1ea">
10 <!ENTITY samba-size "22 MB">
11 <!ENTITY samba-buildsize "475 MB (up to 900MB additional for all tests)">
12 <!ENTITY samba-time "7.5 SBU (up to 110 SBU to run all tests)">
13]>
14
15<sect1 id="samba" xreflabel="Samba-&samba-version;">
16 <?dbhtml filename="samba.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Samba-&samba-version;</title>
24
25 <indexterm zone="samba">
26 <primary sortas="a-Samba">Samba</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Samba</title>
31
32 <para>The <application>Samba</application> package provides file and print
33 services to SMB/CIFS clients and Windows networking to Linux clients.
34 <application>Samba</application> can also be configured as a Windows Domain
35 Controller replacement, a file/print server acting as a member of a Windows
36 Active Directory domain and a NetBIOS (rfc1001/1002) nameserver (which
37 among other things provides LAN browsing support).</para>
38
39 &lfs74_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>Download (HTTP): <ulink url="&samba-download-http;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download (FTP): <ulink url="&samba-download-ftp;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download MD5 sum: &samba-md5sum;</para>
51 </listitem>
52 <listitem>
53 <para>Download size: &samba-size;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated disk space required: &samba-buildsize;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated build time: &samba-time;</para>
60 </listitem>
61 </itemizedlist>
62
63 <bridgehead renderas="sect3">Samba Dependencies</bridgehead>
64
65 <bridgehead renderas="sect4">Required</bridgehead>
66 <para role="required">
67 <xref linkend="libtirpc"/>
68 </para>
69
70 <bridgehead renderas="sect4">Optional</bridgehead>
71 <para role="optional">
72 <xref linkend="popt"/>,
73 <xref linkend="linux-pam"/>,
74 <xref linkend="cups"/>,
75 <xref linkend="openldap"/>,
76 <xref linkend="gamin"/>,
77 <xref linkend="acl"/>,
78 <xref linkend="xfsprogs"/>,
79 <xref linkend="mitkrb"/>,
80 <xref linkend="python2"/> (used only in parts of the test suite),
81 <xref linkend="libxslt"/> (used only for documentation),
82 <ulink url="http://tdb.samba.org/">tdb</ulink>,
83 <ulink url="http://ctdb.samba.org/">ctdb</ulink>,
84 <xref linkend="libcap2"/>,
85 <ulink url="http://www.nongnu.org/libunwind/">libunwind</ulink>,
86 <xref linkend="avahi"/>,
87 <ulink url="http://www.openafs.org/">OpenAFS</ulink>, and
88 <ulink url="http://valgrind.org/">Valgrind</ulink> (optionally
89 used by the test suite)</para>
90
91 <para condition="html" role="usernotes">User Notes:
92 <ulink url="&blfs-wiki;/samba"/></para>
93
94 </sect2>
95
96 <sect2 role="installation">
97 <title>Installation of Samba</title>
98
99 <note>
100 <para>If you wish to run the test suite after the binaries are built,
101 you must add the <option>--enable-socket-wrapper</option>
102 and <option>--enable-selftest</option> parameters to
103 the <command>configure</command> script below. You may want to run
104 <command>configure</command> with the <option>--help</option> parameter
105 first. There may be other parameters needed to take advantage of
106 optional dependencies.</para>
107 </note>
108
109 <para>Install <application>Samba</application> by running the following
110 commands:</para>
111
112<screen><userinput>sed -i -e "/dmapi_lib/s/$/ldflags='-ltirpc',/" source3/wscript_build &amp;&amp;
113
114./configure \
115 --prefix=/usr \
116 --sysconfdir=/etc \
117 --localstatedir=/var \
118 --with-piddir=/run/samba \
119 --with-pammodulesdir=/lib/security \
120 --enable-fhs \
121 --enable-nss-wrapper &amp;&amp;
122
123make</userinput></screen>
124
125 <para>To test the results, as the <systemitem
126 class="username">root</systemitem> user,issue: <command>make
127 quicktest</command> (about 8 SBU). There are other targets (test,
128 subunit-test) available, but take a very long (over 100 SBU) time.</para>
129
130 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
131
132<screen role="root"><userinput>make install &amp;&amp;
133
134mv -v /usr/lib/libnss_win{s,bind}.so* /lib &amp;&amp;
135ln -v -sf ../../lib/libnss_winbind.so.2 /usr/lib/libnss_winbind.so &amp;&amp;
136ln -v -sf ../../lib/libnss_wins.so.2 /usr/lib/libnss_wins.so &amp;&amp;
137
138install -v -m644 examples/smb.conf.default /etc/samba &amp;&amp;
139
140mkdir -pv /etc/openldap/schema &amp;&amp;
141
142install -v -m644 examples/LDAP/README \
143 /etc/openldap/schema/README.LDAP &amp;&amp;
144
145install -v -m644 examples/LDAP/samba* \
146 /etc/openldap/schema &amp;&amp;
147
148install -v -m755 examples/LDAP/{convert*,get*,ol*} \
149 /etc/openldap/schema &amp;&amp;
150
151install -v -m755 -d /usr/share/doc/samba-&samba-version; &amp;&amp;
152
153install -v -m644 lib/ntdb/doc/design.pdf \
154 /usr/share/doc/samba-&samba-version; &amp;&amp;
155
156ln -v -s ../../samba/swat /usr/share/doc/samba-&samba-version;</userinput></screen>
157
158 <para>To create the html documents needed for <command>swat</command>
159 (<xref linkend='libxslt'/> required), do the following:</para>
160
161<screen><userinput>cd docs-xml &amp;&amp;
162autoreconf &amp;&amp;
163./configure &amp;&amp;
164make htmlman</userinput></screen>
165
166 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
167
168<screen role="root"><userinput>mkdir -pv /usr/share/samba/swat/help/manpages &amp;&amp;
169cp output/htmldocs/manpages/*.html /usr/share/samba/swat/help/manpages</userinput></screen>
170
171 </sect2>
172
173 <sect2 role="commands">
174 <title>Command Explanations</title>
175
176 <para><command>sed ... source3/wscript_build</command>:
177 This command enables the build to complete when using libtirpc instead of
178 the deprecated glibc rpc functions.</para>
179
180 <para><parameter>--sysconfdir=/etc</parameter>: Sets the configuration
181 file directory to avoid the default of
182 <filename class="directory">/usr/etc</filename>.</para>
183
184 <para><parameter>--localstatedir=/var</parameter>: Sets the variable
185 data directory to avoid the default of
186 <filename class="directory">/usr/var</filename>.</para>
187
188 <para><parameter>--enable-fhs</parameter>: Assigns all other file paths in
189 a manner compliant with the Filesystem Hierarchy Standard (FHS).</para>
190
191 <para><parameter>--enable-nss-wrapper</parameter>: Builds the nss-wrapper
192 library.</para>
193
194 <para><option>--enable-socket-wrapper</option> and
195 <option>--enable-selftest</option>: These options are required to run
196 the test suite.</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<!-- mount.cifs is now in the separate cifs-utils package
233 <sect3>
234 <title>Mounting Shares by Unprivileged Users</title>
235
236 <para>If it is desired for unprivileged users to directly mount (and
237 unmount) CIFS shares, the <command>mount.cifs</command> and
238 <command>umount.cifs</command> commands must be setuid
239 <systemitem class='username'>root</systemitem>. Note that users can
240 only mount CIFS shares on a mount point owned by that user (requires
241 write access also). If desired, change these programs to setuid
242 <systemitem class='username'>root</systemitem> by issuing the following
243 command as the <systemitem class='username'>root</systemitem>
244 user:</para>
245
246<screen role="root"><userinput>chmod -v 4755 /usr/sbin/{,u}mount.cifs</userinput></screen>
247
248 </sect3>
249-->
250 <sect3>
251 <title>Printing to SMB Clients</title>
252
253 <para>If you use <application>CUPS</application> for print services,
254 and you wish to print to a printer attached to an SMB client, you
255 need to create an SMB backend device. To create the device, issue the
256 following command as the <systemitem class="username">root</systemitem>
257 user:</para>
258
259<screen role="root"><userinput>ln -v -sf /usr/bin/smbspool /usr/lib/cups/backend/smb</userinput></screen>
260
261 </sect3>
262
263 <sect3>
264 <title>Configuration Information</title>
265
266 <para>Due to the complexity and the many various uses for
267 <application>Samba</application>, complete configuration for all the
268 package's capabilities is well beyond the scope of the BLFS book. This
269 section provides instructions to configure the
270 <filename>/etc/samba/smb.conf</filename> file for two common scenarios.
271 The complete contents of <filename>/etc/samba/smb.conf</filename> will
272 depend on the purpose of <application>Samba</application>
273 installation.</para>
274
275 <note>
276 <para>You may find it easier to copy the configuration parameters shown
277 below into an empty <filename>/etc/samba/smb.conf</filename> file
278 instead of copying and editing the default file as mentioned in the
279 <quote>Command Explanations</quote> section. How you create/edit the
280 <filename>/etc/samba/smb.conf</filename> file will be left up to
281 you. Do ensure the file is only writeable by the
282 <systemitem class="username">root</systemitem> user (mode 644).</para>
283 </note>
284
285 <sect4>
286 <title>Scenario 1: Minimal Standalone Client-Only Installation</title>
287
288 <para>Choose this variant if you only want to transfer files using
289 <command>smbclient</command>, mount Windows shares and print to Windows
290 printers, and don't want to share your files and printers to Windows
291 machines.</para>
292
293 <para>A <filename>/etc/samba/smb.conf</filename> file with the following
294 three parameters is sufficient:</para>
295
296<screen role='root'><literal>[global]
297 workgroup = <replaceable>MYGROUP</replaceable>
298 dos charset = <replaceable>cp850</replaceable>
299 unix charset = <replaceable>ISO-8859-1</replaceable></literal></screen>
300
301 <para>The values in this example specify that the computer belongs to a
302 Windows workgroup named
303 <quote><replaceable>MYGROUP</replaceable></quote>, uses the
304 <quote><replaceable>cp850</replaceable></quote> character set on the
305 wire when talking to MS-DOS and MS Windows 9x, and that the filenames
306 are stored in the <quote><replaceable>ISO-8859-1</replaceable></quote>
307 encoding on the disk. Adjust these values appropriately for your
308 installation. The <quote>unix charset</quote> value must be the same as
309 the output of <command>locale charmap</command> when executed with the
310 <envar>LANG</envar> variable set to your preferred locale, otherwise the
311 <command>ls</command> command may not display correct filenames of
312 downloaded files.</para>
313
314 <para>There is no need to run any <application>Samba</application>
315 servers in this scenario, thus you don't need to install the provided
316 bootscripts.</para>
317
318 </sect4>
319
320 <sect4>
321 <title>Scenario 2: Standalone File/Print Server</title>
322
323 <para>Choose this variant if you want to share your files and printers
324 to Windows machines in your workgroup in addition to the capabilities
325 described in Scenario 1.</para>
326
327 <para>In this case, the <filename>/etc/samba/smb.conf.default</filename>
328 file may be a good template to start from. Also add
329 <quote>dos charset</quote> and <quote>unix charset</quote> parameters
330 to the <quote>[global]</quote> section as described in Scenario 1 in
331 order to prevent filename corruption.</para>
332
333 <para>The following configuration file creates a separate share for each
334 user's home directory and also makes all printers available to Windows
335 machines:</para>
336
337<screen role='root'><literal>[global]
338 workgroup = <replaceable>MYGROUP</replaceable>
339 dos charset = <replaceable>cp850</replaceable>
340 unix charset = <replaceable>ISO-8859-1</replaceable>
341
342[homes]
343 comment = Home Directories
344 browseable = no
345 writable = yes
346
347[printers]
348 comment = All Printers
349 path = /var/spool/samba
350 browseable = no
351 guest ok = no
352 printable = yes</literal></screen>
353
354 <para>Other parameters you may wish to customize in the
355 <quote>[global]</quote> section include:</para>
356
357<screen role='root'><literal> server string =
358 security =
359 hosts allow =
360 load printers =
361 log file =
362 max log size =
363 socket options =
364 local master =</literal></screen>
365
366 <para>Reference the comments in the
367 <filename>/etc/samba/smb.conf.default</filename> file for information
368 regarding these parameters.</para>
369
370 <para>Since the <command>smbd</command> and <command>nmbd</command>
371 daemons are needed in this case, install the <filename>samba</filename>
372 bootscript. Be sure to run <command>smbpasswd</command> (with the
373 <option>-a</option> option to add users) to enable and
374 set passwords for all accounts that need
375 <application>Samba</application> access, or use the SWAT web interface
376 (see below) to do the same. Using the default
377 <application>Samba</application> passdb backend, any user you attempt
378 to add will also be required to exist in the
379 <filename>/etc/passwd</filename> file.</para>
380
381 </sect4>
382
383 <sect4>
384 <title>Advanced Requirements</title>
385
386 <para>More complex scenarios involving domain control or membership are
387 possible. Such setups are advanced topics and cannot be adequately
388 covered in BLFS. Many complete books have been written on these topics
389 alone. Note that in some domain membership scenarios, the
390 <command>winbindd</command> daemon and the corresponding bootscript are
391 needed.</para>
392
393 <para>There is quite a bit of documentation available which covers many
394 of these advanced configurations. Point your web browser to the links
395 below to view some of the documentation included with the
396 <application>Samba</application> package:</para>
397
398 <itemizedlist spacing='compact'>
399 <listitem>
400 <para>Using Samba, 2nd Edition; a popular book published by O'Reilly
401 <ulink url="http://www.samba.org/samba/docs/using_samba/toc.html"/></para>
402 </listitem>
403 <listitem>
404 <para>The Official Samba HOWTO and Reference Guide <ulink
405 url="http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/"/>
406 </para>
407 </listitem>
408 <listitem>
409 <para>Samba-3 by Example
410 <ulink url="http://www.samba.org/samba/docs/man/Samba-Guide/"/>
411 </para>
412 </listitem>
413 <listitem>
414 <para>The Samba-3 man Pages
415 <ulink url="file:///usr/share/samba/swat/help/manpages/samba.7.html"/></para>
416 </listitem>
417 </itemizedlist>
418
419 </sect4>
420
421 <sect4 id="samba-init">
422 <title>Boot Script</title>
423
424 <para>For your convenience, boot scripts have been provided for
425 <application>Samba</application>. There are two included in the
426 <xref linkend="bootscripts"/> package. The first,
427 <filename>samba</filename>, will start the <command>smbd</command>
428 and <command>nmbd</command> daemons needed to provide SMB/CIFS
429 services. The second script, <filename>winbind</filename>, starts
430 the <command>winbindd</command> daemon, used for providing Windows
431 domain services to Linux clients.</para>
432
433 <indexterm zone="samba samba-init">
434 <primary sortas="f-samba">samba</primary>
435 </indexterm>
436
437 <indexterm zone="samba samba-init">
438 <primary sortas="f-winbind">winbind</primary>
439 </indexterm>
440
441 <para>The default <application>Samba</application> installation uses the
442 <systemitem class='username'>nobody</systemitem> user for guest access
443 to the server. This can be overridden by setting the
444 <option>guest account =</option> parameter in the
445 <filename>/etc/samba/smb.conf</filename> file. If you utilize the
446 <option>guest account =</option> parameter, ensure this user exists in
447 the <filename>/etc/passwd</filename> file. To use the default user,
448 issue the following commands as the
449 <systemitem class='username'>root</systemitem> user:</para>
450
451<screen><userinput>groupadd -g 99 nogroup &amp;&amp;
452useradd -c "Unprivileged Nobody" -d /dev/null -g nogroup \
453 -s /bin/false -u 99 nobody</userinput></screen>
454
455 <para>Install the <filename>samba</filename> script with the following
456 command issued as the <systemitem class="username">root</systemitem>
457 user:</para>
458
459<screen role="root"><userinput>make install-samba</userinput></screen>
460
461 <para>If you also need the <filename>winbindd</filename>
462 script to resolve names from Windows clients, run:</para>
463
464<screen role="root"><userinput>make install-winbindd</userinput></screen>
465
466 </sect4>
467
468 </sect3>
469
470 <sect3 id="samba-swat-config">
471 <title>Configuring SWAT</title>
472
473 <para>The SWAT (<application>Samba</application> Web Administration Tool)
474 utility can be used for configuration of the
475 <application>Samba</application> installation.</para>
476
477 <indexterm zone="samba samba-swat-config">
478 <primary sortas="g-configuring-SWAT">Configuring SWAT</primary>
479 </indexterm>
480
481 <sect4>
482 <title>Setting up SWAT using xinetd</title>
483
484 <indexterm zone="samba samba-swat-config">
485 <primary sortas="e-etc-xinetd.conf">/etc/xinetd.conf</primary>
486 </indexterm>
487
488 <para>If not already done, add an entry to <filename>/etc/services</filename> file
489 as the <systemitem class="username">root</systemitem> user:</para>
490
491<screen role="root"><userinput>echo "swat 905/tcp" &gt;&gt; /etc/services</userinput></screen>
492
493 <para>Create the <application>Samba</application> <xref
494 linkend='xinetd'/> file as <filename>/etc/xinetd.d/swat</filename>.</para>
495
496 <warning>
497 <para>You may modify or remove the <quote>only_from</quote> line
498 below to include other host(s). BLFS does not recommend doing this
499 because of the security risk involved. However, in a home network
500 environment, disclosure of the <systemitem
501 class='username'>root</systemitem> password may be an acceptable
502 risk.</para>
503 </warning>
504
505<screen role="root"><userinput>cat &gt;&gt; /etc/xinetd.d/swat &lt;&lt; "EOF"
506<literal># Begin /etc/xinetd.d/swat
507
508service swat
509{
510 port = 905
511 socket_type = stream
512 wait = no
513 instances = 5
514 only_from = 127.0.0.1
515 user = root
516 server = /usr/sbin/swat
517 log_on_failure += USERID
518}
519
520# End /etc/xinetd.d/swat</literal>
521EOF</userinput></screen>
522
523 <para>Issue a <command>killall -HUP xinetd</command> to read the new
524 <filename>/etc/xinetd.d/swat</filename> file.</para>
525
526 <note>
527 <para>If you linked <application>Linux-PAM</application> into the
528 <application>Samba</application> build, you'll need to create an
529 <filename>/etc/pam.d/samba</filename> file.</para>
530 </note>
531
532 <para>SWAT can now be launched by pointing your web browser to
533 http://localhost:905.</para>
534
535 </sect4>
536
537 <sect4>
538 <title>Setting up SWAT using stunnel</title>
539
540 <para>A better way to set up SWAT for network access is through
541 <xref linkend='stunnel'/>. For convenience, a boot scripts has
542 been provided for SWAT via stunnel. First, create the stunnel
543 configuration file:</para>
544
545 <indexterm zone="samba samba-swat-config">
546 <primary sortas="e-etc-stunnel-swat.conf">/etc/stunnel/swat.conf</primary>
547 </indexterm>
548
549<screen role="root"><userinput>cat &gt;&gt; /etc/stunnel/swat.conf &lt;&lt; "EOF"
550<literal>; File: /etc/stunnel/swat.conf
551
552pid = /run/stunnel-swat.pid
553setuid = root
554setgid = root
555cert = /etc/stunnel/stunnel.pem
556
557[swat]
558accept = swat
559exec = /usr/sbin/swat
560</literal>
561EOF</userinput></screen>
562
563 <para>Next, install the swat bootscript:</para>
564
565<screen role="root"><userinput>make install-swat</userinput></screen>
566
567 <para>After starting the SWAT boot script the tool can be accessed by
568 pointing your web browser to https://localhost:905. Note:
569 <emphasis>https</emphasis>. If access to the tool needs to be
570 further restricted, then <xref linkend='iptables'/> can be
571 used.</para>
572
573 </sect4>
574
575 </sect3>
576
577 <sect3>
578 <title/>
579
580
581 <indexterm zone="samba samba-swat-config">
582 <primary sortas="e-etc-pam.d-samba">/etc/pam.d/samba</primary>
583 </indexterm>
584
585 </sect3>
586
587
588 </sect2>
589
590 <sect2 role="content">
591 <title>Contents</title>
592
593 <segmentedlist>
594 <segtitle>Installed Programs</segtitle>
595 <segtitle>Installed Libraries</segtitle>
596 <segtitle>Installed Directories</segtitle>
597
598 <seglistitem>
599
600 <seg>cifsdd, dbwrap_tool, eventlogadm, gentest, ldbadd, ldbdel,
601 ldbedit, ldbmodify, ldbrename, ldbsearch, locktest, masktest, ndrdump,
602 net, nmbd, nmblookup, nmblookup4, ntlm_auth, oLschema2ldif, pdbedit,
603 pidl, profiles, regdiff, regpatch, regshell, regtree, rpcclient, samba,
604 samba_dnsupdate samba_kcc, samba_spnupdate, samba-tool,
605 samba_upgradedns, sharesec, smbcacls, smbclient, smbclient4,
606 smbcontrol, smbcquotas, smbd, smbget, smbpasswd, smbspool, smbstatus,
607 smbta-util, smbtar, smbtree, smbtorture, swat, testparm, tdbbackup,
608 tdbdump, tdbrestore, and tdbtool, winbindd, and wbinfo</seg>
609
610 <seg>libnss_winbind.so, libnss_wins.so, libnetapi.so, libsmbclient.so,
611 libsmbsharemodes.so, libwbclient.so, the pam_winbind.so
612 and pam_smbpass.so PAM libraries, and assorted character set,
613 filesystem and support modules.</seg>
614
615 <seg>/etc/samba, /usr/include/samba-4.0, /usr/lib/samba,
616 /usr/share/samba, /var/cache/samba, /var/lib/samba,
617 /var/log/samba, /var/lock/samba, and /var/run/samba</seg>
618
619 </seglistitem>
620 </segmentedlist>
621
622 <variablelist>
623 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
624 <?dbfo list-presentation="list"?>
625 <?dbhtml list-presentation="table"?>
626
627 <varlistentry id="eventlogadm">
628 <term><command>eventlogadm</command></term>
629 <listitem>
630 <para>is used to write records to eventlogs from STDIN, add the
631 specified source and DLL eventlog registry entries and display the
632 active eventlog names (from <filename>smb.conf</filename>).</para>
633 <indexterm zone="samba eventlogadm">
634 <primary sortas="b-eventlogadm">eventlogadm</primary>
635 </indexterm>
636 </listitem>
637 </varlistentry>
638
639 <varlistentry id="ldbadd">
640 <term><command>ldbadd</command></term>
641 <listitem>
642 <para>is a command-line utility for adding records to an LDB
643 database.</para>
644 <indexterm zone="samba ldbadd">
645 <primary sortas="b-ldbadd">ldbadd</primary>
646 </indexterm>
647 </listitem>
648 </varlistentry>
649
650 <varlistentry id="ldbdel">
651 <term><command>ldbdel</command></term>
652 <listitem>
653 <para>is a command-line program for deleting LDB database
654 records.</para>
655 <indexterm zone="samba ldbdel">
656 <primary sortas="b-ldbdel">ldbdel</primary>
657 </indexterm>
658 </listitem>
659 </varlistentry>
660
661 <varlistentry id="ldbedit">
662 <term><command>ldbedit</command></term>
663 <listitem>
664 <para>allows you to edit LDB databases using your preferred
665 editor.</para>
666 <indexterm zone="samba ldbedit">
667 <primary sortas="b-ldbedit">ldbedit</primary>
668 </indexterm>
669 </listitem>
670 </varlistentry>
671
672 <varlistentry id="ldbmodify">
673 <term><command>ldbmodify</command></term>
674 <listitem>
675 <para>allows you to modify records in an LDB database.</para>
676 <indexterm zone="samba ldbmodify">
677 <primary sortas="b-ldbmodify">ldbmodify</primary>
678 </indexterm>
679 </listitem>
680 </varlistentry>
681
682 <varlistentry id="ldbrename">
683 <term><command>ldbrename</command></term>
684 <listitem>
685 <para>allows you to edit LDB databases using your preferred
686 editor.</para>
687 <indexterm zone="samba ldbrename">
688 <primary sortas="b-ldbrename">ldbrename</primary>
689 </indexterm>
690 </listitem>
691 </varlistentry>
692
693 <varlistentry id="ldbsearch">
694 <term><command>ldbsearch</command></term>
695 <listitem>
696 <para>searches an LDB database for records matching a specified
697 expression.</para>
698 <indexterm zone="samba ldbsearch">
699 <primary sortas="b-ldbsearch">ldbsearch</primary>
700 </indexterm>
701 </listitem>
702 </varlistentry>
703
704 <varlistentry id="net">
705 <term><command>net</command></term>
706 <listitem>
707 <para>is a tool for administration of
708 <application>Samba</application> and remote CIFS servers, similar
709 to the <command>net</command> utility for DOS/Windows.</para>
710 <indexterm zone="samba net">
711 <primary sortas="b-net">net</primary>
712 </indexterm>
713 </listitem>
714 </varlistentry>
715
716 <varlistentry id="nmbd">
717 <term><command>nmbd</command></term>
718 <listitem>
719 <para>is the <application>Samba</application>
720 NetBIOS name server.</para>
721 <indexterm zone="samba nmbd">
722 <primary sortas="b-nmbd">nmbd</primary>
723 </indexterm>
724 </listitem>
725 </varlistentry>
726
727 <varlistentry id="nmblookup">
728 <term><command>nmblookup</command></term>
729 <listitem>
730 <para>is used to query NetBIOS names and map
731 them to IP addresses.</para>
732 <indexterm zone="samba nmblookup">
733 <primary sortas="b-nmblookup">nmblookup</primary>
734 </indexterm>
735 </listitem>
736 </varlistentry>
737
738 <varlistentry id="ntlm_auth">
739 <term><command>ntlm_auth</command></term>
740 <listitem>
741 <para>is a tool to allow external access to Winbind's
742 NTLM authentication function.</para>
743 <indexterm zone="samba ntlm_auth">
744 <primary sortas="b-ntlm_auth">ntlm_auth</primary>
745 </indexterm>
746 </listitem>
747 </varlistentry>
748
749 <varlistentry id="pdbedit">
750 <term><command>pdbedit</command></term>
751 <listitem>
752 <para>is a tool used to manage the SAM database.</para>
753 <indexterm zone="samba pdbedit">
754 <primary sortas="b-pdbedit">pdbedit</primary>
755 </indexterm>
756 </listitem>
757 </varlistentry>
758
759 <varlistentry id="profiles">
760 <term><command>profiles</command></term>
761 <listitem>
762 <para>is a utility that reports and changes SIDs in Windows
763 registry files. It currently only supports Windows NT.</para>
764 <indexterm zone="samba profiles">
765 <primary sortas="b-profiles">profiles</primary>
766 </indexterm>
767 </listitem>
768 </varlistentry>
769
770 <varlistentry id="rpcclient">
771 <term><command>rpcclient</command></term>
772 <listitem>
773 <para>is used to execute MS-RPC client side functions.</para>
774 <indexterm zone="samba rpcclient">
775 <primary sortas="b-rpcclient">rpcclient</primary>
776 </indexterm>
777 </listitem>
778 </varlistentry>
779
780 <varlistentry id="sharesec">
781 <term><command>sharesec</command></term>
782 <listitem>
783 <para>manipulates share ACL permissions on SMB file shares.</para>
784 <indexterm zone="samba sharesec">
785 <primary sortas="b-sharesec">sharesec</primary>
786 </indexterm>
787 </listitem>
788 </varlistentry>
789
790 <varlistentry id="smbcacls">
791 <term><command>smbcacls</command></term>
792 <listitem>
793 <para>is used to manipulate Windows NT access control lists.</para>
794 <indexterm zone="samba smbcacls">
795 <primary sortas="b-smbcacls">smbcacls</primary>
796 </indexterm>
797 </listitem>
798 </varlistentry>
799
800 <varlistentry id="smbclient">
801 <term><command>smbclient</command></term>
802 <listitem>
803 <para>is a SMB/CIFS access utility, similar to FTP.</para>
804 <indexterm zone="samba smbclient">
805 <primary sortas="b-smbclient">smbclient</primary>
806 </indexterm>
807 </listitem>
808 </varlistentry>
809
810 <varlistentry id="smbcontrol">
811 <term><command>smbcontrol</command></term>
812 <listitem>
813 <para>is used to control running <command>smbd</command>,
814 <command>nmbd</command> and <command>winbindd</command>
815 daemons.</para>
816 <indexterm zone="samba smbcontrol">
817 <primary sortas="b-smbcontrol">smbcontrol</primary>
818 </indexterm>
819 </listitem>
820 </varlistentry>
821
822 <varlistentry id="smbcquotas">
823 <term><command>smbcquotas</command></term>
824 <listitem>
825 <para>is used to manipulate Windows NT quotas on
826 SMB file shares.</para>
827 <indexterm zone="samba smbcquotas">
828 <primary sortas="b-smbcquotas">smbcquotas</primary>
829 </indexterm>
830 </listitem>
831 </varlistentry>
832
833 <varlistentry id="smbd">
834 <term><command>smbd</command></term>
835 <listitem>
836 <para>is the main <application>Samba</application> daemon which
837 provides SMB/CIFS services to clients.</para>
838 <indexterm zone="samba smbd">
839 <primary sortas="b-smbd">smbd</primary>
840 </indexterm>
841 </listitem>
842 </varlistentry>
843
844 <varlistentry id="smbget">
845 <term><command>smbget</command></term>
846 <listitem>
847 <para>is a simple utility with <command>wget</command>-like
848 semantics, that can download files from SMB servers. You can specify
849 the files you would like to download on the command-line.</para>
850 <indexterm zone="samba smbget">
851 <primary sortas="b-smbget">smbget</primary>
852 </indexterm>
853 </listitem>
854 </varlistentry>
855
856 <varlistentry id="smbpasswd">
857 <term><command>smbpasswd</command></term>
858 <listitem>
859 <para>changes a user's <application>Samba</application>
860 password.</para>
861 <indexterm zone="samba smbpasswd">
862 <primary sortas="b-smbpasswd">smbpasswd</primary>
863 </indexterm>
864 </listitem>
865 </varlistentry>
866
867 <varlistentry id="smbspool">
868 <term><command>smbspool</command></term>
869 <listitem>
870 <para>sends a print job to an SMB printer.</para>
871 <indexterm zone="samba smbspool">
872 <primary sortas="b-smbspool">smbspool</primary>
873 </indexterm>
874 </listitem>
875 </varlistentry>
876
877 <varlistentry id="smbstatus">
878 <term><command>smbstatus</command></term>
879 <listitem>
880 <para>reports current <application>Samba</application>
881 connections.</para>
882 <indexterm zone="samba smbstatus">
883 <primary sortas="b-smbstatus">smbstatus</primary>
884 </indexterm>
885 </listitem>
886 </varlistentry>
887
888 <varlistentry id="smbtar">
889 <term><command>smbtar</command></term>
890 <listitem>
891 <para>is a shell script used for backing up SMB/CIFS shares
892 directly to Linux tape drives or a file.</para>
893 <indexterm zone="samba smbtar">
894 <primary sortas="b-smbtar">smbtar</primary>
895 </indexterm>
896 </listitem>
897 </varlistentry>
898
899 <varlistentry id="smbtree">
900 <term><command>smbtree</command></term>
901 <listitem>
902 <para>is a text-based SMB network browser.</para>
903 <indexterm zone="samba smbtree">
904 <primary sortas="b-smbtree">smbtree</primary>
905 </indexterm>
906 </listitem>
907 </varlistentry>
908
909 <varlistentry id="swat">
910 <term><command>swat</command></term>
911 <listitem>
912 <para>is the <application>Samba</application> Web Administration
913 Tool.</para>
914 <indexterm zone="samba swat">
915 <primary sortas="b-swat">swat</primary>
916 </indexterm>
917 </listitem>
918 </varlistentry>
919
920 <varlistentry id="tdbbackup">
921 <term><command>tdbbackup</command></term>
922 <listitem>
923 <para>is a tool for backing up or validating the integrity of
924 <application>Samba</application> <filename>.tdb</filename>
925 files.</para>
926 <indexterm zone="samba tdbbackup">
927 <primary sortas="b-tdbbackup">tdbbackup</primary>
928 </indexterm>
929 </listitem>
930 </varlistentry>
931
932 <varlistentry id="tdbdump">
933 <term><command>tdbdump</command></term>
934 <listitem>
935 <para> is a tool used to print the contents of a
936 <application>Samba</application> <filename>.tdb</filename>
937 file.</para>
938 <indexterm zone="samba tdbdump">
939 <primary sortas="b-tdbdump">tdbdump</primary>
940 </indexterm>
941 </listitem>
942 </varlistentry>
943
944 <varlistentry id="tdbtool">
945 <term><command>tdbtool</command></term>
946 <listitem>
947 <para>is a tool which allows simple database manipulation from the
948 command line.</para>
949 <indexterm zone="samba tdbtool">
950 <primary sortas="b-tdbtool">tdbtool</primary>
951 </indexterm>
952 </listitem>
953 </varlistentry>
954
955 <varlistentry id="testparm">
956 <term><command>testparm</command></term>
957 <listitem>
958 <para>checks an <filename>smb.conf</filename> file for proper
959 syntax.</para>
960 <indexterm zone="samba testparm">
961 <primary sortas="b-testparm">testparm</primary>
962 </indexterm>
963 </listitem>
964 </varlistentry>
965
966 <varlistentry id="wbinfo">
967 <term><command>wbinfo</command></term>
968 <listitem>
969 <para>queries a running <command>winbindd</command> daemon.</para>
970 <indexterm zone="samba wbinfo">
971 <primary sortas="b-wbinfo">wbinfo</primary>
972 </indexterm>
973 </listitem>
974 </varlistentry>
975
976 <varlistentry id="winbindd">
977 <term><command>winbindd</command></term>
978 <listitem>
979 <para>resolves names from Windows NT servers.</para>
980 <indexterm zone="samba winbindd">
981 <primary sortas="b-winbindd">winbindd</primary>
982 </indexterm>
983 </listitem>
984 </varlistentry>
985
986 <varlistentry id="libnss_winbind">
987 <term><filename class='libraryfile'>libnss_winbind.so</filename></term>
988 <listitem>
989 <para>provides Name Service Switch API functions for resolving names
990 from NT servers.</para>
991 <indexterm zone="samba libnss_winbind">
992 <primary sortas="c-libnss_winbind">libnss_winbind.so</primary>
993 </indexterm>
994 </listitem>
995 </varlistentry>
996
997 <varlistentry id="libnss_wins">
998 <term><filename class='libraryfile'>libnss_wins.so</filename></term>
999 <listitem>
1000 <para>provides API functions for Samba's implementation of the
1001 Windows Internet Naming Service.</para>
1002 <indexterm zone="samba libnss_wins">
1003 <primary sortas="c-libnss_wins">libnss_wins.so</primary>
1004 </indexterm>
1005 </listitem>
1006 </varlistentry>
1007
1008 <varlistentry id="libnetapi">
1009 <term><filename class='libraryfile'>libnetapi.so</filename></term>
1010 <listitem>
1011 <para>provides the API functions for the administration tools used
1012 for Samba and remote CIFS servers.</para>
1013 <indexterm zone="samba libnetapi">
1014 <primary sortas="c-libnetapi">libnetapi.so</primary>
1015 </indexterm>
1016 </listitem>
1017 </varlistentry>
1018
1019 <varlistentry id="libsmbclient">
1020 <term><filename class='libraryfile'>libsmbclient.so</filename></term>
1021 <listitem>
1022 <para>provides the API functions for the Samba SMB client tools.</para>
1023 <indexterm zone="samba libsmbclient">
1024 <primary sortas="c-libsmbclient">libsmbclient.so</primary>
1025 </indexterm>
1026 </listitem>
1027 </varlistentry>
1028
1029 <varlistentry id="libsmbsharemodes">
1030 <term><filename class='libraryfile'>libsmbsharemodes.so</filename></term>
1031 <listitem>
1032 <para>provides API functions for accessing SMB share modes
1033 (locks etc.)</para>
1034 <indexterm zone="samba libsmbsharemodes">
1035 <primary sortas="c-libsmbsharemodes">libsmbsharemodes.so</primary>
1036 </indexterm>
1037 </listitem>
1038 </varlistentry>
1039
1040 <varlistentry id="libwbclient">
1041 <term><filename class='libraryfile'>libwbclient.so</filename></term>
1042 <listitem>
1043 <para>provides API functions for Windows domain client services.</para>
1044 <indexterm zone="samba libwbclient">
1045 <primary sortas="c-libwbclient">libwbclient.so</primary>
1046 </indexterm>
1047 </listitem>
1048 </varlistentry>
1049
1050 </variablelist>
1051
1052 </sect2>
1053
1054</sect1>
Note: See TracBrowser for help on using the repository browser.