path: root/docs/5 - Using the toolchain.txt
diff options
authorYann E. MORIN" <>2011-11-16 21:06:42 (GMT)
committerTrevor Woerner <>2011-11-16 21:06:42 (GMT)
commit949254a2e7152fdff25792a2fdd680b4f2cbae7e (patch)
treedc5e1f6c95caf4a9564e7dcab0b03223dd23c0b5 /docs/5 - Using the toolchain.txt
parente008b89c58c97cb8c2cce4ff28cea0bce6393554 (diff)
docs: --target versus --host
In the very beginnings, eons ago, autotools also got confused by this whole build vs. host vs. target, and got it wrong. Now they fixed it, but they want to keep backward compatibility, so the --target is still recongised, although ./configure will complain if you do so. It is better to use --host. Signed-off-by: "Trevor Woerner" <> [ add build/host clarification] Signed-off-by: "Yann E. MORIN" <>
Diffstat (limited to 'docs/5 - Using the toolchain.txt')
-rw-r--r--docs/5 - Using the toolchain.txt15
1 files changed, 10 insertions, 5 deletions
diff --git a/docs/5 - Using the toolchain.txt b/docs/5 - Using the toolchain.txt
index eb8e1aa..0266bf2 100644
--- a/docs/5 - Using the toolchain.txt
+++ b/docs/5 - Using the toolchain.txt
@@ -11,15 +11,20 @@ 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
- ./configure --target=your-target-tuple
+and then using the '--host' tuple to tell the build systems to use your
+toolchain (if the software package uses the autotools system you should
+also pass --build, for completeness):
+ ./configure --host=your-host-tuple --build=your-build-tuple
- make CC=your-target-tuple-gcc
+ make CC=your-host-tuple-gcc
- make CROSS_COMPILE=your-target-tuple-
+ make CROSS_COMPILE=your-host-tuple-
and so on...
+(Note: in the above example, 'host' refers to the host of your program,
+not the host of the toolchain; and 'build' refers to the machine where
+you build your program, that is the host of the toolchain.)
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