git.maemo.org Git - samba/blob - docs/htmldocs/using_samba/appe.html

   1 <html>
   2 <body bgcolor="#ffffff">
   3
   4 <img src="samba2_xs.gif" border="0" alt=" " height="100" width="76"
   5 hspace="10" align="left" />
   6
   7 <h1 class="head0">Appendix E. Configure Options</h1>
   8
   9
  10 <p><a name="INDEX-1"/>As we
  11 explained in <a href="ch02.html">Chapter 2</a>, the
  12 <em class="emphasis">configure</em> program is run before the Samba source
  13 code is compiled to fit the compilation process to the local
  14 architecture. At this stage, it is possible to specify options to
  15 customize Samba's behavior further and include or
  16 exclude 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
  21 SMB 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
  24 Japanese-language manual pages. We have picked these three configure
  25 options because they illustrate the usage of the three types of
  26 options that are included up to Samba 3.0. The
  27 <tt class="literal">--with-smbmount</tt> option is a Boolean option, which
  28 can take a value of <tt class="literal">yes</tt> or <tt class="literal">no</tt>.
  29 All the Boolean options are set to <tt class="literal">no</tt> by default,
  30 and it is only necessary to provide the option to turn it on. If you
  31 want to be more explicit, you can specify
  32 <tt class="literal">--with-smbmount=yes</tt>. To turn an option off
  33 explicitly, you can also specify
  34 <tt class="literal">--without-</tt><em class="replaceable">feature</em>
  35 rather 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
  39 be supplied after the equals (<tt class="literal">=</tt>) sign. Some of the
  40 options are used to specify the directories that Samba uses for
  41 various purposes. Only one option is in the last group, where
  42 something other than a directory is specified as an option argument.</p>
  43
  44 <p>The supported configure options vary from release to release. For
  45 example, between Samba 2.2.x and Samba 3.0, many options were
  46 dropped, and a few were added. To get a list of the configure options
  47 for 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
  52 options.</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
 381 to 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
 389 Filesystem (AFS), for authenticating users who are accessing files
 390 through 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
 398 conjunction with NFS, to mount <a name="INDEX-10"/><a name="INDEX-11"/>NFS shares automatically at the
 399 first attempt to access them. You might wish to enable this feature
 400 if any of the directories shared by your Samba server are (or
 401 include) 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
 410 support. See the
 411 &quot;Internationalization&quot; section
 412 earlier in this chapter for more information on this feature. By
 413 default, 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,
 422 usually 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
 431 Distributed Filesystem (DCE/DFS). This is a distributed filesystem
 432 included in some Unix variants and is not the same as
 433 Microsoft'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
 441 locating 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
 450 the local system's <em class="emphasis">popt( )</em>
 451 C-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
 459 directory of the Kerberos distribution. Kerberos is an authentication
 460 protocol developed at MIT that uses private-key cryptography to
 461 provide strong security between nodes. This version is not the same
 462 as Microsoft's adaptation of Kerberos in Active
 463 Directory, which is the preferred version for use with Samba. This
 464 option 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
 472 directory of the Kerberos distribution. This version of Kerberos is
 473 compatible with the Kerberos authentication in
 474 Microsoft's Active Directory used in Windows 2000
 475 and 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
 485 Samba's equivalent to the Windows NT SAM database.
 486 This 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
 494 necessary to specify <tt class="literal">--with-ldapsam</tt> only in Samba
 495 versions 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
 504 exists in the C library to perform conversion between different
 505 character sets. This option allows Samba's default
 506 method of determining the location of the <em class="emphasis">iconv()</em>
 507 library to be overridden. Ordinarily, the configuration
 508 process checks for support in the C library on the system and, if not
 509 found, uses code included in the Samba source tree. Using
 510 <tt class="literal">--with-libiconv</tt>, it is possible to specify
 511 explicitly where the support is located. The include files are
 512 assumed to be in
 513 <em class="replaceable">directory</em><em class="filename">/include</em>,
 514 and library files are assumed to be in
 515 <em class="replaceable">directory</em><em class="filename">/lib</em>. This
 516 option 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
 525 suite to access Samba's features. When
 526 <tt class="literal">--with-libsmbclient</tt> is specified, the library is
 527 built 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
 536 files. 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
 555 are available in different languages. The default is
 556 <tt class="literal">en</tt> for English, and the language can be specified
 557 as <tt class="literal">ja</tt> for Japanese or <tt class="literal">pl</tt> for
 558 Polish.</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
 567 more information on this feature. Specifying this option is necessary
 568 only 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
 577 serving a particular user's home directory and
 578 telling 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
 588 equivalent 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
 598 set to <tt class="literal">yes</tt>, obeys PAM's
 599 configuration regarding account and session management. When
 600 encrypted passwords are in use, Samba uses the
 601 <em class="filename">smbpasswd</em> file for authentication, bypassing the
 602 PAM 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
 612 module called <em class="filename">pam_smbpass.so</em> and places it in
 613 the <em class="filename">source/bin</em> directory. This module allows
 614 applications outside of the Samba suite to authenticate users with
 615 Samba's <em class="filename">smbpasswd</em> file. For
 616 more information, see the <em class="filename">README</em> file in the
 617 <em class="filename">source/pam_smbpass</em> directory of the Samba
 618 distribution 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
 629 data, and PID files for keeping track of the process IDs of the Samba
 630 daemons. 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
 640 related files for
 641 <a name="INDEX-68"/>authentication.
 642 The 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
 650 Samba's internal code. This is normally used only by
 651 the 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
 659 as 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>
 668 support. The <em class="emphasis">readline( )</em> function exists in the
 669 C library to accept a line of input from an interactive user and
 670 provide support for editing and history. Samba uses these functions
 671 in <em class="emphasis">smbclient</em> and <em class="emphasis">rpcclient</em>.</p>
 672
 673 <p>This option allows Samba's default method of
 674 determining the location of the <tt class="function">readline( )</tt>
 675 library to be overridden. Ordinarily, the configuration process
 676 checks for support in the C library on the system and, if not found,
 677 uses code included in the Samba source tree. Using
 678 <tt class="literal">--with-readline</tt>, it is possible to specify the
 679 directory 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
 689 call, which speeds up file transfers by copying data directly to and
 690 from kernel buffers, avoiding the overhead of copying to and from
 691 buffers in user space. If the operating system has the
 692 <em class="emphasis">sendfile( )</em> system call, support is included in
 693 Samba for the <tt class="literal">use</tt> <tt class="literal">sendfile</tt>
 694 configuration file option. This is an experimental option included in
 695 Samba 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
 703 filesystem 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
 712 discussed in <a href="ch05.html">Chapter 5</a>), use this option to
 713 include 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
 722 file locking that uses the <em class="emphasis">fcntl( )</em> C-library
 723 function. Using this option results in a Samba installation that
 724 consumes much more CPU time on the host system. Use it only when
 725 absolutely 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
 734 feature was dropped for Samba 3.0. It still works with Samba 2.2.x
 735 and before, but a better method is to use a <a name="INDEX-95"/>virtual private
 736 network (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.
 745 This 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
 754 versions 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
 772 logging. This option must be specified for the Samba configuration
 773 file parameters <tt class="literal">syslog</tt> and
 774 <tt class="literal">syslog</tt> <tt class="literal">only</tt> to work. This
 775 option is widely supported, but might not work correctly on all Samba
 776 host 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
 784 the Windows NT SAM in a <em class="filename">.tdb</em> database file
 785 rather than in the <em class="filename">smbpasswd</em> file. This is an
 786 experimental 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
 794 system'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
 798 work. This option is widely supported, but might not work correctly
 799 on 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.
 807 Instead of defaulting to <tt class="literal">no</tt>, as with other boolean
 808 options, <tt class="literal">--with-winbind</tt> is
 809 automatically set to <tt class="literal">yes</tt> on systems that support
 810 winbind functionality. The only time you would need to specify this
 811 option 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
 817 operating 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>