Skip to main content

Using Autoconf

XMLCPP 라이브러리를 만들면서 Autoconf에 대해 알게 되었습니다. 원래 Autoconf의 목적은 다양한 Unix-like 시스템에서 source code package가 컴파일될 수 있도록 해주는 shell-script들을 생성해주는 것입니다.

하지만 여러 Unix-like 시스템에서 사용할 계획이 없는 프로그램이라도 이를 사용하면 install/uninstall/dist/check 등의 다양한 장점을 얻을 수 있습니다. 특히 automake, libtool등과 같이 사용하면 Makefile도 간단히 만들 수 있고 .a나 .so등도 쉽게 관리가 가능합니다. 이번 글에서는 간단한 예제를 가지고 autoconf를 사용하는 방법을 소개합니다. 자세한 파일 내용들은 첨부 파일을 참고하세요. ((hello-10tar.gz))

Create directories & files



Create basic directories & files



다음과 같이 디렉토리와 파일들을 생성합니다. 생성하는 파일들은 GNU coding standards에서 요구하는 파일들입니다. ((만약 이 파일들이 필요없다면 automake에 --foreign 옵션을 줄 수 있습니다.))


$ mkdir config include src tests
$ touch INSTALL README AUTHORS ChangeLog COPYING NEWS


Copy libtool files



다음과 같이 libtool 관련 파일들을 config 디렉토리에 cp 합니다.


$ cd /usr/share/libtool 혹은 cd /usr/local/share/libtool
$ cp config.* lt* your/path/to/config/


Write source code files



이번 글에서는 간단한 Hello 클래스를 구현합니다. .h 파일은 include, .cpp 파일은 src 디렉토리에 생성합니다.

Create configure.ac file



먼저 configure.ac 파일의 template 생성을 위해 autoscan 을 실행합니다. Autoscan은 하위 디렉토리들을 읽어들여 configure.scan 파일을 생성해 줍니다. 이 파일의 이름을 configure.ac로 mv 한 후 다음과 같이 수정합니다.


5,6c5,7
< AC_INIT(FULL-PACKAGE-NAME, VERSION, BUG-REPORT-ADDRESS)
< AC_CONFIG_SRCDIR([include/hello.h])
---
> AC_INIT(hello, [1.0], [your@email.com])
> AC_CONFIG_SRCDIR([src/hello.cpp])
> AC_CONFIG_AUX_DIR(config)
8a10,11
> AM_INIT_AUTOMAKE(hello, [1.0])
>
11a15
> AC_PROG_LIBTOOL
21c25
< AC_OUTPUT
---
> AC_OUTPUT(Makefile include/Makefile src/Makefile tests/Makefile)


먼저 AC_INIT의 인자를 원하는 프로그램 명과 버전으로 변경합니다. 다음으로 AC_CONFIG_AUX_DIR에서 앞에서 생성한 config 디렉토리를 지정합니다. 다음으로 automake와 libtool을 위한 선언을 하고 AC_OUTPUT에 생성하고자 하는 Makefile들의 리스트를 넣습니다.

Create Makefile.am files



다음으로 각 디렉토리에 Makefile을 만들기 위한 Makefile.am 파일들을 생성합니다. 이 파일들은 automake에 의해 Makefile로 변환됩니다.

먼저 top 디렉토리에 다음과 같이 Makefile.am을 생성합니다. 

SUBDIRS = include src tests


top 디렉토리에서는 따로 install하거나 build할 파일이 없으므로 다음 sub-디렉토리들을 나열합니다.

다음으로 src 디렉토리에는 다음과 같이 Makefile.am을 생성합니다.


INCLUDES = -I$(top_srcdir)/include

lib_LTLIBRARIES = libhello.la
libhello_la_SOURCES = hello.cpp


위와 같이 해주면 libtool이 configure 실행 옵션에 따라 .a와 .so를 생성해줍니다. (--enable-shared, --enable-static) 아무 옵션도 주지 않으면 둘 다 생성됩니다.

include 디렉토리의 Makefile.am은 다음과 같습니다.


include_HEADERS = hello.h


마지막으로 tests 디렉토리의 것은 다음과 같습니다.


INCLUDES = -I$(top_srcdir)/include

TESTS = test1 test2

check_PROGRAMS = test1 test2

test1_SOURCES = test1.cpp
test1_LDADD = $(top_srcdir)/src/libhello.la

test2_SOURCES = test2.cpp
test2_LDADD = $(top_srcdir)/src/libhello.la


TESTS에 선언된 프로그램들은 make check시에 수행됩니다.

Create bootstrap file



마지막으로 bootstrap 파일을 다음과 같이 작성합니다. 이 파일은 간단히 매번 타이핑해야 하는 수고를 줄이기 위해 사용합니다.


#! /bin/sh
set -x
aclocal -I config
autoheader
automake --add-missing --copy
autoconf



Build



빌드하는 과정은 다음과 같이 간단합니다.


$ ./bootstrap
$ ./configure --prefix=/tmp
$ make
$ make check
$ make install


make check의 결과는 다음과 같이 출력됩니다.


PASS: test1
PASS: test2
==================
All 2 tests passed
==================


그리고 make install후 /tmp 디렉토리에는 다음과 같은 파일들이 install 됩니다.


$ ls include/ lib/
include/:
hello.h

lib/:
libhello-1.0.so.0  libhello-1.0.so.0.0.0  libhello.a  
libhello.la  libhello.so


물론 make uninstall을 수행하면 install된 파일들이 모두 삭제됩니다.

Etc



마지막으로 이를 패키지로 꾸리기 위해 make dist를 사용할 수 있습니다. 패키지에 필요한 파일들을 모두 tar.gz으로 꾸려 줍니다. ((물론 configure.ac를 수정하여 gz2와 같이 다른 포맷으로 패키지를 꾸릴 수 있습니다. 첨부 파일 역시 make dist로 만들어진 패키지입니다.))
Labels:

Comments

  1. mkseoJanuary 5, 2007 at 5:26 AM

    autoconf, automake 너무 어려워보입니다. 예전부터 시도하다가 몇번을 포기했는지 모르겠어요.

    ReplyDelete
  2. iwonguJanuary 7, 2007 at 4:36 AM

    네. 생각보다 쉽지 않더라고요. 그래도 책을 빌려서 한번 읽고 나니 좀 낫더군요. 책에서 기본적인 내용을 보고, 필요한데 모르는게 있으면 검색하고 해서 간신히 성공했습니다. 제대로 하려면 m4 코딩까지 해서 필요한 check 함수들을 만들어야 하는데 검색해보니 대부분 필요한건 남들이 다 만들어놨더라고요. :-)
    처음엔 좀 어려워도 일단 좀 알고나니 편하긴 합니다. 그냥 makefile로 install, uninstall에 dist까지 만들려고 하면... 게다가 라이브러리 패키지인 경우에는 .a에 .so까지 만들어주니까요. :-)

    ReplyDelete

Post a Comment

Popular posts from this blog

1의 개수 세기 - 해답

벌써 어제 말한 내일이 되었는데 답을 주신 분이 아무도 없어서 좀 뻘쭘하네요. :-P 그리고 어제 문제에 O(1)이라고 적었는데 엄밀히 얘기하자면 O(log 10 n)이라고 적었어야 했네요. 죄송합니다. ... 문제를 잠시 생각해보면 1~n까지의 수들 중 1의 개수를 얻기 위해서는 해당 숫자 n의 각 자리의 1의 개수가 모두 몇개나 될지를 구해서 더하면 된다는 사실을 알 수 있습니다. 예를 들어 13이라는 수를 생각해 보면 1~13까지의 수에서 1의 자리에는 1이 모두 몇개나 되는지와 10의 자리에는 모두 몇개나 되는지를 구해 이 값을 더하면 됩니다. 먼저 1의 자리를 생각해 보면 1, 11의 두 개가 있으며 10의 자리의 경우, 10, 11, 12, 13의 네 개가 있습니다. 따라서 2+4=6이라는 값을 구할 수 있습니다. 이번엔 234라는 수에서 10의 자리를 예로 들어 살펴 보겠습니다. 1~234라는 수들 중 10의 자리에 1이 들어가는 수는 10, 11, ..., 19, 110, 111, ... 119, 210, 211, ..., 219들로 모두 30개가 있음을 알 수 있습니다. 이 규칙들을 보면 해당 자리수의 1의 개수를 구하는 공식을 만들 수 있습니다. 234의 10의 자리에 해당하는 1의 개수는 ((234/100)+1)*10이 됩니다. 여기서 +1은 해당 자리수의 수가 0이 아닌 경우에만 더해집니다. 예를 들어 204라면 ((204/100)+0)*10으로 30개가 아닌 20개가 됩니다. 이런 방식으로 234의 각 자리수의 1의 개수를 구하면 1의 자리에 해당하는 1의 개수는 ((234/10)+1)*1=24개가 되고 100의 자리에 해당하는 개수는 ((234/1000)+1)*100=100이 됩니다. 이들 세 수를 모두 합하면 24+30+100=154개가 됩니다. 한가지 추가로 생각해야 할 점은 제일 큰 자리의 수가 1인 경우 위의 공식이 아닌 다른 공식이 필요하다는 점입니다. 예를 들어 123에서 100의 자리에 해당하는 1의 개수는 ((123/1...
3 comments
Read more

CodeHighlighter plugin test page.

This post is for testing CodeHighlighter plugin which uses GeSHi as a fontifier engine. ((Those code blocks are acquired from Google Code Search .)) ((For more supported languages, go CodeHighlighter plugin or GeSHi homepage.)) C++ (<pre lang="cpp" lineno="1">) class nsScannerBufferList { public: /** * Buffer objects are directly followed by a data segment. The start * of the data segment is determined by increment the |this| pointer * by 1 unit. */ class Buffer : public PRCList { public: Buffer() { ++index_; } PHP (<pre lang="php" lineno="4">) for ($i = 0; $i $value = ord( $utf8_string[ $i ] ); if ( $value < 128 ) { // ASCII $unicode .= chr($value); } else { if ( count( $values ) == 0 ) { $num_octets = ( $value } $values[] = $value; Lisp (<pre lang="lisp">) ;;; Assignment (define-caller-pattern setq ((:star var fo...
88 comments
Read more

C++ of the Day #43 - SQLite3 C++ wrapper #1

The Definitive Guide to SQLite 를 읽다가 공부 겸 해서 C++ wrapper를 만들어 보았습니다. 최대한 C++ 냄새(?)가 나도록 만들어 보았습니다. :-) ((SQLite는 복잡한 관리가 필요없이 사용가능한, 파일이나 메모리 기반의, 라이브러리로 제공되는, 약 250kb 용량의, 대부분의 SQL92문을 지원하는, open source RDB입니다.)) 이 wrapper를 사용하기 위해서는 (당연하게도!) sqlite3 와 (당연하게도?) boost 라이브러리가 필요합니다. 사용 예들을 살펴보는 것으로 설명을 대신합니다. 이번 글에서는 다음과 같은 contacts 테이블이 test.db에 존재한다고 가정합니다. CREATE TABLE contacts ( id INTEGER PRIMARY KEY, name TEXT NOT NULL, phone TEXT NOT NULL, UNIQUE(name, phone) ); Command 먼저 test.db 파일을 사용하기 위해 다음과 같이 파일 이름을 주어 connection 객체를 생성합니다. 생성과 동시에 test.db와 연결이 이루어집니다. ((생성자외에 open() 함수를 사용할 수도 있습니다.)) sqlite3pp::connection conn("test.db"); 다음은 contacts 테이블에 정보를 추가하는 가장 간단한 방법입니다. connection 클래스에서 제공하는 execute 함수를 사용합니다. ((executef 함수를 사용하면 printf와 같은 문법을 사용하여 query문을 작성할 수 있습니다.)) conn.execute("INSERT INTO contacts (name, phone) VALUES ('user', '1234')"); 위와 동일한 작업을 parameterized query를 사용하여 할 수도 있습니다. ((step()함수가 실제 query문을 수행하는 함수입니다. ...
4 comments
Read more