1<html>
2<body bgcolor="#ffffff">
3
4<img src="samba2_xs.gif" border="0" alt=" " height="100" width="76"
5hspace="10" align="left" />
6
7<h1 class="head0">Appendix E. Configure Options</h1>
8
9
10<p><a name="INDEX-1"/>As we
11explained in <a href="ch02.html">Chapter 2</a>, the
12<em class="emphasis">configure</em> program is run before the Samba source
13code is compiled to fit the compilation process to the local
14architecture. At this stage, it is possible to specify options to
15customize Samba's behavior further and include or
16exclude features. This is an example of specifying configure options:</p>
17
18<blockquote><pre class="code"># <tt class="userinput"><b>./configure --with-smbmount --with-configdir=/etc/samba --with-manpages-langs=ja</b></tt></pre></blockquote>
19
20<p>This example configures the Samba installation to support mounting
21SMB filesystems, look for the Samba configuration file in
22<em class="filename">/etc/samba</em> (instead of the default location of
23<em class="filename">/usr/local/samba/lib</em>), and install
24Japanese-language manual pages. We have picked these three configure
25options because they illustrate the usage of the three types of
26options that are included up to Samba 3.0. The
27<tt class="literal">--with-smbmount</tt> option is a Boolean option, which
28can take a value of <tt class="literal">yes</tt> or <tt class="literal">no</tt>.
29All the Boolean options are set to <tt class="literal">no</tt> by default,
30and it is only necessary to provide the option to turn it on. If you
31want to be more explicit, you can specify
32<tt class="literal">--with-smbmount=yes</tt>. To turn an option off
33explicitly, you can also specify
34<tt class="literal">--without-</tt><em class="replaceable">feature</em>
35rather than
36<tt class="literal">--with-</tt><em class="replaceable">feature</em><tt class="literal">=no</tt>.</p>
37
38<p>In the case of the other two options we have shown, an argument must
39be supplied after the equals (<tt class="literal">=</tt>) sign. Some of the
40options are used to specify the directories that Samba uses for
41various purposes. Only one option is in the last group, where
42something other than a directory is specified as an option argument.</p>
43
44<p>The supported configure options vary from release to release. For
45example, between Samba 2.2.x and Samba 3.0, many options were
46dropped, and a few were added. To get a list of the configure options
47for your release, use the following command:</p>
48
49<blockquote><pre class="code"># <tt class="userinput"><b>./configure --help</b></tt></pre></blockquote>
50
51<p><a href="appe.html#samba2-APP-E-TABLE-1">Table E-1</a> lists Samba's configure
52options.</p>
53
54<a name="samba2-APP-E-TABLE-1"/><h4 class="head4">Table E-1. Configuration options</h4><table border="1">
55
56
57
58<tr>
59<th>
60<p>Configuration option</p>
61</th>
62<th>
63<p>Description</p>
64</th>
65</tr>
66
67
68<tr>
69<td>
70<p><tt class="literal">--with-acl-support</tt></p>
71</td>
72<td>
73<p>Support Windows NT/2000/XP ACLs</p>
74</td>
75</tr>
76<tr>
77<td>
78<p><tt class="literal">--with-afs</tt></p>
79</td>
80<td>
81<p>Support the Andrew Filesystem (AFS)</p>
82</td>
83</tr>
84<tr>
85<td>
86<p><tt class="literal">--with-automount</tt></p>
87</td>
88<td>
89<p>Support the NFS automounter</p>
90</td>
91</tr>
92<tr>
93<td>
94<p><tt class="literal">--with-codepagedir=</tt><em class="replaceable">dir</em></p>
95</td>
96<td>
97<p>Location of codepage files</p>
98</td>
99</tr>
100<tr>
101<td>
102<p><tt class="literal">--with-configdir=</tt><em class="replaceable">dir</em></p>
103</td>
104<td>
105<p>Location of configuration files</p>
106</td>
107</tr>
108<tr>
109<td>
110<p><tt class="literal">--with-dce-dfs</tt></p>
111</td>
112<td>
113<p>Support DCE/DFS</p>
114</td>
115</tr>
116<tr>
117<td>
118<p><tt class="literal">--with-fhs</tt></p>
119</td>
120<td>
121<p>Use FHS-compliant locations of files</p>
122</td>
123</tr>
124<tr>
125<td>
126<p><tt class="literal">--with-included-popt</tt></p>
127</td>
128<td>
129<p>Use Samba's <em class="emphasis">popt(  )</em></p>
130</td>
131</tr>
132<tr>
133<td>
134<p><tt class="literal">--with-krb4=base-</tt><em class="replaceable">dir</em></p>
135</td>
136<td>
137<p>Support Kerberos 4</p>
138</td>
139</tr>
140<tr>
141<td>
142<p><tt class="literal">--with-krb5=base-</tt><em class="replaceable">dir</em></p>
143</td>
144<td>
145<p>Support Kerberos 5 (Microsoft ADS)</p>
146</td>
147</tr>
148<tr>
149<td>
150<p><tt class="literal">--with-ldapsam</tt></p>
151</td>
152<td>
153<p>Support LDAP SAM</p>
154</td>
155</tr>
156<tr>
157<td>
158<p><tt class="literal">--with-libiconv=</tt><em class="replaceable">directory</em></p>
159</td>
160<td>
161<p>Specify <em class="filename">iconv</em> library</p>
162</td>
163</tr>
164<tr>
165<td>
166<p><tt class="literal">--with-libsmbclient</tt></p>
167</td>
168<td>
169<p>Build <em class="filename">smbclient</em> library</p>
170</td>
171</tr>
172<tr>
173<td>
174<p><tt class="literal">--with-lockdir=</tt><em class="replaceable">directory</em></p>
175</td>
176<td>
177<p>Location of lock files</p>
178</td>
179</tr>
180<tr>
181<td>
182<p><tt class="literal">--with-logfilebase=</tt><em class="replaceable">directory</em></p>
183</td>
184<td>
185<p>Location of log files</p>
186</td>
187</tr>
188<tr>
189<td>
190<p><tt class="literal">--with-manpages-langs=</tt><em class="replaceable">language</em></p>
191</td>
192<td>
193<p>Specify language for manual pages</p>
194</td>
195</tr>
196<tr>
197<td>
198<p><tt class="literal">--with-msdfs</tt></p>
199</td>
200<td>
201<p>Support Microsoft Dfs</p>
202</td>
203</tr>
204<tr>
205<td>
206<p><tt class="literal">--with-nisplus-home</tt></p>
207</td>
208<td>
209<p>Support NIS+ home directories</p>
210</td>
211</tr>
212<tr>
213<td>
214<p><tt class="literal">--with-nisplussam</tt></p>
215</td>
216<td>
217<p>Support NIS+ SAM</p>
218</td>
219</tr>
220<tr>
221<td>
222<p><tt class="literal">--with-pam</tt></p>
223</td>
224<td>
225<p>Support PAM restrictions</p>
226</td>
227</tr>
228<tr>
229<td>
230<p><tt class="literal">--with-pam_smbpass</tt></p>
231</td>
232<td>
233<p>Build <em class="filename">pam_smbpass.so</em> PAM module</p>
234</td>
235</tr>
236<tr>
237<td>
238<p><tt class="literal">--with-piddir=</tt><em class="replaceable">directory</em></p>
239</td>
240<td>
241<p>Location of PID files</p>
242</td>
243</tr>
244<tr>
245<td>
246<p><tt class="literal">--with-privatedir=</tt><em class="replaceable">directory</em></p>
247</td>
248<td>
249<p>Location of <em class="filename">smbpasswd</em> file</p>
250</td>
251</tr>
252<tr>
253<td>
254<p><tt class="literal">--with-profiling-data</tt></p>
255</td>
256<td>
257<p>Support gathering of profiling information</p>
258</td>
259</tr>
260<tr>
261<td>
262<p><tt class="literal">--with-quotas</tt></p>
263</td>
264<td>
265<p>Support disk quotas</p>
266</td>
267</tr>
268<tr>
269<td>
270<p><tt class="literal">--with-readline=</tt><em class="replaceable">directory</em></p>
271</td>
272<td>
273<p>Specify readline library</p>
274</td>
275</tr>
276<tr>
277<td>
278<p><tt class="literal">--with-sendfile-support</tt></p>
279</td>
280<td>
281<p>Support <em class="emphasis">sendfile</em>(  ) system call</p>
282</td>
283</tr>
284<tr>
285<td>
286<p><tt class="literal">--with-smbmount</tt></p>
287</td>
288<td>
289<p>Support <em class="emphasis">smbmount</em> and smbfs</p>
290</td>
291</tr>
292<tr>
293<td>
294<p><tt class="literal">--with-smbwrapper</tt></p>
295</td>
296<td>
297<p>Build <em class="filename">smbwrapper</em> library for
298<em class="emphasis">smbsh</em> support</p>
299</td>
300</tr>
301<tr>
302<td>
303<p><tt class="literal">--with-spinlocks</tt></p>
304</td>
305<td>
306<p>Use spinlocks instead of fcntl locks</p>
307</td>
308</tr>
309<tr>
310<td>
311<p><tt class="literal">--with-ssl</tt></p>
312</td>
313<td>
314<p>Support SSL</p>
315</td>
316</tr>
317<tr>
318<td>
319<p><tt class="literal">--with-sslinc=</tt><em class="replaceable">directory</em></p>
320</td>
321<td>
322<p>Location of SSL include files</p>
323</td>
324</tr>
325<tr>
326<td>
327<p><tt class="literal">--with-ssllib=</tt><em class="replaceable">directory</em></p>
328</td>
329<td>
330<p>Location of SSL libraries</p>
331</td>
332</tr>
333<tr>
334<td>
335<p><tt class="literal">--with-swatdir=</tt><em class="replaceable">directory</em></p>
336</td>
337<td>
338<p>Location of SWAT files</p>
339</td>
340</tr>
341<tr>
342<td>
343<p><tt class="literal">--with-syslog</tt></p>
344</td>
345<td>
346<p>Support syslog message logging</p>
347</td>
348</tr>
349<tr>
350<td>
351<p><tt class="literal">--with-tdbsam</tt></p>
352</td>
353<td>
354<p>Support TDB database files for SAM</p>
355</td>
356</tr>
357<tr>
358<td>
359<p><tt class="literal">--with-utmp</tt></p>
360</td>
361<td>
362<p>Support utmp file accounting</p>
363</td>
364</tr>
365<tr>
366<td>
367<p><tt class="literal">--with-winbind</tt></p>
368</td>
369<td>
370<p>Build winbind</p>
371</td>
372</tr>
373
374</table>
375
376<dl>
377<dt><b><tt class="literal">--with-acl-support</tt><a name="INDEX-2"/><a name="INDEX-3"/></b></dt>
378<dd>
379<p>Includes support for Windows NT/2000/XP access control lists
380(<a name="INDEX-4"/>ACLs). For this to work, you need
381to have POSIX ACL support in the host operating system. See <a href="ch08.html">Chapter 8</a> for details.</p>
382</dd>
383
384
385
386<dt><b><tt class="literal">--with-afs</tt><a name="INDEX-5"/><a name="INDEX-6"/></b></dt>
387<dd>
388<p>Includes support for the <a name="INDEX-7"/>Andrew
389Filesystem (AFS), for authenticating users who are accessing files
390through AFS.</p>
391</dd>
392
393
394
395<dt><b><tt class="literal">--with-automount</tt><a name="INDEX-8"/><a name="INDEX-9"/></b></dt>
396<dd>
397<p>Includes support for the automounter, a feature often used in
398conjunction with NFS, to mount <a name="INDEX-10"/><a name="INDEX-11"/>NFS shares automatically at the
399first attempt to access them. You might wish to enable this feature
400if any of the directories shared by your Samba server are (or
401include) NFS-mounted directories.</p>
402</dd>
403
404
405
406<dt><b><tt class="literal">--with-codepagedir</tt><a name="INDEX-12"/><a name="INDEX-13"/>=<em class="replaceable">directory</em></b></dt>
407<dd>
408<p>Specifies the directory in which to put codepage files for
409<a name="INDEX-14"/>internationalization
410support. See the
411&quot;Internationalization&quot; section
412earlier in this chapter for more information on this feature. By
413default, this directory is
414<em class="filename">/usr/local/samba/lib/codepages</em>.</p>
415</dd>
416
417
418
419<dt><b><tt class="literal">--with-configdir</tt><a name="INDEX-15"/><a name="INDEX-16"/>=<em class="replaceable">directory</em></b></dt>
420<dd>
421<p>Specifies the directory in which Samba keeps its configuration file,
422usually called <em class="filename">smb.conf</em>. By default, this is
423<em class="filename">/usr/local/samba/lib</em>.</p>
424</dd>
425
426
427
428<dt><b><tt class="literal">--with-dce-dfs</tt><a name="INDEX-17"/><a name="INDEX-18"/></b></dt>
429<dd>
430<p>Includes support for the <a name="INDEX-19"/>Distributed Computing Environment
431Distributed Filesystem (DCE/DFS). This is a distributed filesystem
432included in some Unix variants and is not the same as
433Microsoft's Distributed Filesystem (Dfs).</p>
434</dd>
435
436
437
438<dt><b><tt class="literal">--with-fhs</tt><a name="INDEX-20"/><a name="INDEX-21"/></b></dt>
439<dd>
440<p>Adheres to the <a name="INDEX-22"/>Filesystem Hierarchy Standard when
441locating files. For details, see <a href="http://www.pathname.com/fhs">http://www.pathname.com/fhs</a>.</p>
442</dd>
443
444
445
446<dt><b><tt class="literal">--with-included-popt</tt><a name="INDEX-23"/><a name="INDEX-24"/></b></dt>
447<dd>
448<p>Includes Samba's own support for parsing
449<a name="INDEX-25"/>command-line options, instead of using
450the local system's <em class="emphasis">popt( )</em>
451C-library function.</p>
452</dd>
453
454
455
456<dt><b><tt class="literal">--with-krb4</tt><a name="INDEX-26"/><a name="INDEX-27"/>=<em class="replaceable">base-dir</em></b></dt>
457<dd>
458<p>Includes support for <a name="INDEX-28"/>Kerberos Version 4.0, specifying the base
459directory of the Kerberos distribution. Kerberos is an authentication
460protocol developed at MIT that uses private-key cryptography to
461provide strong security between nodes. This version is not the same
462as Microsoft's adaptation of Kerberos in Active
463Directory, which is the preferred version for use with Samba. This
464option exists only in versions of Samba earlier than 3.0.</p>
465</dd>
466
467
468
469<dt><b><tt class="literal">--with-krb5</tt><a name="INDEX-29"/><a name="INDEX-30"/>=<em class="replaceable">base-dir</em></b></dt>
470<dd>
471<p>Includes support for Kerberos Version 5.0, specifying the base
472directory of the Kerberos distribution. This version of Kerberos is
473compatible with the Kerberos authentication in
474Microsoft's Active Directory used in Windows 2000
475and Windows XP.</p>
476</dd>
477
478
479
480<dt><b><tt class="literal">--with-ldapsam</tt><a name="INDEX-31"/><a name="INDEX-32"/></b></dt>
481<dd>
482<p>Includes support for using
483<a name="INDEX-33"/>LDAP instead of the
484<em class="filename">smbpasswd</em> file for maintaining
485Samba's equivalent to the Windows NT SAM database.
486This option is necessary to use the parameters
487<tt class="literal">ldap</tt> <tt class="literal">admin</tt>
488<tt class="literal">dn</tt>, <tt class="literal">ldap</tt>
489<tt class="literal">filter</tt>, <tt class="literal">ldap</tt>
490<tt class="literal">port</tt>, <tt class="literal">ldap</tt>
491<tt class="literal">server</tt>, <tt class="literal">ldap</tt>
492<tt class="literal">ssl</tt>, and <tt class="literal">ldap</tt>
493<tt class="literal">suffix</tt> in the Samba configuration file. It is
494necessary to specify <tt class="literal">--with-ldapsam</tt> only in Samba
495versions prior to 3.0.</p>
496</dd>
497
498
499
500<dt><b><tt class="literal">--with-libiconv</tt><a name="INDEX-34"/><a name="INDEX-35"/>=<em class="replaceable">directory</em></b></dt>
501<dd>
502<p>Specifies a location for <em class="emphasis">iconv( )</em> support. The
503<a name="INDEX-36"/><em class="emphasis">iconv( )</em> function
504exists in the C library to perform conversion between different
505character sets. This option allows Samba's default
506method of determining the location of the <em class="emphasis">iconv()</em> 
507library to be overridden. Ordinarily, the configuration
508process checks for support in the C library on the system and, if not
509found, uses code included in the Samba source tree. Using
510<tt class="literal">--with-libiconv</tt>, it is possible to specify
511explicitly where the support is located. The include files are
512assumed to be in
513<em class="replaceable">directory</em><em class="filename">/include</em>,
514and library files are assumed to be in
515<em class="replaceable">directory</em><em class="filename">/lib</em>. This
516option is new in Samba 3.0.</p>
517</dd>
518
519
520
521<dt><b><tt class="literal">--with-libsmbclient</tt><a name="INDEX-37"/><a name="INDEX-38"/></b></dt>
522<dd>
523<p>Allows applications outside the
524<a name="INDEX-39"/>Samba
525suite to access Samba's features. When
526<tt class="literal">--with-libsmbclient</tt> is specified, the library is
527built during the compilation process.</p>
528</dd>
529
530
531
532<dt><b><tt class="literal">--with-lockdir</tt><a name="INDEX-40"/><a name="INDEX-41"/>=<em class="replaceable">directory</em></b></dt>
533<dd>
534<p>Specifies the directory in which Samba keeps
535<a name="INDEX-42"/>lock
536files. By default this directory is
537<em class="filename">/usr/local/samba/var/locks</em>.</p>
538</dd>
539
540
541
542<dt><b><tt class="literal">--with-logfilebase</tt><a name="INDEX-43"/><a name="INDEX-44"/>=<em class="replaceable">directory</em></b></dt>
543<dd>
544<p>Specifies the directory in which Samba keeps <a name="INDEX-45"/>log files for the
545<em class="emphasis">smbd</em>, <em class="emphasis">nmbd</em>, and
546<em class="emphasis">winbindd</em> daemons. This defaults to
547<em class="filename">/usr/local/samba/var</em>.</p>
548</dd>
549
550
551
552<dt><b><tt class="literal">--with-manpages-langs</tt><a name="INDEX-46"/><a name="INDEX-47"/>=<em class="replaceable">language</em></b></dt>
553<dd>
554<p>Starting with Samba 3.0, <a name="INDEX-48"/><a name="INDEX-49"/>Samba's manual pages
555are available in different languages. The default is
556<tt class="literal">en</tt> for English, and the language can be specified
557as <tt class="literal">ja</tt> for Japanese or <tt class="literal">pl</tt> for
558Polish.</p>
559</dd>
560
561
562
563<dt><b><tt class="literal">--with-msdfs</tt><a name="INDEX-50"/><a name="INDEX-51"/></b></dt>
564<dd>
565<p>Includes support for Microsoft Distributed Filesystem
566(<a name="INDEX-52"/>Dfs). See <a href="ch08.html">Chapter 8</a> for
567more information on this feature. Specifying this option is necessary
568only in Samba versions prior to 3.0.</p>
569</dd>
570
571
572
573<dt><b><tt class="literal">--with-nisplus-home</tt><a name="INDEX-53"/><a name="INDEX-54"/></b></dt>
574<dd>
575<p>Includes support for locating the
576<a name="INDEX-55"/>NIS+ server that is
577serving a particular user's home directory and
578telling the client to connect to it. Use
579<tt class="literal">--with-automount</tt> along with this option.</p>
580</dd>
581
582
583
584<dt><b><tt class="literal">--with-nisplussam</tt><a name="INDEX-56"/><a name="INDEX-57"/></b></dt>
585<dd>
586<p>Includes support for integrating
587<a name="INDEX-58"/>NIS+ into Samba's
588equivalent of the Windows NT password database.</p>
589</dd>
590
591
592
593<dt><b><tt class="literal">--with-pam</tt><a name="INDEX-59"/><a name="INDEX-60"/></b></dt>
594<dd>
595<p>When this configure option is specified and the parameter
596<tt class="literal">obey</tt> <tt class="literal">pam</tt>
597<tt class="literal">restrictions</tt> in the Samba configuration file is
598set to <tt class="literal">yes</tt>, obeys PAM's
599configuration regarding account and session management. When
600encrypted passwords are in use, Samba uses the
601<em class="filename">smbpasswd</em> file for authentication, bypassing the
602PAM subsystem. Therefore, this option works only when
603<tt class="literal">encrypt</tt> <tt class="literal">passwords</tt> is set to
604<tt class="literal">no</tt>.</p>
605</dd>
606
607
608
609<dt><b><tt class="literal">--with-pam_smbpass</tt><a name="INDEX-61"/><a name="INDEX-62"/></b></dt>
610<dd>
611<p>When this option is specified, the compilation process builds a PAM
612module called <em class="filename">pam_smbpass.so</em> and places it in
613the <em class="filename">source/bin</em> directory. This module allows
614applications outside of the Samba suite to authenticate users with
615Samba's <em class="filename">smbpasswd</em> file. For
616more information, see the <em class="filename">README</em> file in the
617<em class="filename">source/pam_smbpass</em> directory of the Samba
618distribution and the file
619<em class="filename">PAM-Authentication-And-Samba.html</em> in the
620<em class="filename">docs/html</em> directory.</p>
621</dd>
622
623
624
625<dt><b><tt class="literal">--with-piddir</tt><a name="INDEX-63"/><a name="INDEX-64"/>=<em class="replaceable">directory</em></b></dt>
626<dd>
627<p>Specifies the directory in which Samba keeps files such as
628<a name="INDEX-65"/>browse lists, WINS
629data, and PID files for keeping track of the process IDs of the Samba
630daemons. The default is
631<em class="filename">/usr/local/samba/var/locks</em>.</p>
632</dd>
633
634
635
636<dt><b><tt class="literal">--with-privatedir</tt><a name="INDEX-66"/><a name="INDEX-67"/>=<em class="replaceable">directory</em></b></dt>
637<dd>
638<p>Specifies the directory in which Samba keeps the
639<em class="filename">smbpasswd</em>, <em class="filename">secrets.tdb,</em> and
640related files for
641<a name="INDEX-68"/>authentication.
642The default is <em class="filename">/usr/local/samba/private</em>.</p>
643</dd>
644
645
646
647<dt><b><tt class="literal">--with-profiling-data</tt><a name="INDEX-69"/><a name="INDEX-70"/></b></dt>
648<dd>
649<p>Includes support for analyzing the execution time of
650Samba's internal code. This is normally used only by
651the Samba developers.</p>
652</dd>
653
654
655
656<dt><b><tt class="literal">--with-quotas</tt><a name="INDEX-71"/><a name="INDEX-72"/></b></dt>
657<dd>
658<p>Includes <a name="INDEX-73"/>disk-quota support. This is classified
659as an experimental option by the Samba developers.</p>
660</dd>
661
662
663
664<dt><b><tt class="literal">--with-readline</tt><a name="INDEX-74"/><a name="INDEX-75"/>=<em class="replaceable">directory</em></b></dt>
665<dd>
666<p>Specifies a location for
667<a name="INDEX-76"/><em class="emphasis">readline( )</em>
668support. The <em class="emphasis">readline( )</em> function exists in the
669C library to accept a line of input from an interactive user and
670provide support for editing and history. Samba uses these functions
671in <em class="emphasis">smbclient</em> and <em class="emphasis">rpcclient</em>.</p>
672
673<p>This option allows Samba's default method of
674determining the location of the <tt class="function">readline( )</tt>
675library to be overridden. Ordinarily, the configuration process
676checks for support in the C library on the system and, if not found,
677uses code included in the Samba source tree. Using
678<tt class="literal">--with-readline</tt>, it is possible to specify the
679directory explicitly in which the library containing
680<em class="emphasis">readline( )</em> is located.</p>
681</dd>
682
683
684
685<dt><b><tt class="literal">--with-sendfile-support</tt><a name="INDEX-77"/><a name="INDEX-78"/></b></dt>
686<dd>
687<p>Checks to see if the Samba host operating system supports the
688<a name="INDEX-79"/><em class="emphasis">sendfile( )</em> system
689call, which speeds up file transfers by copying data directly to and
690from kernel buffers, avoiding the overhead of copying to and from
691buffers in user space. If the operating system has the
692<em class="emphasis">sendfile( )</em> system call, support is included in
693Samba for the <tt class="literal">use</tt> <tt class="literal">sendfile</tt>
694configuration file option. This is an experimental option included in
695Samba 2.2.5 and later versions.</p>
696</dd>
697
698
699
700<dt><b><tt class="literal">--with-smbmount</tt><a name="INDEX-80"/><a name="INDEX-81"/></b></dt>
701<dd>
702<p>Must be specified if you want to mount SMB shares in your Unix
703filesystem using the <em class="filename"/><a name="INDEX-82"/>smbfs</em> filesystem and the
704<em class="emphasis">smbmount</em><a name="INDEX-83"/> command, as discussed in <a href="ch05.html">Chapter 5</a>. Currently, this works only with Linux.</p>
705</dd>
706
707
708
709<dt><b><tt class="literal">--with-smbwrapper</tt><a name="INDEX-84"/><a name="INDEX-85"/></b></dt>
710<dd>
711<p>To use <a name="INDEX-86"/>smbsh to access SMB shares from Unix (as
712discussed in <a href="ch05.html">Chapter 5</a>), use this option to
713include the
714<em class="filename">smbwrapper</em><a name="INDEX-87"/> library.</p>
715</dd>
716
717
718
719<dt><b><tt class="literal">--with-spinlocks</tt><a name="INDEX-88"/><a name="INDEX-89"/></b></dt>
720<dd>
721<p>Uses <a name="INDEX-90"/><a name="INDEX-91"/>spin locks instead of the normal method of
722file locking that uses the <em class="emphasis">fcntl( )</em> C-library
723function. Using this option results in a Samba installation that
724consumes much more CPU time on the host system. Use it only when
725absolutely necessary.</p>
726</dd>
727
728
729
730<dt><b><tt class="literal">--with-ssl</tt><a name="INDEX-92"/><a name="INDEX-93"/></b></dt>
731<dd>
732<p>Includes support for running Samba with
733<a name="INDEX-94"/>SSL encryption. This little-used
734feature was dropped for Samba 3.0. It still works with Samba 2.2.x
735and before, but a better method is to use a <a name="INDEX-95"/>virtual private
736network (VPN).</p>
737</dd>
738
739
740
741<dt><b><tt class="literal">--with-sslinc</tt><a name="INDEX-96"/><a name="INDEX-97"/>=<em class="replaceable">directory</em></b></dt>
742<dd>
743<p>Specifies the location of the SSL include files.
744<em class="filename">/usr/local/ssl/include</em> is the default location.
745This option exists in versions prior to Samba 3.0.</p>
746</dd>
747
748
749
750<dt><b><tt class="literal">--with-ssllib</tt><a name="INDEX-98"/><a name="INDEX-99"/>=<em class="replaceable">directory</em></b></dt>
751<dd>
752<p>Specifies the location of the SSL libraries. The default location is
753<em class="filename">/usr/local/ssl/lib</em>. This option exists in
754versions prior to Samba 3.0.</p>
755</dd>
756
757
758
759<dt><b><tt class="literal">--with-swatdir</tt><a name="INDEX-100"/><a name="INDEX-101"/>=<em class="replaceable">directory</em></b></dt>
760<dd>
761<p>Specifies where to install the files for
762<a name="INDEX-102"/>SWAT.
763<em class="filename">/usr/local/samba/swat</em> is the default location.</p>
764</dd>
765
766
767
768<dt><b><tt class="literal">--with-syslog</tt><a name="INDEX-103"/><a name="INDEX-104"/></b></dt>
769<dd>
770<p>Includes support for
771<a name="INDEX-105"/>syslog error
772logging. This option must be specified for the Samba configuration
773file parameters <tt class="literal">syslog</tt> and
774<tt class="literal">syslog</tt> <tt class="literal">only</tt> to work. This
775option is widely supported, but might not work correctly on all Samba
776host systems.</p>
777</dd>
778
779
780
781<dt><b><tt class="literal">--with-tdbsam</tt><a name="INDEX-106"/><a name="INDEX-107"/></b></dt>
782<dd>
783<p>Includes support for keeping Samba's equivalent of
784the Windows NT SAM in a <em class="filename">.tdb</em> database file
785rather than in the <em class="filename">smbpasswd</em> file. This is an
786experimental feature.</p>
787</dd>
788
789
790
791<dt><b><tt class="literal">--with-utmp</tt><a name="INDEX-108"/><a name="INDEX-109"/></b></dt>
792<dd>
793<p>Includes support for <a name="INDEX-110"/>user accounting in the
794system's
795<em class="filename">utmp</em><a name="INDEX-111"/> file. It is necessary for the
796<tt class="literal">utmp</tt> and <tt class="literal">utmp</tt>
797<tt class="literal">directory</tt> Samba configuration file options to
798work. This option is widely supported, but might not work correctly
799on all Samba host systems.</p>
800</dd>
801
802
803
804<dt><b><tt class="literal">--with-winbind</tt><a name="INDEX-112"/><a name="INDEX-113"/></b></dt>
805<dd>
806<p>Includes <a name="INDEX-114"/>winbind support in Samba.
807Instead of defaulting to <tt class="literal">no</tt>, as with other boolean
808options, <tt class="literal">--with-winbind</tt> is
809automatically set to <tt class="literal">yes</tt> on systems that support
810winbind functionality. The only time you would need to specify this
811option is to turn it off, like this:</p>
812
813
814<blockquote><pre class="code"># <tt class="userinput"><b>configure --without-winbind</b></tt></pre></blockquote>
815
816<p>This excludes winbind functionality from Samba even when the local
817operating system can support it. For more information on winbind, see
818<a href="ch09.html">Chapter 9</a>. <a name="INDEX-115"/></p>
819</dd>
820
821</dl>
822
823
824
825<hr/><h4 class="head4"><a href="toc.html">TOC</a></h4>
826</body></html>
827