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"Internationalization" 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