source: networking/netprogs/samba.xml@ 5bc57bb

gnome
Last change on this file since 5bc57bb was 5bc57bb, checked in by Christopher Gregory <cjg@…>, 10 years ago

Converted ntp rpcbind rsync samba wpa_supplicant avahi networkmanager and wicd pages to systemd

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/gnome@13414 af4574ff-66df-0310-9fd7-8a98e5e911e0

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