135

The script ./configure accepts 3 options --build, --host and --target. I'm confusing their roles. What's the difference and semantics of them?

1
  • Autotools will use the wrong toolchain for a cross-compile, even using --host and --build. I've got two C++ projects and it is impossible to build for Android because Autotools is so f**k'd up. It insists on running tests using the host's toolchain.
    – jww
    Apr 11, 2019 at 14:00

2 Answers 2

124

As noted in this blog post and alluded to in the GCC Configure Terms, --target only applies when you are compiling toolchains. When you are doing normal cross-compilation of a library or binary you use

--build=the architecture of the build machine
--host=the architecture that you want the file to run on

However, when you are building toolchains, things can get more complicated. I think that the following is correct (though I can't say I've ever manually compiled a cross-debugger):

Lets say that you have:

  • a powerpc build machine that you are going to do all compilation on
  • several embedded devices, with mips processors, which your code is going to run on
  • an x86 laptop that you are going to use for debugging these devices in the field

You would configure and build your debugging server (eg gdbserver) to run on your embedded device with

./configure --build=powerpc --host=mips

so that you could putty on to your embedded device and run "gdbserver :1234 a.out" to start debugging and listen on port 1234.

You would then build your debugging client (which connects to and controls the gdbserver) with

./configure --build=powerpc --host=i686 --target=mips 

which you would copy to your x86 laptop so that in the field you could run "gdbclient embedded.device:1234" in order to debug your a.out program.

This all applies to compilers too for which you might want to look at the GCC link above or this section about the Canadian cross compile.

Also note that, in practice, you might not see build, host or target specified because, according to this Autoconf manual page, "target defaults to host, host to build, and build to the result of config.guess."

In a word, build the code on --build, run it on --host with --target architecture environment.

6
  • 14
    How to find out what to put for "host" and "target" ?
    – Black
    Aug 26, 2015 at 6:53
  • 4
    I guess you are talking about building a new compiler, as "--target" is relevant only for compilers. * "host" is where your new compiler should run. * "target" is where the executables produced by your new compiler should run. Sep 28, 2015 at 9:46
  • doesnt this make this as a wrong answer, because --host=i686 isnt valid here? Mar 24, 2017 at 9:35
  • 1
    The answer provided mention the compilation was done for the MIPS target and this is the build, and the host is the debugger for the MIPS machine. Does this mean that the debugger/compiler was also built by the powerpc? This is a comment I got from another user (Ned): build = where am I compiling the compiler, host = where the compiler will run, target = what code will the compiler produce. Reference: stackoverflow.com/questions/7088576/…
    – supmethods
    Oct 25, 2018 at 0:15
  • According to Ned, wouldn't this mean the powerpc is both the build/host, x86 machine a target of the debugger, and the target as MIPS system. Can you explain more what "building for" and "building on" is? I referencing to gcc.gnu.org/onlinedocs/gccint/Configure-Terms.html.
    – supmethods
    Oct 25, 2018 at 0:19
78

Note: Argument --target makes sense only when building compiler (e.g. GCC). When running configure before building GCC:

  • --build: the machine you are building on
  • --host: the machine you are building for
  • --target: the machine that GCC will produce binary for

From the GCC documentation (Host/Target specific installation notes):

If build, host, and target are all the same, this is called a native. If build and host are the same but target is different, this is called a cross. If build, host, and target are all different this is called a canadian (for obscure reasons dealing with Canada's political party and the background of the person working on the build at that time). If host and target are the same, but build is different, you are using a cross-compiler to build a native for a different system. Some people call this a host-x-host, crossed native, or cross-built native. If build and target are the same, but host is different, you are using a cross compiler to build a cross compiler that produces code for the machine you're building on. This is rare, so there is no common way of describing it. There is a proposal to call this a crossback.

4
  • 3
    Which apparently means --target is not relevant to any project which is not itself a compiler. So why is it a standard configure option? Confusing.
    – dhardy
    Dec 3, 2014 at 14:29
  • 1
    @dhardy: configure isn't exactly a pinnacle of good and clean design; I guess it's just a result of application-specific feature creep.
    – Tim Čas
    Feb 10, 2015 at 20:28
  • If I want to get a gcc, for example run "./configure --build=powerpc --host=i686 --target=mips ", Is the output executable crippled? usually, gcc is a powerful tool that can build c code, then output many kind of result for many platform. Here if I use '--target=mips', does the specified gcc lost the ability?
    – gfan
    Aug 30, 2018 at 6:41
  • What also might work is to update the config.guess and config.sub files, so the compiler knows more target platforms .. you can get them here: gnu.org/software/gettext/manual/html_node/config_002eguess.html
    – wirtsi
    Jul 17, 2019 at 15:11

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.