source: networking/netprogs/samba-systemd.xml@ e9e0e8a1

7.6-blfs 7.6-systemd kde5-14269 kde5-14686 systemd-13485
Last change on this file since e9e0e8a1 was e9e0e8a1, checked in by Krejzi <krejzi@…>, 10 years ago

Merged trunk.

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