mirror of
https://github.com/crosstool-ng/crosstool-ng.git
synced 2024-12-29 17:18:53 +00:00
94be1f470c
Depending on local policies, some users have expressed a need to have the sysroot be named differently than the hard-coded name. Add an option for that. Default to 'sysroot' to match the existing literature. While at it, replace 'sys-root' with 'sysroot' everywhere we reference the sysroot. Reported-by: Alexey Kuznetsov <Alexey.KUZNETSOV@youtransactor.com> Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
104 lines
3.5 KiB
Plaintext
104 lines
3.5 KiB
Plaintext
File.........: 5 - Using the toolchain.txt
|
|
Copyrigth....: (C) 2010 Yann E. MORIN <yann.morin.1998@anciens.enib.fr>
|
|
License......: Creative Commons Attribution Share Alike (CC-by-sa), v2.5
|
|
|
|
|
|
Using the toolchain /
|
|
____________________/
|
|
|
|
|
|
Using the toolchain is as simple as adding the toolchain's bin directory in
|
|
your PATH, such as:
|
|
export PATH="${PATH}:/your/toolchain/path/bin"
|
|
|
|
and then using the target tuple to tell the build systems to use your
|
|
toolchain:
|
|
./configure --target=your-target-tuple
|
|
or
|
|
make CC=your-target-tuple-gcc
|
|
or
|
|
make CROSS_COMPILE=your-target-tuple-
|
|
and so on...
|
|
|
|
It is strongly advised not to use the toolchain sysroot directory as an
|
|
install directory for your programs/packages. If you do so, you will not be
|
|
able to use your toolchain for another project. It is even strongly advised
|
|
that your toolchain is chmod-ed to read-only once successfully build, so that
|
|
you don't go polluting your toolchain with your programs/packages' files.
|
|
|
|
Thus, when you build a program/package, install it in a separate directory,
|
|
eg. /your/root. This directory is the /image/ of what would be in the root file
|
|
system of your target, and will contain all that your programs/packages have
|
|
installed.
|
|
|
|
|
|
The 'populate' script |
|
|
----------------------+
|
|
|
|
When your root directory is ready, it is still missing some important bits: the
|
|
toolchain's libraries. To populate your root directory with those libs, just
|
|
run:
|
|
your-target-tuple-populate -s /your/root -d /your/root-populated
|
|
|
|
This will copy /your/root into /your/root-populated, and put the needed and only
|
|
the needed libraries there. Thus you don't polute /your/root with any cruft that
|
|
would no longer be needed should you have to remove stuff. /your/root always
|
|
contains only those things you install in it.
|
|
|
|
You can then use /your/root-populated to build up your file system image, a
|
|
tarball, or to NFS-mount it from your target, or whatever you need.
|
|
|
|
The populate script accepts the following options:
|
|
|
|
-s src_dir
|
|
Use 'src_dir' as the un-populated root directory.
|
|
|
|
-d dst_dir
|
|
Put the populated root directory in 'dst_dir'.
|
|
|
|
-l lib1 [...]
|
|
Always add specified libraries.
|
|
|
|
-L file
|
|
Always add libraries listed in 'file'.
|
|
|
|
-f
|
|
Remove 'dst_dir' if it previously existed; continue even if any library
|
|
specified with -l or -L is missing.
|
|
|
|
-v
|
|
Be verbose, and tell what's going on (you can see exactly where libs are
|
|
coming from).
|
|
|
|
-h
|
|
Print the help.
|
|
|
|
See 'your-target-tuple-populate -h' for more information on the options.
|
|
|
|
Here is how populate works:
|
|
|
|
1) performs some sanity checks:
|
|
- src_dir and dst_dir are specified
|
|
- src_dir exists
|
|
- unless forced, dst_dir does not exist
|
|
- src_dir != dst_dir
|
|
|
|
2) copy src_dir to dst_dir
|
|
|
|
3) add forced libraries to dst_dir
|
|
- build the list from -l and -L options
|
|
- get forced libraries from the sysroot (see below for heuristics)
|
|
- abort on the first missing library, unless -f is specified
|
|
|
|
4) add all missing libraries to dst_dir
|
|
- scan dst_dir for every ELF files that are 'executable' or
|
|
'shared object'
|
|
- list the "NEEDED Shared library" fields
|
|
- check if the library is already in dst_dir/lib or dst_dir/usr/lib
|
|
- if not, get the library from the sysroot
|
|
- if it's in sysroot/lib, copy it to dst_dir/lib
|
|
- if it's in sysroot/usr/lib, copy it to dst_dir/usr/lib
|
|
- in both cases, use the SONAME of the library to create the file
|
|
in dst_dir
|
|
- if it was not found in the sysroot, this is an error.
|