source: networking/netprogs/samba-systemd.xml@ 99673f0

systemd-13485
Last change on this file since 99673f0 was abf03a85, checked in by Douglas R. Reno <renodr@…>, 9 years ago

Update to samba-4.3.0
Update to libgcrypt-1.6.4
Update to gvfs-1.24.2
Update to nautilus-3.16.2
Update to zenity-3.16.3
Update to gnome-bluetooth-3.16.1
Update to xf86-input-wacom-0.31.0
Update to NSS-3.20
Update to gnome-settings-daemon-3.16.3
Update to cracklib-2.9.6 and cracklib-words-2.9.6
Update to libpwquality-1.3.0
Update to appstream-glib-0.5.0
Update to cheese-3.16.1
Update to ibus-1.5.11
Update to network-manager-applet-1.0.6
Update to exiv2-0.25
Update to gnome-color-manager-3.16.0
Update to gnome-control-center-3.16.3
Update to libinput-1.0.1
Update to mutter-3.16.3
Update to gnome-shell-3.16.3
Update to gnome-shell-extensions-3.16.2
Update to gnome-session-3.16.0
Update to gdm-3.16.2
Update to gnome-user-docs-3.16.1
Update to yelp-3.16.1

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