The Full Wiki

GNU build system: Wikis


Note: Many of our articles have direct quotes from sources you can cite, within the Wikipedia article! This article doesn't yet, but we're working on it! See more info or our list of citable articles.


From Wikipedia, the free encyclopedia

GNU logo

The GNU build system, also known as the Autotools, is a suite of programming tools produced by the GNU project. These tools are designed to assist in making various source-code packages portable to many Unix-like systems. The GNU build system is part of the GNU toolchain and is widely used in many free-software and open-source packages. The tools comprising the GNU build system are free-software-licensed under the GNU General Public License with special license exceptions[1][2] permitting use of the GNU build system with proprietary software.


Tools included in the GNU build system

Flow diagram of autoconf and automake

The GNU build system comprises the GNU utility programs Autoconf, Automake, and Libtool [3]. Other related tools frequently used with the GNU build system are GNU’s make program, GNU gettext, pkg-config, and the GNU Compiler Collection, also called GCC.


GNU Autoconf

Autoconf processes files ( or, though is the newer name and is now recommended[4]) to generate a configure script.

When running the generated configure script, other template files, customarily ending in ".in", such as, are processed to create their final output, in this case a Makefile.

Autoconf is used to attempt to work around the quirks found in various Unix-like operating systems. For example, some Unix-like systems may have certain facilities that are known to be broken or missing entirely. Autoconf creates a shell script which can detect these, and the program can work around them. The final output of the Autoconf utility is the configure script.

Autoconf comes with several auxiliary programs designed to ease the creation of, such as the Autoheader tool, which is used to help manage C header files, autoscan, which can create an initial input file for Autoconf and ifnames, which can list C pre-processor identifiers used in the program.

GNU Automake

Automake helps to create portable Makefiles, which are in turn processed with the make utility. It takes its input as, and turns it into, which is used by the configure script to generate the file Makefile output.

GNU Libtool

Libtool helps manage the creation of static and dynamic libraries on various Unix-like operating systems. Libtool accomplishes this by abstracting the library-creation process, hiding differences between various systems (e.g. GNU/Linux systems vs. Solaris).


Gnulib simplifies the process of making software that uses Autoconf and Automake portable to a wide range of systems.

Advantages of the GNU build system

The GNU build system provides an environment to a computer programmer which allows them to write cross-platform software (at least running on multiple Unix-like operating systems). It also makes the build process easier on the user, allowing the user to usually just run a small set of commands to build the program from its source code and install it.

The utilities used by the GNU build system are only required to be on the developer’s workstation, as well. Users do not need to have Autoconf, Automake, or Libtool in order to build or install software which was developed using them. This makes the GNU build system self-contained, requiring only standard Unix-like tools to build. This is accomplished by using shell scripts which help to configure the software for a given person’s operating system.

The utilities used in the GNU build system can also be used alone or together—a software project can use Autoconf, for example, without using Automake as well. However, the GNU build system’s components can interact with each other.

Limitations of the GNU build system

The GNU build system uses Bourne-compatible shell scripts to assist the user in the configuration and build process. The GNU build system can be used both for building native programs on the build machine and also for cross-compiling to other architectures [1].

Cross-compiling software to run on a Windows host from a GNU/Linux or other Unix-like build system is also possible, using MinGW, however native compilation is often desirable on operating systems (such as the Microsoft Windows family of systems) that cannot run Bourne shell scripts on their own. This makes building such software on the Windows operating system a bit harder than on a Unix-like system which provides the Bourne shell as a standard component. One can install the Cygwin or MSYS system on top of Windows to provide a Unix-like compatibility layer, though, allowing configure scripts to run. Cygwin also provides the GNU Compiler Collection, GNU make, and other software that provides a nearly complete Unix-like system within Windows; MSYS also provides GNU make and other tools designed to work with the MinGW version of GCC.

Projects which use the GNU build system may or may not provide a configure script within their Software Configuration Management systems (such as CVS or Subversion). If a project that uses the GNU build system does not have a generated ./configure file available for the user, the user must generate it. One possible way this can be done is to execute the autoreconf tool at a shell prompt:

$ autoreconf

This will invoke aclocal, autoconf, autoheader and automake as needed. In some cases, more commands may be necessary. Another common convention is then to provide a script, often named or bootstrap, that runs all the needed pre-build tools.

One limitation has been that the autoconf-generated configure can be slow because it executes programs like the C compiler many times in order to test whether various libraries, header files, and language features are present.

See also


Further reading

External links


Got something to say? Make a comment.
Your name
Your email address