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

kde5-14686 systemd-13485
Last change on this file since b52520c was b52520c, checked in by Christopher Gregory <cjg@…>, 10 years ago

Merge samba update from trunk.

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