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

systemd-11177
Last change on this file since c1cacc30 was abf6e26b, checked in by Krejzi <krejzi@…>, 10 years ago

More systemd integration merged from Christopher's branch.

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