14.1 Specifying target triplets

Autoconf-generated configure scripts can make decisions based on a canonical name for the system type, or target triplet, which has the form: ‘cpu-vendor-os’, where os can be ‘system’ or ‘kernel-system

configure can usually guess the canonical name for the type of system it’s running on. To do so it runs a script called config.guess, which infers the name using the uname command or symbols predefined by the C preprocessor.

Alternately, the user can specify the system type with command line arguments to configure (see Specifying a System Type. Doing so is necessary when cross-compiling. In the most complex case of cross-compiling, three system types are involved. The options to specify them are:

--build=build-type

the type of system on which the package is being configured and compiled. It defaults to the result of running config.guess. Specifying a build-type that differs from host-type enables cross-compilation mode.

--host=host-type

the type of system on which the package runs. By default it is the same as the build machine. The tools that get used to build and manipulate binaries will, by default, all be prefixed with host-type-, such as host-type-gcc, host-type-g++, host-type-ar, and host-type-nm. If the binaries produced by these tools can be executed by the build system, the configure script will make use of it in AC_RUN_IFELSE invocations; otherwise, cross-compilation mode is enabled. Specifying a host-type that differs from build-type, when build-type was also explicitly specified, equally enables cross-compilation mode.

--target=target-type

the type of system for which any compiler tools in the package produce code (rarely needed). By default, it is the same as host.

If you mean to override the result of config.guess but still produce binaries for the build machine, use --build, not --host.

So, for example, to produce binaries for 64-bit MinGW, use a command like this:

./configure --host=x86_64-w64-mingw64

If your system has the ability to execute MinGW binaries but you don’t want to make use of this feature and instead prefer cross-compilation guesses, use a command like this:

./configure --build=x86_64-pc-linux-gnu --host=x86_64-w64-mingw64

Note that if you do not specify --host, configure fails if it can’t run the code generated by the specified compiler. For example, configuring as follows fails:

./configure CC=x86_64-w64-mingw64-gcc

When cross-compiling, configure will warn about any tools (compilers, linkers, assemblers) whose name is not prefixed with the host type. This is an aid to users performing cross-compilation. Continuing the example above, if a cross-compiler named cc is used with a native pkg-config, then libraries found by pkg-config will likely cause subtle build failures; but using the names x86_64-w64-mingw64-gcc and x86_64-w64-mingw64-pkg-config avoids any confusion. Avoiding the warning is as simple as creating the correct symlinks naming the cross tools.

configure recognizes short aliases for many system types; for example, ‘decstation’ can be used instead of ‘mips-dec-ultrix4.2’. configure runs a script called config.sub to canonicalize system type aliases.

This section deliberately omits the description of the obsolete interface; see Hosts and Cross-Compilation.