qi-hardware/openwrt-xburst
1
0
Fork 0
mirror of git://projects.qi-hardware.com/openwrt-xburst.git synced 2024-11-26 08:40:37 +02:00
Code

updated example Makefile and descriptions

Browse Source 
git-svn-id: svn://svn.openwrt.org/openwrt/trunk@1443 3c298f89-4303-0410-b956-a3cf2f4a3e73
This commit is contained in:
wbx 2005-07-15 16:44:34 +00:00
parent b831ba0e07
commit d0844d0d5b
1 changed files with 78 additions and 98 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

174
openwrt/docs/buildroot-documentation.html
View File

@ -452,31 +452,31 @@ foo-compile: bar-compile
<p>Finally, here's the hardest part. Create a file named <p>Finally, here's the hardest part. Create a file named
<code>Makefile</code>. It will contain the <i>Makefile</i> rules that <code>Makefile</code>. It will contain the <i>Makefile</i> rules that
are in charge of downloading, configuring, compiling and installing are in charge of downloading, configuring, compiling and installing
the software. Below is an example that we will comment the software. Below is an example that we will comment afterwards.</p>
afterwards.</p>
<pre> <pre>
1 # $Id$ 1 # $Id$
2 include $(TOPDIR)/rules.mk 2
3 PKG_NAME:=foo 3 include $(TOPDIR)/rules.mk
4 PKG_VERSION:=1.0 4
5 PKG_RELEASE:=1 5 PKG_NAME:=foo
6 PKG_MD5SUM:=4584f226523776a3cdd2fb6f8212ba8d 6 PKG_VERSION:=1.0
8 PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz 7 PKG_RELEASE:=1
9 PKG_SOURCE_URL:=http://www.foosoftware.org/downloads 8 PKG_MD5SUM:=4584f226523776a3cdd2fb6f8212ba8d
10 PKG_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION) 9
11 PKG_IPK:=$(PACKAGE_DIR)/$(PKG_NAME)_$(PKG_VERSION)-$(PKG_RELEASE)_$(ARCH).ipk 10 PKG_SOURCE_URL:=http://www.foosoftware.org/downloads
12 PKG_IPK_DIR:=$(PKG_DIR)/ipkg 11 PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz
12 PKG_CAT:=zcat
13 13
14 $(DL_DIR)/$(PKG_SOURCE): 14 PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION)
15 $(SCRIPT_DIR)/download.pl $(DL_DIR) $(PKG_SOURCE) $(PKG_MD5SUM) $(PKG_SOURCE_URL) 15 PKG_INSTALL_DIR:=$(PKG_BUILD_DIR)/ipkg-install
16 16
17 $(PKG_DIR)/.source: $(DL_DIR)/$(PKG_SOURCE) 17 include $(TOPDIR)/package/rules.mk
18 zcat $(DL_DIR)/$(PKG_SOURCE) | tar -C $(BUILD_DIR) $(TAR_OPTIONS) - 18
19 touch $(PKG_DIR)/.source 19 $(eval $(call PKG_template,FOO,foo,$(PKG_VERSION)-$(PKG_RELEASE),$(ARCH)))
20 20
21 $(PKG_DIR)/.configured: $(PKG_DIR)/.source 21 $(PKG_BUILD_DIR)/.configured: $(PKG_BUILD_DIR)/.prepared
22 (cd $(PKG_DIR); \ 22 (cd $(PKG_BUILD_DIR); \
23 $(TARGET_CONFIGURE_OPTS) \ 23 $(TARGET_CONFIGURE_OPTS) \
24 CFLAGS="$(TARGET_CFLAGS)" \ 24 CFLAGS="$(TARGET_CFLAGS)" \
25 ./configure \ 25 ./configure \
@ -485,36 +485,37 @@ foo-compile: bar-compile
28 --build=$(GNU_HOST_NAME) \ 28 --build=$(GNU_HOST_NAME) \
29 --prefix=/usr \ 29 --prefix=/usr \
30 --sysconfdir=/etc \ 30 --sysconfdir=/etc \
31 ); 31 --with-bar="$(STAGING_DIR)/usr" \
32 touch $(PKG_DIR)/.configured; 32 );
33 33 touch $@
34 $(PKG_DIR)/$(PKG_NAME): $(PKG_DIR)/.configured 34
35 $(MAKE) CC=$(TARGET_CC) -C $(PKG_DIR) 35 $(PKG_BUILD_DIR)/.built:
36 36 rm -rf $(PKG_INSTALL_DIR)
37 $(PKG_IPK): $(PKG_DIR)/$(PKG_NAME) 37 mkdir -p $(PKG_INSTALL_DIR)
38 $(SCRIPT_DIR)/make-ipkg-dir.sh $(PKG_IPK_DIR) $(PKG_NAME).control $(PKG_VERSION)-$(PKG_RELEASE) $(ARCH) 38 $(MAKE) -C $(PKG_BUILD_DIR) \
39 $(MAKE) prefix=$(PKG_IPK_DIR)/usr -C $(PKG_DIR) install 39 $(TARGET_CONFIGURE_OPTS) \
40 rm -Rf $(PKG_IPK_DIR)/usr/man 40 install_prefix="$(PKG_INSTALL_DIR)" \
41 $(IPKG_BUILD) $(PKG_IPK_DIR) $(PACKAGE_DIR) 41 all install
42 42 touch $@
43 $(IPKG_STATE_DIR)/info/$(PKG_NAME).list: $(PKG_IPK) 43
44 $(IPKG) install $(PKG_IPK) 44 $(IPKG_FOO):
45 46 install -d -m0755 $(IDIR_FOO)/usr/sbin
46 prepare: $(PKG_DIR)/.source 47 cp -fpR $(PKG_INSTALL_DIR)/usr/sbin/foo $(IDIR_FOO)/usr/sbin
47 compile: $(PKG_IPK) 49 $(RSTRIP) $(IDIR_FOO)
48 install: $(IPKG_STATE_DIR)/info/$(PKG_NAME).list 50 $(IPKG_BUILD) $(IDIR_FOO) $(PACKAGE_DIR)
49 clean: 51
50 rm -rf $(PKG_DIR) 52 mostlyclean:
51 rm -f $(PKG_IPK) 53 make -C $(PKG_BUILD_DIR) clean
54 rm $(PKG_BUILD_DIR)/.built
</pre> </pre>
<p>First of all, this <i>Makefile</i> example works for a single <p>First of all, this <i>Makefile</i> example works for a single
binary software. For other software such as libraries or more binary software. For other software such as libraries or more
complex stuff with multiple binaries, it should be adapted. Look at complex stuff with multiple binaries, it should be adapted. Look at
the other <code>Makefile</code> files in the <code>package</code> the other <code>Makefile</code> files in the <code>package/</code>
directory.</p> directory.</p>
<p>At lines 3-12, a couple of useful variables are defined :</p> <p>At lines 5-15, a couple of useful variables are defined:</p>
<ul> <ul>
<li><code>PKG_NAME</code> : The package name, e.g. <i>foo</i>.</li> <li><code>PKG_NAME</code> : The package name, e.g. <i>foo</i>.</li>
@ -523,45 +524,42 @@ foo-compile: bar-compile
should be downloaded.</li> should be downloaded.</li>
<li><code>PKG_RELEASE</code> : The release number that will be <li><code>PKG_RELEASE</code> : The release number that will be
appended to the version number of your <i>ipkg</i> package. appended to the version number of your <i>ipkg</i> package.</li>
<li><code>PKG_MD5SUM</code> : The md5sum of the software archive. <li><code>PKG_MD5SUM</code> : The md5sum of the software archive.</li>
<li><code>PKG_SOURCE</code> : The name of the tarball of
your package on the download website of FTP site. As you can see
<code>PKG_NAME</code> and <code>PKG_VERSION</code> are used.</li>
<li><code>PKG_SOURCE_URL</code> : Space separated list of the HTTP <li><code>PKG_SOURCE_URL</code> : Space separated list of the HTTP
or FTP sites from which the archive is downloaded. It must include the complete or FTP sites from which the archive is downloaded. It must include the complete
path to the directory where <code>FOO_SOURCE</code> can be path to the directory where <code>FOO_SOURCE</code> can be
found.</li> found.</li>
<li><code>PKG_DIR</code> : The directory into which the software <li><code>PKG_SOURCE</code> : The name of the tarball of
your package on the download website of FTP site. As you can see
<code>PKG_NAME</code> and <code>PKG_VERSION</code> are used.</li>
<li><code>PKG_CAT</code> : The tool needed for extraction of the
software archive.</li>
<li><code>PKG_BUILD_DIR</code> : The directory into which the software
will be configured and compiled. Basically, it's a subdirectory will be configured and compiled. Basically, it's a subdirectory
of <code>BUILD_DIR</code> which is created upon decompression of of <code>BUILD_DIR</code> which is created upon extraction of
the tarball.</li> the tarball.</li>
<li><code>PKG_IPK</code> : The resulting <i>ipkg</i> package <li><code>PKG_INSTALL_DIR</code> : The directory into the software
will be installed. It is a subdirectory of <code>PKG_BUILD_DIR</code>.</li>
</ul> </ul>
<p>Lines 14-15 defines a target that downloads the tarball from <p>In Line 3 and 17 we include common variables and routines to simplify
the remote site to the download directory the process of ipkg creation. It includes routines to download, verify
(<code>DL_DIR</code>).</p> and extract the software package archives.</p>
<p>Lines 17-19 defines a target and associated rules that <p>Line 19 contains the magic line which automatically creates the
uncompress the downloaded tarball. As you can see, this target ipkg for us.</p>
depends on the tarball file, so that the previous target (line
14-15) is called before executing the rules of the current
target. Uncompressing is followed by <i>touching</i> a hidden file
to mark the software has having been uncompressed. This trick is
used everywhere in Buildroot <i>Makefile</i> to split steps
(download, uncompress, configure, compile, install) while still
having correct dependencies.</p>
<p>Lines 21-32 defines a target and associated rules that <p>Lines 21-33 defines a target and associated rules that
configures the software. It depends on the previous target (the configures the software. It depends on the previous target (the
hidden <code>.source</code> file) so that we are sure the software has hidden <code>.prepared</code> file) so that we are sure the software has
been uncompressed. In order to configure it, it basically runs the been uncompressed. In order to configure it, it basically runs the
well-known <code>./configure</code>script. As we may be doing well-known <code>./configure</code>script. As we may be doing
cross-compilation, <code>target</code>, <code>host</code> and cross-compilation, <code>target</code>, <code>host</code> and
@ -571,41 +569,21 @@ foo-compile: bar-compile
filesystem. Finally it creates a <code>.configured</code> file to filesystem. Finally it creates a <code>.configured</code> file to
mark the software as configured.</p> mark the software as configured.</p>
<p>Lines 34-35 defines a target and a rule that compiles the <p>Lines 35-42 defines a target and a rule that compiles the
software. This target will create the binary file in the software. This target will create the binary file in the
compilation directory, and depends on the software being already compilation directory, and depends on the software being already
configured (hence the reference to the <code>.configured</code> configured (hence the reference to the <code>.configured</code>
file). It basically runs <code>make</code> inside the source file). Afterwards it installs the resulting binary into the
directory.</p> <code>PKG_INSTALL_DIR</code>. It basically runs
<code>make install</code> inside the source directory.</p>
<p>Lines 37-41 defines a target and associated rules that create <p>Lines 44-50 defines a target and associated rules that create
the <i>ipkg</i> package which can optionally be embedded into the <i>ipkg</i> package, which can optionally be embedded into
the resulting firmware image. It depends on the binary file in the resulting firmware image. It manually installs all files you
the source directory, to make sure the software has been compiled. want to integrate in your resulting ipkg. <code>RSTRIP</code> will
It uses the make-ipkg-dir.sh script, which will create the ipkg recursevily strip all binaries and libraries.
build directory for your package, copy your control file into
that directory and add version and architecture information.
Then it calls the <code>install</code> target of the
software <code>Makefile</code> by passing a <code>prefix</code>
argument, so that the <code>Makefile</code> doesn't try to install
the software inside host <code>/usr</code> but inside target
<code>/usr</code>. After the installation, the
<code>/usr/man</code> directory inside the target filesystem is
removed to save space.
Finally <code>IPKG_BUILD</code> is called to create the package.</p> Finally <code>IPKG_BUILD</code> is called to create the package.</p>
<p>Line 43 and 44 define the installation target of your package,
which will embed the software into the target filesystem.</p>
<p>Lines 46-51 define the main targets that the Makefile in the
<code>package</code> dir calls.
<ul>
<li><code>prepare</code> : Download and unpack the source</li>
<li><code>compile</code> : Compile the source and create the package</li>
<li><code>install</code> : Embed the package into the target filesystem</li>
<li><code>clean</code> : Remove all the files created by the build process</li>
</ul></p>
<h3>Conclusion</h3> <h3>Conclusion</h3>
<p>As you can see, adding a software to buildroot is simply a <p>As you can see, adding a software to buildroot is simply a
@ -614,12 +592,14 @@ foo-compile: bar-compile
the software.</p> the software.</p>
<p>If you package software that might be useful for other persons, <p>If you package software that might be useful for other persons,
don't forget to send a patch to OpenWrt developers !</p> don't forget to send a patch to OpenWrt developers!
Use the mail address: patches@openwrt.org
</p>
<h2><a name="links" id="links"></a>Resources</h2> <h2><a name="links" id="links"></a>Resources</h2>
<p>To learn more about OpenWrt Buildroot you can visit this <p>To learn more about OpenWrt you can visit this website:
website: <a href="http://openwrt.org/">http://openwrt.org/</a></p> <a href="http://openwrt.org/">http://openwrt.org/</a></p>
</div> </div>
</body> </body>