qi-hardware/openwrt-xburst
1
0
Fork 0
mirror of git://projects.qi-hardware.com/openwrt-xburst.git synced 2024-11-25 02:19:20 +02:00
Code

update document with new PKG_MD5SUM

Browse Source 
git-svn-id: svn://svn.openwrt.org/openwrt/trunk@425 3c298f89-4303-0410-b956-a3cf2f4a3e73
This commit is contained in:
wbx 2005-03-23 11:04:47 +00:00
parent 82ba6f7856
commit dba4851257
1 changed files with 72 additions and 69 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -264,11 +264,11 @@
is your architecture). This is where the cross compilation toolchain will is your architecture). This is where the cross compilation toolchain will
be compiled.</li> be compiled.</li>
<li>Setup the staging directory (<code>build_ARCH/staging_dir/</code> by <li>Setup the staging directory (<code>staging_dir_ARCH/</code> by
default). This is where the cross-compilation toolchain will be default). This is where the cross-compilation toolchain will be
installed. If you want to use the same cross-compilation toolchain for installed. If you want to use the same cross-compilation toolchain for
other purposes, such as compiling third-party applications, you can add other purposes, such as compiling third-party applications, you can add
<code>build_ARCH/staging_dir/bin</code> to your PATH, and then use <code>staging_dir_ARCH/bin</code> to your PATH, and then use
<code>arch-linux-gcc</code> to compile your application. In order to <code>arch-linux-gcc</code> to compile your application. In order to
setup this staging directory, it first removes it, and then it creates setup this staging directory, it first removes it, and then it creates
various subdirectories and symlinks inside it.</li> various subdirectories and symlinks inside it.</li>
@ -292,8 +292,8 @@
use the toolchain that was generated by the Buildroot.</p> use the toolchain that was generated by the Buildroot.</p>
<p>The toolchain generated by the Buildroot by default is located in <p>The toolchain generated by the Buildroot by default is located in
<code>build_ARCH/staging_dir/</code>. The simplest way to use it <code>staging_dir_ARCH</code>. The simplest way to use it
is to add <code>build_ARCH/staging_dir/bin/</code> to your PATH is to add <code>staging_dir_ARCH/bin/</code> to your PATH
environment variable, and then to use environment variable, and then to use
<code>arch-linux-gcc</code>, <code>arch-linux-objdump</code>, <code>arch-linux-gcc</code>, <code>arch-linux-objdump</code>,
<code>arch-linux-ld</code>, etc.</p> <code>arch-linux-ld</code>, etc.</p>
@ -304,7 +304,7 @@
<code>~/buildroot/</code>) :</p> <code>~/buildroot/</code>) :</p>
<pre> <pre>
export PATH=$PATH:~/buildroot/build_mipsel/staging_dir/bin/ export PATH=$PATH:~/buildroot/staging_dir_mipsel/bin/
</pre> </pre>
<p>Then you can simply do :</p> <p>Then you can simply do :</p>
@ -324,9 +324,9 @@ mipsel-linux-uclibc-gcc -o foo foo.c
uClibc toolchain outside of buildroot</h2> uClibc toolchain outside of buildroot</h2>
<p>By default, the cross-compilation toolchain is generated inside <p>By default, the cross-compilation toolchain is generated inside
<code>build_ARCH/staging_dir/</code>. But sometimes, it may be useful to <code>staging_dir_ARCH/</code>. But sometimes, it may be useful to
install it somewhere else, so that it can be used to compile other programs install it somewhere else, so that it can be used to compile other programs
or by other users. Moving the <code>build_ARCH/staging_dir/</code> or by other users. Moving the <code>staging_dir_ARCH/</code>
directory elsewhere is <b>not possible</b>, because they are some hardcoded directory elsewhere is <b>not possible</b>, because they are some hardcoded
paths in the toolchain configuration.</p> paths in the toolchain configuration.</p>
@ -334,7 +334,7 @@ mipsel-linux-uclibc-gcc -o foo foo.c
you can configure Buildroot to generate it elsewhere using the you can configure Buildroot to generate it elsewhere using the
option of the configuration tool : <code>Build options -&gt; option of the configuration tool : <code>Build options -&gt;
Toolchain and header file location</code>, which defaults to Toolchain and header file location</code>, which defaults to
<code>$(BUILD_DIR)/staging_dir/</code>.</p> <code>staging_dir_ARCH/</code>.</p>
<h2><a name="downloaded_packages" <h2><a name="downloaded_packages"
id="downloaded_packages"></a>Location of downloaded packages</h2> id="downloaded_packages"></a>Location of downloaded packages</h2>
@ -427,56 +427,57 @@ foo-compile: bar-compile
afterwards.</p> afterwards.</p>
<pre> <pre>
1 ############################################################# 1 # $Id$
2 # foo 2
3 ############################################################# 3 PKG_NAME:=foo
4 PKG_NAME:=foo 4 PKG_VERSION:=1.0
5 PKG_VERSION:=1.0 5 PKG_RELEASE:=1
6 PKG_RELEASE:=1 6 PKG_MD5SUM:=4584f226523776a3cdd2fb6f8212ba8d
7 PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz 7
8 PKG_SITE:=http://www.foosoftware.org/downloads 8 PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz
9 PKG_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION) 9 PKG_SOURCE_URL:=http://www.foosoftware.org/downloads
10 PKG_IPK:=$(PACKAGE_DIR)/$(PKG_NAME)_$(PKG_VERSION)-$(PKG_RELEASE)_$(ARCH).ipk 10 PKG_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(PKG_VERSION)
11 PKG_IPK_DIR:=$(PKG_DIR)/ipkg 11 PKG_IPK:=$(PACKAGE_DIR)/$(PKG_NAME)_$(PKG_VERSION)-$(PKG_RELEASE)_$(ARCH).ipk
12 12 PKG_IPK_DIR:=$(PKG_DIR)/ipkg
13 $(DL_DIR)/$(PKG_SOURCE): 13
14 $(WGET) -P $(DL_DIR) $(PKG_SITE)/$(PKG_SOURCE) 14 $(DL_DIR)/$(PKG_SOURCE):
15 15 $(SCRIPT_DIR)/download.pl $(DL_DIR) $(PKG_SOURCE) $(PKG_MD5SUM) $(PKG_SOURCE_URL)
16 $(PKG_DIR)/.source: $(DL_DIR)/$(PKG_SOURCE) 16
17 zcat $(DL_DIR)/$(PKG_SOURCE) | tar -C $(BUILD_DIR) $(TAR_OPTIONS) - 17 $(PKG_DIR)/.source: $(DL_DIR)/$(PKG_SOURCE)
18 touch $(PKG_DIR)/.source 18 zcat $(DL_DIR)/$(PKG_SOURCE) | tar -C $(BUILD_DIR) $(TAR_OPTIONS) -
19 19 touch $(PKG_DIR)/.source
20 $(PKG_DIR)/.configured: $(PKG_DIR)/.source 20
21 (cd $(PKG_DIR); \ 21 $(PKG_DIR)/.configured: $(PKG_DIR)/.source
22 $(TARGET_CONFIGURE_OPTS) \ 22 (cd $(PKG_DIR); \
23 CFLAGS="$(TARGET_CFLAGS)" \ 23 $(TARGET_CONFIGURE_OPTS) \
24 ./configure \ 24 CFLAGS="$(TARGET_CFLAGS)" \
25 --target=$(GNU_TARGET_NAME) \ 25 ./configure \
26 --host=$(GNU_TARGET_NAME) \ 26 --target=$(GNU_TARGET_NAME) \
27 --build=$(GNU_HOST_NAME) \ 27 --host=$(GNU_TARGET_NAME) \
28 --prefix=/usr \ 28 --build=$(GNU_HOST_NAME) \
29 --sysconfdir=/etc \ 29 --prefix=/usr \
30 ); 30 --sysconfdir=/etc \
31 touch $(PKG_DIR)/.configured; 31 );
32 32 touch $(PKG_DIR)/.configured;
33 $(PKG_DIR)/foo $(PKG_DIR)/.configured 33
34 $(MAKE) CC=$(TARGET_CC) -C $(PKG_DIR) 34 $(PKG_DIR)/foo $(PKG_DIR)/.configured
35 35 $(MAKE) CC=$(TARGET_CC) -C $(PKG_DIR)
36 $(PKG_IPK): $(PKG_DIR)/$(PKG_BINARY) 36
37 $(SCRIPT_DIR)/make-ipkg-dir.sh $(PKG_IPK_DIR) $(PKG_NAME).control $(PKG_VERSION)-$(PKG_RELEASE) $(ARCH) 37 $(PKG_IPK): $(PKG_DIR)/$(PKG_BINARY)
38 $(MAKE) prefix=$(PKG_IPK_DIR)/usr -C $(PKG_DIR) install 38 $(SCRIPT_DIR)/make-ipkg-dir.sh $(PKG_IPK_DIR) $(PKG_NAME).control $(PKG_VERSION)-$(PKG_RELEASE) $(ARCH)
39 rm -Rf $(PKG_IPK_DIR)/usr/man 39 $(MAKE) prefix=$(PKG_IPK_DIR)/usr -C $(PKG_DIR) install
40 $(IPKG_BUILD) $(PKG_IPK_DIR) $(PACKAGE_DIR) 40 rm -Rf $(PKG_IPK_DIR)/usr/man
41 41 $(IPKG_BUILD) $(PKG_IPK_DIR) $(PACKAGE_DIR)
42 $(IPKG_STATE_DIR)/info/$(PKG_NAME).list: $(PKG_IPK) 42
43 $(IPKG) install $(PKG_IPK) 43 $(IPKG_STATE_DIR)/info/$(PKG_NAME).list: $(PKG_IPK)
44 44 $(IPKG) install $(PKG_IPK)
45 prepare: $(PKG_DIR)/.source 45
46 compile: $(PKG_IPK) 46 prepare: $(PKG_DIR)/.source
47 install: $(IPKG_STATE_DIR)/info/$(PKG_NAME).list 47 compile: $(PKG_IPK)
48 clean: 48 install: $(IPKG_STATE_DIR)/info/$(PKG_NAME).list
49 rm -rf $(PKG_DIR) 49 clean:
50 rm -f $(PKG_IPK) 50 rm -rf $(PKG_DIR)
51 rm -f $(PKG_IPK)
</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
@ -485,7 +486,7 @@ foo-compile: bar-compile
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 4-11, a couple of useful variables are defined :</p> <p>At lines 3-12, 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>
@ -496,12 +497,14 @@ foo-compile: bar-compile
<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><code>PKG_MD5SUM</code> : The md5sum of the software archive.
<li><code>PKG_SOURCE</code> : The name of the tarball of <li><code>PKG_SOURCE</code> : The name of the tarball of
your package on the download website of FTP site. As you can see 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> <code>PKG_NAME</code> and <code>PKG_VERSION</code> are used.</li>
<li><code>PKG_SITE</code> : The HTTP or FTP site from which <li><code>PKG_SOURCE_URL</code> : Space separated list of the HTTP
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>
@ -514,21 +517,21 @@ foo-compile: bar-compile
</ul> </ul>
<p>Lines 13-14 defines a target that downloads the tarball from <p>Lines 14-15 defines a target that downloads the tarball from
the remote site to the download directory the remote site to the download directory
(<code>DL_DIR</code>).</p> (<code>DL_DIR</code>).</p>
<p>Lines 16-18 defines a target and associated rules that <p>Lines 17-19 defines a target and associated rules that
uncompress the downloaded tarball. As you can see, this target uncompress the downloaded tarball. As you can see, this target
depends on the tarball file, so that the previous target (line depends on the tarball file, so that the previous target (line
13-14) is called before executing the rules of the current 14-15) is called before executing the rules of the current
target. Uncompressing is followed by <i>touching</i> a hidden file target. Uncompressing is followed by <i>touching</i> a hidden file
to mark the software has having been uncompressed. This trick is to mark the software has having been uncompressed. This trick is
used everywhere in Buildroot <i>Makefile</i> to split steps used everywhere in Buildroot <i>Makefile</i> to split steps
(download, uncompress, configure, compile, install) while still (download, uncompress, configure, compile, install) while still
having correct dependencies.</p> having correct dependencies.</p>
<p>Lines 20-31 defines a target and associated rules that <p>Lines 21-32 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>.source</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
@ -540,14 +543,14 @@ 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 33-34 defines a target and a rule that compiles the <p>Lines 34-35 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). It basically runs <code>make</code> inside the source
directory.</p> directory.</p>
<p>Lines 36-40 defines a target and associated rules that create <p>Lines 37-41 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 depends on the binary file in
the source directory, to make sure the software has been compiled. the source directory, to make sure the software has been compiled.
@ -563,10 +566,10 @@ foo-compile: bar-compile
removed to save space. 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 42 and 43 define the installation target of your package, <p>Line 43 and 44 define the installation target of your package,
which will embed the software into the target filesystem.</p> which will embed the software into the target filesystem.</p>
<p>Lines 45-50 define the main targets that the Makefile in the <p>Lines 46-51 define the main targets that the Makefile in the
<code>package</code> dir calls. <code>package</code> dir calls.
<ul> <ul>
<li><code>prepare</code> : Download and unpack the source</li> <li><code>prepare</code> : Download and unpack the source</li>