source: networking/netprogs/samba-systemd.xml@ 48b8d407

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

Remove double -i.

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