LinuxCommandLibrary

autoreconf

SYNOPSIS

autoreconf [OPTION]... [FILE]...

PARAMETERS

-f, --force
    Force regeneration of all files, even if up-to-date

-i, --install
    Install auxiliary files by copying instead of symlinking

-c, --copy
    Synonym for --install: copy auxiliary files

-n, --dry-run
    Pretend to run tools without making changes

-v, --verbose
    Print detailed information about actions

-q, -s, --quiet
    Suppress output messages

-V, --version
    Display version information and exit

-h, --help
    Show usage summary and exit

--skip=TOOL
    Skip running the specified TOOL

--warnings=CATEGORY
    Control warning verbosity by category

--trace
    Print commands as they are executed

--prefix=PREFIX
    Override installation prefix for tools

DESCRIPTION

autoreconf is a GNU Autotools script that automatically runs autoconf, automake, aclocal, autoheader, and libtoolize to regenerate configure scripts, Makefiles.in, and other build files from configure.ac (or configure.in) and Makefile.am files.

It detects which tools are needed based on the presence of macros and dependencies, ensuring the build system stays consistent. Developers run it after modifying autotools input files, during package maintenance, or when porting to new systems.

By default, it uses installed tool versions and symlinks auxiliary files, but options allow forcing updates or installing copies. This streamlines the autotools workflow, avoiding manual invocation of each tool.

CAVEATS

Modifies files in place; always use version control. Requires full Autotools installed. May fail if macros undefined or tools missing. Avoid in distributed tarballs without -fiv.

COMMON USAGE

Run autoreconf -fiv in project root after editing configure.ac or Makefile.am.
Combines force (-f), install (-i), verbose (-v).

EXIT STATUS

0 if successful, 1 if tools failed, >1 for other errors.

HISTORY

Developed as part of GNU Autotools in the early 1990s by the Free Software Foundation. Evolved with autoconf (1980s origins) to automate portable builds. Current stable in Autotools 2.71 (2023).

SEE ALSO

Copied to clipboard