1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 40. How to Compile Samba</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="The Official Samba-3 HOWTO and Reference Guide"><link rel="up" href="Appendix.html" title="Part VI. Reference Section"><link rel="prev" href="Appendix.html" title="Part VI. Reference Section"><link rel="next" href="Portability.html" title="Chapter 41. Portability"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 40. How to Compile Samba</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="Appendix.html">Prev</a> </td><th width="60%" align="center">Part VI. Reference Section</th><td width="20%" align="right"> <a accesskey="n" href="Portability.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="compiling"></a>Chapter 40. How to Compile Samba</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Jelmer</span> <span class="othername">R.</span> <span class="surname">Vernooij</span></h3><div class="affiliation"><span class="orgname">The Samba Team<br></span><div class="address"><p><code class="email"><<a href="mailto:jelmer@samba.org">jelmer@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a href="mailto:jht@samba.org">jht@samba.org</a>></code></p></div></div></div></div><div><div class="author"><h3 class="author"><span class="firstname">Andrew</span> <span class="surname">Tridgell</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email"><<a href="mailto:tridge@samba.org">tridge@samba.org</a>></code></p></div></div></div></div><div><p class="pubdate"> 22 May 2001 </p></div><div><p class="pubdate"> 18 March 2003 </p></div><div><p class="pubdate"> June 2005 </p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="compiling.html#id2653301">Access Samba Source Code via Subversion</a></span></dt><dd><dl><dt><span class="sect2"><a href="compiling.html#id2653307">Introduction</a></span></dt><dt><span class="sect2"><a href="compiling.html#id2653348">Subversion Access to samba.org</a></span></dt></dl></dd><dt><span class="sect1"><a href="compiling.html#id2653539">Accessing the Samba Sources via rsync and ftp</a></span></dt><dt><span class="sect1"><a href="compiling.html#id2653614">Verifying Samba's PGP Signature</a></span></dt><dt><span class="sect1"><a href="compiling.html#id2653752">Building the Binaries</a></span></dt><dd><dl><dt><span class="sect2"><a href="compiling.html#id2653989">Compiling Samba with Active Directory Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="compiling.html#startingSamba">Starting the <span class="application">smbd</span> <span class="application">nmbd</span> and <span class="application">winbindd</span></a></span></dt><dd><dl><dt><span class="sect2"><a href="compiling.html#id2654259">Starting from inetd.conf</a></span></dt><dt><span class="sect2"><a href="compiling.html#id2654476">Alternative: Starting <span class="application">smbd</span> as a Daemon</a></span></dt></dl></dd></dl></div><p>
2 You can obtain the Samba source file from the
3 <a href="http://samba.org/" target="_top">Samba Web site</a>. To obtain a development version,
4 you can download Samba from Subversion or using <span><strong class="command">rsync</strong></span>.
5 </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2653301"></a>Access Samba Source Code via Subversion</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2653307"></a>Introduction</h3></div></div></div><p>
6 <a class="indexterm" name="id2653315"></a>
7 Samba is developed in an open environment. Developers use a
8 Subversion to “<span class="quote">checkin</span>” (also known as
9 “<span class="quote">commit</span>”) new source code. Samba's various Subversion branches can
10 be accessed via anonymous Subversion using the instructions
11 detailed in this chapter.
13 This chapter is a modified version of the instructions found at the
14 <a href="http://samba.org/samba/subversion.html" target="_top">Samba</a> Web site.
15 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2653348"></a>Subversion Access to samba.org</h3></div></div></div><p>
16 The machine samba.org runs a publicly accessible Subversion
17 repository for access to the source code of several packages,
18 including Samba, rsync, distcc, ccache, and jitterbug. There are two main ways
19 of accessing the Subversion server on this host.
20 </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2653362"></a>Access via SVNweb</h4></div></div></div><p>
21 <a class="indexterm" name="id2653369"></a>
22 You can access the source code via your favorite WWW browser. This allows you to access
23 the contents of individual files in the repository and also to look at the revision
24 history and commit logs of individual files. You can also ask for a diff
25 listing between any two versions on the repository.
28 <a href="http://svnweb.samba.org/" target="_top">http://svnweb.samba.org/</a>.
29 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2653397"></a>Access via Subversion</h4></div></div></div><p>
30 <a class="indexterm" name="id2653405"></a>
31 You can also access the source code via a normal Subversion client. This gives you much more control over what
32 you can do with the repository and allows you to check out whole source trees and keep them up to date via
33 normal Subversion commands. This is the preferred method of access if you are a developer and not just a
35 </p><p>In order to be able to download the Samba sources off Subversion, you need
36 a Subversion client. Your distribution might include one, or you can download the
37 sources from <a href="http://subversion.tigris.org/" target="_top">http://subversion.tigris.org/</a>.
39 To gain access via anonymous Subversion, use the following steps.
40 </p><div class="procedure"><a name="id2653438"></a><p class="title"><b>Procedure 40.1. Retrieving Samba using Subversion</b></p><ol type="1"><li><p>
41 Install a recent copy of Subversion. All you really need is a
42 copy of the Subversion client binary.
45 </p><pre class="screen">
46 <strong class="userinput"><code>svn co svn://svnanon.samba.org/samba/trunk samba</code></strong>.
49 This will create a directory called <code class="filename">samba</code> containing the
50 latest Samba source code (usually the branch that is going to be the next major release). This
51 currently corresponds to the 3.1 development tree.
53 Subversion branches other then trunk can be obtained by adding branches/BRANCH_NAME to the URL you check
54 out. A list of branch names can be found on the “<span class="quote">Development</span>” page of the Samba Web site. A
55 common request is to obtain the latest 3.0 release code. This could be done by using the following command:
56 </p><pre class="screen">
57 <strong class="userinput"><code>svn co svn://svnanon.samba.org/samba/branches/SAMBA_3_0 samba_3</code></strong>.
60 Whenever you want to merge in the latest code changes, use the following command from within the Samba
62 </p><pre class="screen">
63 <strong class="userinput"><code>svn update</code></strong>
65 </p></li></ol></div></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2653539"></a>Accessing the Samba Sources via rsync and ftp</h2></div></div></div><p>
66 <a class="indexterm" name="id2653548"></a>
67 <a class="indexterm" name="id2653555"></a>
68 <em class="parameter"><code>pserver.samba.org</code></em> also exports unpacked copies of most parts of the Subversion tree
69 at the Samba <a href="ftp://pserver.samba.org/pub/unpacked" target="_top">pserver</a> location and also
70 via anonymous rsync at the Samba <a href="rsync://pserver.samba.org/ftp/unpacked/" target="_top">rsync</a> server location. I recommend using rsync rather
71 than ftp, because rsync is capable of compressing data streams, but it is also more useful than FTP because
72 during a partial update it will transfer only the data that is missing plus a small overhead. See <a href="http://rsync.samba.org/" target="_top">the rsync home page</a> for more info on rsync.
74 The disadvantage of the unpacked trees is that they do not support automatic
75 merging of local changes as Subversion does. <span><strong class="command">rsync</strong></span> access is most convenient
76 for an initial install.
77 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2653614"></a>Verifying Samba's PGP Signature</h2></div></div></div><p>
78 <a class="indexterm" name="id2653622"></a>
79 <a class="indexterm" name="id2653629"></a>
80 It is strongly recommended that you verify the PGP signature for any source file before
81 installing it. Even if you're not downloading from a mirror site, verifying PGP signatures
82 should be a standard reflex. Many people today use the GNU GPG tool set in place of PGP.
83 GPG can substitute for PGP.
85 With that said, go ahead and download the following files:
86 </p><pre class="screen">
87 <code class="prompt">$ </code><strong class="userinput"><code>wget http://us1.samba.org/samba/ftp/samba-3.0.20.tar.asc</code></strong>
88 <code class="prompt">$ </code><strong class="userinput"><code>wget http://us1.samba.org/samba/ftp/samba-pubkey.asc</code></strong>
90 <a class="indexterm" name="id2653677"></a>
91 The first file is the PGP signature for the Samba source file; the other is the Samba public
92 PGP key itself. Import the public PGP key with:
93 </p><pre class="screen">
94 <code class="prompt">$ </code><strong class="userinput"><code>gpg --import samba-pubkey.asc</code></strong>
96 and verify the Samba source code integrity with:
97 </p><pre class="screen">
98 <code class="prompt">$ </code><strong class="userinput"><code>gzip -d samba-3.0.20.tar.gz</code></strong>
99 <code class="prompt">$ </code><strong class="userinput"><code>gpg --verify samba-3.0.20.tar.asc</code></strong>
102 If you receive a message like, “<span class="quote">Good signature from Samba Distribution Verification Key...,</span>”
103 then all is well. The warnings about trust relationships can be ignored. An
104 example of what you would not want to see would be:
105 </p><pre class="screen">
106 gpg: BAD signature from “<span class="quote">Samba Distribution Verification Key</span>”
108 </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2653752"></a>Building the Binaries</h2></div></div></div><p>
109 <a class="indexterm" name="id2653760"></a>
110 <a class="indexterm" name="id2653767"></a>
111 After the source tarball has been unpacked, the next step involves
112 configuration to match Samba to your operating system platform.
113 If your source directory does not contain the <span><strong class="command">configure</strong></span> script,
114 it is necessary to build it before you can continue. Building of
115 the configure script requires the correct version of the autoconf
116 tool kit. Where the necessary version of autoconf is present,
117 the configure script can be generated by executing the following:
118 </p><pre class="screen">
119 <code class="prompt">root# </code> cd samba-3.0.20/source
120 <code class="prompt">root# </code> ./autogen.sh
123 <a class="indexterm" name="id2653809"></a>
124 To build the binaries, run the program <strong class="userinput"><code>./configure
125 </code></strong> in the source directory. This should automatically
126 configure Samba for your operating system. If you have unusual
127 needs, then you may wish to first run:
128 </p><pre class="screen">
129 <code class="prompt">root# </code><strong class="userinput"><code>./configure --help</code></strong>
132 This will help you to see what special options can be enabled. Now execute
133 <strong class="userinput"><code>./configure</code></strong> with any arguments it might need:
134 </p><pre class="screen">
135 <code class="prompt">root# </code><strong class="userinput"><code>./configure <em class="replaceable"><code>[... arguments ...]</code></em></code></strong>
138 <a class="indexterm" name="id2653874"></a>
139 Execute the following create the binaries:
140 </p><pre class="screen">
141 <code class="prompt">root# </code> <strong class="userinput"><code>make</code></strong>
143 Once it is successfully compiled, you can execute the command shown here to
144 install the binaries and manual pages:
145 </p><pre class="screen">
146 <code class="prompt">root# </code> <strong class="userinput"><code>make install</code></strong>
149 Some people prefer to install binary files and man pages separately. If this is
150 your wish, the binary files can be installed by executing:
151 </p><pre class="screen">
152 <code class="prompt">root# </code> <strong class="userinput"><code>make installbin</code></strong>
154 The man pages can be installed using this command:
155 </p><pre class="screen">
156 <code class="prompt">root# </code> <strong class="userinput"><code>make installman</code></strong>
159 Note that if you are upgrading from a previous version of Samba the old
160 versions of the binaries will be renamed with an “<span class="quote">.old</span>” extension.
161 You can go back to the previous version by executing:
162 </p><pre class="screen">
163 <code class="prompt">root# </code> <strong class="userinput"><code>make revert</code></strong>
165 As you can see from this, building and installing Samba does not need to
167 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2653989"></a>Compiling Samba with Active Directory Support</h3></div></div></div><p>
168 In order to compile Samba with ADS support, you need to have installed
170 </p><div class="itemizedlist"><ul type="disc"><li><p>
171 The MIT or Heimdal Kerberos development libraries
172 (either install from the sources or use a package).
174 The OpenLDAP development libraries.
175 </p></li></ul></div><p>
176 If your Kerberos libraries are in a nonstandard location, then
177 remember to add the configure option
178 <code class="option">--with-krb5=<em class="replaceable"><code>DIR</code></em></code>.
180 After you run configure, make sure that the
181 <code class="filename">include/config.h</code> it generates contain lines like this:
182 </p><pre class="programlisting">
187 If it does not, configure did not find your KRB5 libraries or
188 your LDAP libraries. Look in <code class="filename">config.log</code> to figure
190 </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2654055"></a>Installing the Required Packages for Debian</h4></div></div></div><p>On Debian, you need to install the following packages:</p><p>
191 </p><div class="itemizedlist"><ul type="disc"><li><p>libkrb5-dev</p></li><li><p>krb5-user</p></li></ul></div><p>
192 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2654082"></a>Installing the Required Packages for Red Hat Linux</h4></div></div></div><p>On Red Hat Linux, this means you should have at least: </p><p>
193 </p><div class="itemizedlist"><ul type="disc"><li><p>krb5-workstation (for kinit)</p></li><li><p>krb5-libs (for linking with)</p></li><li><p>krb5-devel (because you are compiling from source)</p></li></ul></div><p>
194 </p><p>in addition to the standard development environment.</p><p>If these files are not installed on your system, you should check the installation
195 CDs to find which has them and install the files using your tool of choice. If in doubt
196 about what tool to use, refer to the Red Hat Linux documentation.</p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2654126"></a>SuSE Linux Package Requirements</h4></div></div></div><p>
197 SuSE Linux installs Heimdal packages that may be required to allow you to build
198 binary packages. You should verify that the development libraries have been installed on
201 SuSE Linux Samba RPMs support Kerberos. Please refer to the documentation for
202 your SuSE Linux system for information regarding SuSE Linux specific configuration.
203 Additionally, SuSE is very active in the maintenance of Samba packages that provide
204 the maximum capabilities that are available. You should consider using SuSE-provided
205 packages where they are available.
206 </p></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="startingSamba"></a>Starting the <span class="application">smbd</span> <span class="application">nmbd</span> and <span class="application">winbindd</span></h2></div></div></div><p>
207 <a class="indexterm" name="id2654180"></a>
208 You must choose to start <span class="application">smbd</span>, <span class="application">winbindd</span> and <span class="application">nmbd</span> either as daemons or from
209 <span class="application">inetd</span>. Don't try to do both! Either you can put
210 them in <code class="filename"> inetd.conf</code> and have them started on demand by
211 <span class="application">inetd</span> or <span class="application">xinetd</span>, or you
212 can start them as daemons either from the command-line or in
213 <code class="filename">/etc/rc.local</code>. See the man pages for details on the
214 command line options. Take particular care to read the bit about what user
215 you need to have to start Samba. In many cases, you must be root.
217 The main advantage of starting <span class="application">smbd</span> and <span class="application">nmbd</span> using the recommended daemon method
218 is that they will respond slightly more quickly to an initial connection request.
219 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2654259"></a>Starting from inetd.conf</h3></div></div></div><a class="indexterm" name="id2654265"></a><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The following will be different if
220 you use NIS, NIS+, or LDAP to distribute services maps.</p></div><p>Look at your <code class="filename">/etc/services</code>.
221 What is defined at port 139/tcp? If nothing is defined,
222 then add a line like this:</p><pre class="programlisting">netbios-ssn 139/tcp</pre><p>Similarly for 137/udp, you should have an entry like:</p><pre class="programlisting">netbios-ns 137/udp</pre><p>
223 Next, edit your <code class="filename">/etc/inetd.conf</code> and add two lines like this:
224 </p><pre class="programlisting">
225 netbios-ssn stream tcp nowait root /usr/local/samba/sbin/smbd smbd
226 netbios-ns dgram udp wait root /usr/local/samba/sbin/nmbd nmbd
228 </p><a class="indexterm" name="id2654328"></a><p>
229 The exact syntax of <code class="filename">/etc/inetd.conf</code>
230 varies between UNIXes. Look at the other entries in inetd.conf
233 <a class="indexterm" name="id2654348"></a>
234 Some distributions use xinetd instead of inetd. Consult the
235 xinetd manual for configuration information.
236 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Some UNIXes already have entries like netbios_ns
237 (note the underscore) in <code class="filename">/etc/services</code>.
238 You must edit <code class="filename">/etc/services</code> or
239 <code class="filename">/etc/inetd.conf</code> to make them consistent.
240 </p></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
241 <a class="indexterm" name="id2654386"></a>
242 On many systems you may need to use the
243 <a class="indexterm" name="id2654393"></a>interfaces option in <code class="filename">smb.conf</code> to specify
244 the IP address and netmask of your interfaces. Run
245 <span class="application">ifconfig</span> as root if you do
246 not know what the broadcast is for your net. <span class="application">nmbd</span> tries
247 to determine it at runtime, but fails on some UNIXes.
248 </p></div><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
249 Many UNIXes only accept around five parameters on the command
250 line in <code class="filename">inetd.conf</code>. This means you shouldn't
251 use spaces between the options and arguments, or you should use
252 a script and start the script from <span><strong class="command">inetd</strong></span>.
254 Restart <span class="application">inetd</span>, perhaps just send it a HUP,
256 <a class="indexterm" name="id2654451"></a>
257 </p><pre class="screen">
258 <code class="prompt">root# </code><strong class="userinput"><code>killall -HUP inetd</code></strong>
260 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2654476"></a>Alternative: Starting <span class="application">smbd</span> as a Daemon</h3></div></div></div><p>
261 <a class="indexterm" name="id2654490"></a>
262 <a class="indexterm" name="id2654497"></a>
263 To start the server as a daemon, you should create a script something
264 like this one, perhaps calling it <code class="filename">startsmb</code>.
265 </p><pre class="programlisting">
267 /usr/local/samba/sbin/smbd -D
268 /usr/local/samba/sbin/winbindd -B
269 /usr/local/samba/sbin/nmbd -D
271 Make it executable with <span><strong class="command">chmod +x startsmb</strong></span>.
273 You can then run <span><strong class="command">startsmb</strong></span> by hand or execute
274 it from <code class="filename">/etc/rc.local</code>.
276 To kill it, send a kill signal to the processes <span class="application">nmbd</span> and <span class="application">smbd</span>.
277 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
278 If you use the SVR4-style init system, you may like to look at the
279 <code class="filename">examples/svr4-startup</code> script to make Samba fit
281 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2654575"></a>Starting Samba for Red Hat Linux</h4></div></div></div><p>
282 Red Hat Linux has not always included all Samba components in the standard installation.
283 So versions of Red Hat Linux do not install the winbind utility, even though it is present
284 on the installation CDROM media. Check to see if the <span><strong class="command">winbindd</strong></span> is present
286 </p><pre class="screen">
287 <code class="prompt">root# </code> ls /usr/sbin/winbindd
290 This means that the appropriate RPM package was installed. The following response means
291 that it is not installed:
292 </p><pre class="screen">
293 /bin/ls: /usr/sbin/winbind: No such file or directory
295 In this case, it should be installed if you intend to use <span><strong class="command">winbindd</strong></span>. Search
296 the CDROM installation media for the samba-winbind RPM and install it following Red Hat
299 The process for starting Samba will now be outlined. Be sure to configure Samba's <code class="filename">smb.conf</code>
300 file before starting Samba. When configured, start Samba by executing:
301 </p><pre class="screen">
302 <code class="prompt">root# </code> service smb start
303 <code class="prompt">root# </code> service winbind start
305 These steps will start <span class="application">nmbd</span>, <span class="application">smbd</span> and <span class="application">winbindd</span>.
307 To ensure that these services will be automatically restarted when the system is rebooted
309 </p><pre class="screen">
310 <code class="prompt">root# </code> chkconfig smb on
311 <code class="prompt">root# </code> chkconfig winbind on
313 Samba will be started automatically at every system reboot.
314 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2654697"></a>Starting Samba for Novell SUSE Linux</h4></div></div></div><p>
315 Novell SUSE Linux products automatically install all essential Samba components in a default installation.
316 Configure your <code class="filename">smb.conf</code> file, then execute the following to start Samba:
317 </p><pre class="screen">
318 <code class="prompt">root# </code> rcnmb start
319 <code class="prompt">root# </code> rcsmb start
320 <code class="prompt">root# </code> rcwinbind start
322 Now execute these commands so that Samba will be started automatically following a system
324 </p><pre class="screen">
325 <code class="prompt">root# </code> chkconfig nmb on
326 <code class="prompt">root# </code> chkconfig smb on
327 <code class="prompt">root# </code> chkconfig winbind on
329 The Samba services will now be started automatically following a system reboot.
330 </p></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Appendix.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Appendix.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Portability.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part VI. Reference Section </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 41. Portability</td></tr></table></div></body></html>
projects / samba / blob