Autoconf

Autoconf предназначен для создания программных пакетов, собираемых из исходного кода. Обычно такие пакеты распространяются в виде файлов .tar.gz. Autoconf позволяет преодолеть различия между системами, так что для распаковки, сборки и установки пакета достаточно выполнить стандартную последовательность команд:

$ tar zxvf пакет-версия.tar.gz
$ cd пакет-версия
$ ./configure
$ make
$ /bin/su -
$ make install

Autoconf был создан летом 1991 года Дэвидом Маккензи для поддержки своей работы в Free Software Foundation. В последующие годы инструмент был усовершенствован многочисленными авторами и стал наиболее распространённым решением для создания переносимых пакетов в мире свободного ПО.

Автоконф близок по концепции к пакету Metaconfig, использовавшемуся для Perl, а также к системе imake, применявшейся до версии X11R6.9 для сборки X Window System, однако имеет иную философию.

В области портируемости Autoconf делает акцент на проверке доступности возможностей, а не на определении номеров версий. К примеру, родной компилятор C в SunOS 4 не поддерживал ISO-расширения, однако администратор мог установить совместимый с ISO компилятор. Определить его наличие простым анализом версии системы нельзя, а скрипт configure, полагаясь на тесты возможностей, способен обнаружить нужный компилятор. Такой подход даёт следующие преимущества:

• скрипт configure можно применять даже на новых и неизвестных системах
• если на системе установлены обновлённые версии средств разработки, возможно использовать их преимущества
• отпадает необходимость поддерживать детализированные списки соответствия версий и возможностей

К команде ./configure можно добавить параметры — их перечень выводится командой:

$ ./configure --help

Среди важных параметров — --prefix=PREFIX (определяет корневой каталог для установки программ пакета) и --exec-prefix=EPREFIX (каталог для бинарных файлов). Также для задания конкретных директорий существуют параметры:

  --bindir=DIR           пользовательские исполняемые файлы [EPREFIX/bin]
  --sbindir=DIR          системные утилиты администратора [EPREFIX/sbin]
  --libexecdir=DIR       дополнительные исполняемые файлы [EPREFIX/libexec]
  --datadir=DIR          архитектурно-независимые данные только для чтения [PREFIX/share]
  --sysconfdir=DIR       одноузловые данные только для чтения [PREFIX/etc]
  --sharedstatedir=DIR   изменяемые архитектурно-независимые данные [PREFIX/com]
  --localstatedir=DIR    изменяемые локальные данные [PREFIX/var]
  --libdir=DIR           библиотеки объектного кода [EPREFIX/lib]
  --includedir=DIR       файлы заголовков C [PREFIX/include]
  --oldincludedir=DIR    файлы заголовков C для не-gcc [/usr/include]
  --infodir=DIR          документация info [PREFIX/info]
  --mandir=DIR           документация man [PREFIX/man]

Начиная с версии 1.3 automake, можно использовать переменную окружения при установке:

$ DESTDIR=корень make install

Это позволяет установить структуру файлов в указанный каталог (например, при создании RPM-пакетов или установке на удалённый диск, смонтированный через NFS).

Если пакет поддерживает различные функции или зависимости, можно выбирать их через такие параметры:

  --enable-ФУНКЦИЯ
  --enable-ФУНКЦИЯ=значение
  --disable-ФУНКЦИЯ
  --with-ПАКЕТ
  --without-ПАКЕТ

Дополнительные параметры configure могут задаваться через переменные вида имя=значение — например:

Для указания архитектуры применяются параметры --build=АРХИТЕКТУРА; при кросс-компиляции — --host=АРХИТЕКТУРА или --target=АРХИТЕКТУРА.

Программа automake из файла Makefile.am генерирует Makefile.in, после чего autoconf создаёт итоговые файлы без суффикса .in.

Пример «Hello, world»:

1. Создайте исходный файл hello.c:

#include <stdio.h>

int main() {
    printf("Hello, world!\n");
    return 0;
}

1. Создайте Makefile.am с содержимым:

bin_PROGRAMS = hello
hello_SOURCES = hello.c

1. Запустите autoscan. Будут выведены сообщения об ошибках:

autom4te: configure.ac: no such file or directory
autoscan: /usr/bin/autom4te failed with exit status: 1

и созданы autoscan.log и configure.scan:

#                                               -*- Autoconf -*-
# Process this file with autoconf to produce a configure script.

AC_PREREQ(2.59)
AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)
AC_CONFIG_SRCDIR([hello.c])
AC_CONFIG_HEADER([config.h])

# Checks for programs.
AC_PROG_CC

# Checks for libraries.

# Checks for header files.

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_CONFIG_FILES([Makefile])
AC_OUTPUT

1. Переименуйте configure.scan в configure.ac и дополните строку AC_INIT конкретными данными.
2. Запустите autoheader; будет создан autom4te.cache с файлами output.0, requests, traces.0 и config.h.in:

/* config.h.in.  Generated from configure.ac by autoheader.  */

/* Define to the address where bug reports for this package should be sent. */
#undef PACKAGE_BUGREPORT

/* Define to the full name of this package. */
#undef PACKAGE_NAME

/* Define to the full name and version of this package. */
#undef PACKAGE_STRING

/* Define to the one symbol short name of this package. */
#undef PACKAGE_TARNAME

/* Define to the version of this package. */
#undef PACKAGE_VERSION

1. В configure.ac после AC_INIT добавьте строку:

AM_INIT_AUTOMAKE

1. Запустите aclocal; будет создан aclocal.m4 и обновлён autom4te.cache.
2. Запустите automake --add-missing --copy — появятся сообщения:

configure.ac: installing `./install-sh'
configure.ac: installing `./missing'
Makefile.am: installing `./INSTALL'
Makefile.am: required file `./NEWS' not found
Makefile.am: required file `./README' not found
Makefile.am: required file `./AUTHORS' not found
Makefile.am: required file `./ChangeLog' not found
Makefile.am: installing `./COPYING'
Makefile.am: installing `./depcomp'

и создадутся нужные файлы и обновится кэш.

1. Запустите autoconf; появится configure.
2. Для сборки используйте стандартные команды:

$ ./configure
$ make
$ /bin/su -
$ make install

1. После изменений в исходных текстах снова выполните autoscan, обновите configure.ac и выполните autoreconf.

Автоконф часто критикуют за использование устаревших технологий, наличие ограничений и сложных для освоения сценариев даже при простых нуждах. К часто выделяемым недостаткам системы относят:

• Сложность использования — для многих проектов требуется многократное повторение одних и тех же действий^[2][3].
• Сгенерированный скрипт configure исполняется в Bourne shell, из-за чего процесс генерации Makefile может быть медленным.
• Считается, что скрипты configure, созданные через autoconf, представляют собой в основном ручной интерфейс командной строки без стандартизации^[4]. Несмотря на это, стандарты существуют и их использование становится всё более распространённым^[5].
• Для добавления нестандартных проверок требуется освоить относительно малоизвестный макропроцессор M4^[4][6].
• Из-за слабой совместимости между версиями приходится использовать обёрточные скрипты^[7].
• Автоматически сгенерированные скрипты обычно получаются очень объёмными и иногда сложными для отладки.

По этим причинам ряд проектов, ранее использовавших GNU Build System, перешли на альтернативные инструменты, такие как CMake и SCons^[2][8].