Appendix C. Configure Options

As we explained in Chapter 2, the configure program is run before the Samba source code is compiled to adapt the build process to the local architecture. At this stage, it is possible to specify options to customize Samba's behavior further and include or exclude features. Here is an example of specifying configure options:

 $ ./configure --prefix    =/opt/samba --with-acl-support     

This example specification configures the Samba installation to install in /opt/samba rather than the default of /usr/local/samba and to include support for filesystem ACLs. We have picked these two configure options because they illustrate the usage of the two types of options that are included in versions up to Samba 3.0. The --with-acl-support option is a Boolean option, which can take a value of yes or no. If you want to be more explicit, you can specify --with-acl-support=yes. To turn an option off explicitly, you can also specify --without-feature rather than --with-feature=no.

Options such as --prefix are following by an equal sign (=) and one or more arguments. In this case, we are specifying a directory to be used as the software's install root.

The supported configure options vary from release to release. To get a list of the configure options for your release, use the following command:

 $ ./configure --help 

Table C-1 lists the configure options found in the 3.0.22 release.

Table C-1. Configuration options

Configuration option	Description
--enable-cups	Use the CUPS client libraries when communicating with cupsd to manage printers and print jobs.
--enable-debug	Build Samba to include debugging symbols for use with debuggers such as gdb.
--enable-developer	Enable additional compiler flags and other developer settings.
--enable-dmalloc	Enable integration with the dmalloc memory debugging library.
--enable-iprint	Include support for the iPrint server libraries from Novell.
--enable-pie	Turn on support for Position Independent Executables (PIE) when compiling.
--enable-socket-wrapper	Replace basic network socket support with a local communication needed to run make test.
--with-aio-support	Support asynchronous disk I/O.
--with-acl-support	Support Unix filesystem ACLs.
--with-ads	Include support for Active Directory integratio (requires --with-krb5 and --with-ldap).
--with-afs	Support clear-text logins to access Andrew Filesystem (AFS) mounts.
--with-automount	Support locating home directories in NIS automount maps.
--with-cfenc=directory	Use internal CoreFoundation encoding API when building on OS X/Darwin.
--with-cifsmount	Build the Linux CIFS filesystem mount helper utilities.
--with-configdir=directory	Location of configuration files.
--with-dce-dfs	Support clear-text logins to access DCE/DFS mounts.
--with-fake-kaserver	Include AFS Kerberos Authentication (KA) server support.
--with-fhs	Use FHS-compliant locations of files.
--with-included-popt	Use Samba's popt( ) libraries rather than the system version.
--with-krb5=base-dir	Support Kerberos 5 (required for ADS support).
--with-ldap	Support communicating with LDAP directory services (required for ADS support).
--with-libiconv=directory	Specify the location of the iconv library.
--with-libmsrpc	Build the MS-RPC client library.
--with-libsmbclient	Build the SMB/CIFS client library.
--with-libsmbsharemodes	Build the share modes tdb library.
--with-lockdir=directory	Location of lock files.
--with-logfilebase=directory	Location of logfiles.
--with-pam	Enable PAM support in smbd.
--with-pam_smbpass	Build pam_smbpass.so PAM module.
--with-piddir=directory	Location of PID files.
--with-privatedir=directory	Location of smbpasswd file.
--with-profiling-data	Support gathering of profiling information.
--with-quotas	Support interaction with filesystem disk quotas.
--with-readline=directory	Enable support for the readline library.
--with-sendfile-support	Support sendfile( ) system call.
--with-smbmount	Support smbmount and smbfs.
--with-smbtorture4-path=path	Specify the location of the smbtorture tool from the SAMBA_4_0 SVN branch for use in make test.
--with-spinlocks	Use spinlocks instead of fcntl locks.
--with-static-modules=modules --with-shared-modules=modules	List plug-ins that should be linked statically into Samba or built as shared libraries.
--with-swatdir=directory	Location of SWAT files.
--with-syslog	Support syslog message logging.
--with-sys-quotas	Include support for Samba's filesystem quota abstraction layer.
--with-utmp	Support utmp file accounting.
--with-vfs-afsacl	Inlucde the AFS ACL Virtual Filesystem (VFS) plug-in.
--with-winbind	Build Winbind support.