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

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

Remove references to libcap-pam from packages as nothing needs the pam module. libcap is in LFS.

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