Update INSTALL

That patch should merge my accidentally written INSTALL file with that
already present in the git tree.

It adds following items:

    - static compilation
    - cross compilation

And updates the instructions to build the auto-generated files to use the
"bootstrap" script already present.

Signed-off-by: Bernhard Walle <bwalle@suse.de>
Signed-off-by: Simon Horman <horms@verge.net.au>
This commit is contained in:
Bernhard Walle
2008-08-26 11:11:59 +02:00
committed by Simon Horman
parent ffe7ad8976
commit 76e8efd603

83
INSTALL
View File

@@ -1,38 +1,77 @@
To build kexec-tools
Installation
============
1. If ./include/config.h.in doesn't exist, create it
# autoheader
Checkout from git
-----------------
If you obtain kexec-tools from a released tarball, you can ommit this
step. If on the other hand you obtain kexec-tools from git or some
other revision control system, then you will probably need to do this.
If you use the tarball, you can just skip that section. If you checked out the
kexec-tools from git repository, you have to build the Autoconf-generated
file yourself with running
2. If ./configure deosn't exist, create it
./bootstrap
# autoconf
You have to install "autoconf" for that. After that, you should have a file
called "configure" in the top-level directory of kexec-tools, and you can
continue with the next step.
As per ./include/config.h.in, if you obtain kexec-tools from a released
tarball, you can ommit this step. If on the other hand you obtain
kexec-tools from git or some other revision control system, then you
will probably need to do this.
3. Run ./configure [--prefix=/usr/local] [options]...
General
-------
e.g.
# ./configure --prefix=/usr/local
You should check first if your favourite Linux distribution doesn't offer a
package. If that package is recent enough, you should consider using that
package instead.
For a full list of options run
However, if you want to install kexec-tools from sources
# ./configure --help
(1) Run ./configure [--prefix=/usr/local] [options]...
e.g.
4. Run make
./configure --prefix=/usr/local
# make
For a full list of options run
To install kexec-tools
./configure --help
After following the above instructions to build-kexec tools, run
(2) Run make
# make install
make
(3) To install kexec-tools
After following the above instructions to build-kexec tools, run
make install
Static compilation
------------------
To compile kexec-tools statically (i.e., independent of libraries that are
present on the system), use
LDFLAGS=-static ./configure <options>
instead.
Cross compilation
-----------------
Because kexec is also used in the embedded world, cross-compilation is
supported. You cannot only set "CC", "LD", "CCFLAGS" and "LDFLAGS" environment
variables for the ./configure call as usual, you can also set
TARGET_CC -- the C compiler used for files that should run on the
target
TARGET_CCFLAGS -- compilation flags for $TARGET_CC
TARGET_LD -- linker used for files that should run on the
target
Because the build process also requires files that must be executed during the
build, you also need a host compiler, only the target compiler is not enough.
BUILD_CC -- the C compiler used for files that should run on the
host (the system that builds the kexec-tools)
BUILD_CFLAGS -- compilation flags for $BUILD_CC