Skip to end of metadata
Go to start of metadata



개요 

본 문서는   Unix 시스템에서 Altibase 가 제공하는 APRE(구SESC)*C/C++ Precompiler를 이용하여 컴파일하는 방법과 컴파일 단계별로 발생할 수 있는 문제들에 대한 해결 방법을 설명한다.

본 문서에 사용된 예제와 설명은 사용자층이  넓은  OS인 Linux 와 gcc 컴파일  환경에서 작성되었으며  다른 UNIX 환경(HP, SUN, AIX) 의   기타 컴파일러 사용자를 위해서도  참고할 수 있도록 필요한 정보를 추가 기술하였다.

 아래 문서들을 사전에 읽어 볼 것을 권장한다.

  1. Altibase Precompiler 가이드
  2. Altibase APRE New Features 업그레이드 가이드

본 문서의 테스트 환경은 다음과 같다.

  • ALTIBASE : Altibase 6 이상 버전
  • OS : Linux ( 2.6.32-504.el6.x86_64 )
  • 컴파일러 버전 : gcc version 4.4.7 20120313 (Red Hat 4.4.7-11) (GCC) 

 

 

Icon

이 문서와 관련된 오류 및 개선사항은 기술지원포털 또는 기술지원센터로 문의주시기 바랍니다.

Icon

이 문서는 정보 제공을 목적으로 제공되며, 사전에 예고 없이 변경될 수 있습니다. 이 문서는 오류가 있을 수 있으며, 상업적 또는 특정 목적에 부합하는 명시적, 묵시적인 책임이 일절 없습니다.

이 문서에 포함된 Altibase 제품의 특징이나 기능의 개발, 발표 등의 시기는 Altibase 재량입니다.

Altibase는 이 문서에 대하여 관련된 특허권, 상표권, 저작권 또는 기타 지적 재산권을 보유할 수 있습니다.

 

 

기초적인 Makefile의 작성방법

Makefile의 구조에 대한 이해를 위해서 간단한 c코드를 가지고 Makefile을 만들어 보도록 한다. Altibase Makefile규약은 GNU규약을 준수함으로 gmake사용을 권장하며 본 문서에서는 그와 상관없이 일반적 규약에 맞게 설명한다.

 

Makefile의 기본 구조

makefile은 실행 파일을 만들기 위해 진행되는 과정들을 하나의 스크립트 언어로 정의한 것이다. 다음의 간단한 소스를 컴파일 해보도록 한다.

이 소스는 프롬프트 상에서 다음과 같이 컴파일을 할 수 있다.

다음과 같은  가장 간단한 Makefile 스크립트로 작성하여 make를 이용하여 컴파일 할 수 있다.

shell> vi Makefile

a:a.c # 사용자가 만드는 규약 및 의존성

cc -o a a.c # 실제 수행할 명령어 라인을 기술

  1. a:a.c     는     a를 만들기 위해서는 a.c를 찾아라 ( 변경되었는지 검사하라 )
  2. cc -o a.c  는  a.c가 존재하는 게 확인되면  이 명령을 수행하라
  3. shell> make -f Makefile     파일명이 Makefile 인 경우 -f Makefile 은 생략이 가능하다.

Makefile은 위에 기술된 것과 같이 목표를 만들기 위해 소스를 탐색하고 나열된 명령어들을 기술하는 하나의 스크립트라고 이해라고 이해 할 수 있다.   동일한 소스에 대해 변경 분이 없는 경우에는 컴파일이 수행될 필요가 없기 때문에  “make: is up to date” 라는 에러를 만나게 된다.

 

예제 소스

앞으로 진행할 예제는  Altibase가 설치된 디렉토리의  sample 소스 중에 포함되어 있는  $ALTIBASE_HOME/sample/APRE/connect1.sc 를 활용한다. ( Altibase 5.3 이상을 기준으로 한다 ) 

본 예제는 Linux 에서 gcc 컴파일러를 기준으로 컴파일하는 환경을 기준으로 작성되었으므로  기타 다른 Unix 환경과 컴파일러를 사용할 경우는 Makefile  일부는 해당 환경에 맞게 다르게 작성되어야 한다.  

소스의 일부분은 아래와 같다.

 

Precompile 수행

Altibase의 APRE 확장자는 "*.sc" 를 사용한다. 이 파일은 C/C++컴파일러가 바로 해석할 수 있는 형태가 아니기 때문에 Altibase가 제공하는 프리컴파일러를 통해  C/C++ 소스로 변환해야 한다.

  1. Makefile 내용

  2. 실행

    Shell> make -f Makefile connect1.sc

    이렇게  Makefile 파일을 만든 후 실행해보면 connect1.c가 새롭게 생성되는 것을 확인할 수 있다. ( 확장자 옵션에 따라서 C/C++ 로 사용자 환경에 맞게 변경한다.)

 

컴파일 수행

이제 실행 파일인 connect1 으로 만들기 위해 Makefile 에 규약을 추가한다.

물론, connect1 규약에 프리컴파일 규약을 쓰고 컴파일 하는 규약을 써도 무방하다. 여기서는 각각 구분 지어 설명하도록 하겠다. 위에서는 make단계에서 connect1 규약이 connect1.c를 필요로 하기 때문에 Makefile내에서 connect1.c에 대한 규약을 찾는다. 

Makefile내에 해당 규약이 있기 때문에 먼저 프리컴파일을 수행하고 cc컴파일을 수행하는 순서로 동작하게 된다.  하지만 실제 컴파일을 하면 다음과 같은 오류를 만나게 된다

$ make -f Makefile connect1
apre -t c connect1.sc
-----------------------------------------------------------------
Altibase C/C++ Precompiler.
Release Version 6.5.1.3.0
Copyright 2000, ALTIBASE Corporation or its subsidiaries.
All Rights Reserved.
-----------------------------------------------------------------
cc -o connect1 connect1.c
connect1.c:9:29: error: ulpLibInterface.h: No such file or directory
connect1.c: In function 'main':
connect1.c:68: error: storage size of 'ulpSqlstmt' isn't known
..........................................................

make: *** [connect1] Error 1

굵게 표시된 줄을 보면 헤더 파일을 찾을 수 없다는 오류가 발생했음을 알 수 있다. Makefile에서는 컴파일 하기 위해 사용자가 소스상에 사용한 헤더와 라이브러리에 대한 경로를  다음 단계의 설명과 같이 명시해야 한다. 

 

Header 파일과 Library 경로의 명시

Header 파일과 Library를 참조할 수 있도록 다음과 같이 Makefile을 수정한다.

Shell> vi Makefile

ALTI_INCLUDE=${ALTIBASE_HOME}/include

ALTI_LIBRARY=${ALTIBASE_HOME}/lib

connect1.c: connect1.sc

    apre –t c connect1.sc

connect1 : connect1.c

    cc –o connect1 connect1.c –I$(ALTI_INCLUDE) –L$(ALTI_LIBRARY)

ALTI_INCLUDE와 ALTI_LIBRARY와 같이 사용자 계정의 환경변수를 설정하듯이 Makefile내에서만 적용 가능한 환경변수를 설정하고 이것을 컴파일 명령어 라인에 추가한다. 이후 실행 결과는 앞서 실행한 결과와는 다른 오류를 보여 준다.

$ make connect1
apre -t c connect1.sc

cc -o connect1 connect1.c -I/altibase_home/include -L/ssd/altibase_home/lib
/tmp/ccREjTkg.o: In function `main':
connect1.c:(.text+0x13a): undefined reference to `ulpGetSqlca'
.............................................................................

............................................................................
collect2: ld returned 1 exit status
make: *** [connect1] Error 1

위 에러는 소스상에서 사용되는 함수들이 정의된 라이브러리가 명시되지 않았기 때문에 컴파일 단계에서 참조하려고 하는데 찾을 수 없을 경우 발생한다. 헤더의 경우는 개별 헤더파일을 모두 명시하지 않아도 되지만 라이브러리의 경우는 반드시 명시해야 한다. 

 

APRE 컴파일을 위한 기본 Library 명시

다음과 같이 Makefile 을 수정한다.

APRE 용 기본 Library 추가

$ vi Makefile
ALTI_INCLUDE=${ALTIBASE_HOME}/include
ALTI_LIBRARY=${ALTIBASE_HOME}/lib -lapre -lodbccli

connect1.c:connect1.sc

apre -t c connect1.sc

connect1:connect1.c

cc -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY)

Altibase는 프리컴파일을 통한 바이너리 생성시에 (apre, odbccli)라는 2개의 라이브러리를 필요로 한다. 이것은 ($ALTIBASE_HOME/lib)에 위치한다. Makefile내에서 라이브러리에 대한 표기는 "-I" 옵션으로 지정하며 해당 파일을 실제 보면  "libapre.a" 혹은 "libapre_sl.so" 형태로 존재하는데 라이브러리명에서  "lib"와 확장자(.a 또는 .so)를 제거한 이름만 명시하면 된다.  

 

시스템 Library의 추가

기본 Library 만  추가한 상태에서  다시 컴파일한 후 실행된 결과를 확인하면 다음과 같이 여전히 오류가 발생한다.

$ make connect1
apre -t c connect1.sc

cc -o connect1 connect1.c -I/ssd/altibase_home/include -L/ssd/altibase_home/lib -lapre -lodbccli
/ssd/altibase_home/lib/libapre.a(ulpLibInterface.o): In function `ulpLibInit':
ulpLibInterface.c:(.text+0x77): undefined reference to `pthread_rwlock_init'
/ssd/altibase_home/lib/libapre.a(ulpLibInterface.o): In function `ulpDoEmsql':
ulpLibInterface.c:(.text+0x1e6): undefined reference to `pthread_rwlock_wrlock'

...........................................

...........................................

위의  에러 메세지는  APRE library 내에서  사용된 POSIX  thread 함수를 위한 thread Library를 찾지 못해서 발생하는 에러이다.   앞서 필요한 Library를 추가해 준 것과 마찬가지로  다음 단계와 같이  APRE에서 참조하는 기타  Library 들도 Makefile 에 추가해 줘야 한다.

$ vi Makefile
ALTI_INCLUDE=${ALTIBASE_HOME}/include
ALTI_LIBRARY=${ALTIBASE_HOME}/lib -lapre -lodbccli -lpthread

connect1.c:connect1.sc

apre -t c connect1.sc

connect1:connect1.c

cc -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY)

컴파일에 필요한 추가적인 시스템 library와 각 컴파일 옵션은  OS 환경과 컴파일러의 종류에 따라 다르며  자세한 내용은 본 문서의  각 컴파일러별 설명을 참조하기 바란다.

아래의 방법을 사용하여 apre 컴파일시에 필요한 시스템 Library 의 목록을 확인한 후  Library를  Makefile 에 추가해 줄 수 있다.

  1. Altibase 의 sample용 Makefile 을 참고하는 방법

  2. ldd 명령을 사용하는 방법
  3. nm 명령을 사용하는 방법
  4. man page 를 참고하는 방법

 

Altibase의 Sample용 Makefile을 참고

Icon

APRE 컴파일에 필요한 라이브러리의 목록은 $ALTIBASE_HOME/install/altibase_env.mk에 보면 리스트가 나와 있음으로 그것을 참고한 후 사용자의 Makefile 에 각 Library 와 옵션을 명시해서 사용할 수도 있다.


ldd 명령의 활용

ldd 명령의 사용은 다음과 같다.

 

nm 명령의 활용

컴파일시 참조할 수 없는  symbol 이  "cos" 함수인 경우  아래와 같이  "nm -A /usr/lib/lib* | grep cos" 와 같이 실행하여   undefined symbol name 으로 어떤 library 참조를 필요로 하는 지 확인할 수 있다.

위와 같이 libm.so 를 참조하고 있으므로  Makefile 에  "-lm"  을 추가해 주도록 한다.

 

man page의 활용

UNIX 명령어인 man 명령을 활용하여 일부 symbol 은  해당 symbol의 용도와   이 symbol이  참조하는 library를  아래와 같은 방법을 이용하여 찾을 수 있다.  

$ man 3 cos ( cos는 undefined symbol name )


COS(3) Linux Programmer Manual COS(3)

NAME
cos, cosf, cosl - cosine function

SYNOPSIS
#include <math.h>

double cos(double x);
float cosf(float x);
long double cosl(long double x);

Link with -lm.

man page 의 설명을 보면 cos 함수는 math 관련 library 에 포함되어 있으며  link 시  library "-lm" 을 추가해 주라고 설명하고 있다.

 

컴파일 시 비트 오류의 원인과 해결방법

 

컴파일 모드에 맞는 APRE Library의 사용

APRE를 이용하여 64bit용 프로그램을 만들기 위해서는  64bit APRE 컴파일러 와 64bit 용 APRE library 와 Header 파일,  그리고  컴파일러별로 프로그램을 64bit 용으로 컴파일하도록 하는  컴파일 옵션을 필요로 한다.

마찬가지로 APRE용 32bit  프로그램을 만들기 위해서는 32bit APRE 컴파일러, 32bit 용 APRE library 와 Header파일 그리고  컴파일러에게  32bit 용으로 컴파일하도록 지시하는 32bit 옵션을 명시하여야 한다.

  1. 32bit client 개발도구(Library 및 Precompiler)의 다운로드
    http://support.altibase.com/kr/product 의  client selection 에서  설치하고자  하는 플랫폼에 맞는  32bit client install package를 다운로드 받아 설치한다.


  2. 64bit client 개발도구(Library 및 Precompiler)의 다운로드
    64bit client 개발도구는  DB 서버 패키지가 64bit 인 경우   서버 패키지에 기본적으로 포함되어 있으므로  서버 인스톨시에 함께 설치된다. DB 서버와 다른 서버에 64bit 개발도구를  설치하려면 앞서 32bit client 패키지를 다운로드 받은 것처럼 http://support.altibase.com/kr/product 의 client section 에서 64bit client install package 를 다운로드 받아서 설치하면 된다.

 

컴파일 시 비트 오류

  1. Library의 비트 확인법
    컴파일 비트와 Link 된  APRE Library 의 비트가 맞지 않을 경우는 컴파일시 오류가 발생하게 된다.  이런 경우 해당 Library의 비트가 32bit 인지 64bit 인지  확인해야 한다.  다음과 같은 방법으로 Library의 비트를 확인한다.

    shell> cd $ALTIBASE_HOME/lib # altibase apre library 가 설치된 디렉토리

    shell> file libapre_sl.so 

    libapre_sl.so: ELF 32-bit LSB shared object, Intel 80386, version 1 (GNU/Linux), dynamically linked, not stripped # Linux 에서 32bit용 APRE Library가 설치되어 있는 경우

    libapre_sl.so: ELF 64-bit LSB shared object, x86-64, version 1 (GNU/Linux), dynamically linked, not stripped # Linux 에서 64bit용 APRE Library가 설치되어 있는 경우

    위와 같이 Library의 비트는  Unix 명령어인 "file" 명령어를 통해서 확인할 수 있으며 OS별로 메세지는 약간씩 상이할 수 있으나 비트의 확인은  동일하게 메세지를 통해서 유추가 가능하다.

  2. 컴파일 시 비트 옵션

    컴파일러별로 비트와 관련된 컴파일 옵션을 지정해야 한다. 아래의 표는  각 컴파일러 별  32bit 및 64bit 컴파일 옵션이다.  컴파일러가 지원하는 CPU 종류에 따라서 옵션이 다를 수 있으므로 기타 상세한 옵션은 각 컴파일러별 매뉴얼을 참조하기 바란다.

    OSSUNHPAIXLinux
    cc 컴파일러 64비트 옵션

    -xarch=v9 또는 "-m64 -xarch=sparc"

    (SUN Sparc 사용시)

    		+DD64-q64-m64
    cc 컴파일러 32비트 옵션-xarch=v8plusa (SUN Sparc 사용시)+DD32-q32-m32

C++ library 추가

Altibase v5.3.3 까지는 sesc Precompiler를 사용하며  sesc library 의 일부는 C++ 형식으로 build 되었다.  따라서 C++컴파일러가 아닌 C컴파일러로 컴파일을 해야 하는 경우  이를 해석 가능한 형태로 참조할 수 있도록 몇 개의 호환용 시스템 라이브러리를 필요로 한다.

C++ 관련 library가 포함되어 있지 않을 경우 아래와 같이 C++ 관련 연산자를 찾지 못하는 에러가 발생한다.

#makefile 시 발생하는 오류 메세지

sesc -t c connect1.sc
-----------------------------------------------------------------
Altibase C/C++ Precompiler.
Release Version 5.3.3.38
Copyright 2000, ALTIBASE Corporation or its subsidiaries.
All Rights Reserved.
-----------------------------------------------------------------

gcc -o connect1 connect1.c -I/ssd/altibase_home/include -L/ssd/altibase_home/lib -lsesc -lodbccli -lpthread -lm -ldl -lcrypt -lrt

/ssd/altibase_home/lib/libodbccli.a(idvHandlerTimer_aoc.o): In function `idvTimerThread::~idvTimerThread()':
idvHandlerTimer.cpp:(.gnu.linkonce.t._ZN14idvTimerThreadD0Ev+0xc): undefined reference to `operator delete(void*)'
/ssd/altibase_home/lib/libodbccli.a(idvHandlerTimer_aoc.o):(.gnu.linkonce.r._ZTI14idvTimerThread+0x0): undefined reference to `vtable for __cxxabiv1::__si_class_type_info'

...............................


에러를 해결하기 위해서는 C++ standard library 를 추가하기 위해서  gcc 컴파일러인 경우  "-lstdc++" 을 아래와 같이  Makefile 에 추가해 준다. 

$ vi Makefile
ALTI_INCLUDE=${ALTIBASE_HOME}/include
ALTI_LIBRARY=${ALTIBASE_HOME}/lib -lapre -lodbccli -lpthread -lm -lstdc++

...............................


C컴파일러를 사용시에 각 플랫폼 별로 필요한 C++ library 는 다음과 같다.  아래의 표를 참조하여 컴파일러 별로 Makefile에 추가해 준다.

플랫폼라이브러리
SUN-lCrun
HP-lstd –lstream –lCsup -lc
AIX-lC
LINUX-lstdc++ -lc
Icon

Altibase 5.5.1 이후부터는 APRE library가 C source 코드로 재작성되었다. 따라서 C컴파일러로 컴파일하는 경우는 별도의 C++ library를 Makefile 에 추가해 주지 않아도 된다.

 

C++ 컴파일러의 사용

C++컴파일러를 사용할 경우 대부분 위의 나열된 문제들은 회피할 수 있음으로 별도로 설명하지는 않도록 한다. 다만, C++컴파일러는 별도의 64비트 옵션이 있음으로 각 컴파일러 별로 이를 숙지하도록 한다.

 

 

Linux gcc 용 Makefile

앞서 "기초적인 Makefile의 작성방법" 을 통해서   기본적인 APRE library를 추가하는 방법을 알아 보았다.  이번 장에서는 Linux gcc 환경에서 Makefile에 추가적으로 기술해 주어야 하는 Library 와  컴파일옵션에 대해서 설명한다.

 

Linux 환경에서 APRE 컴파일을 위한 Library와 컴파일 옵션

 

  1. Makefile에 추가해 주어야 하는 Library
    앞서 이미 설명한 바와 같이 아래와 같이 기본적인 APRE library인 "-lapre -lodbccli" 가 Makefile 에 기술되어 있어야 한다. 
    기본적인 Library 만 추가한 상태에서 컴파일을 할 경우  APRE library 에서 참조하는 시스템 Library들이 있어 참조 오류가 발생한다.   따라서  APRE에서 사용하는  시스템 library들을  Makefile 에  아래와 같이 명시해 주어야 한다.

    Library 종류Makefile Library설명
    Posix thread library-lpthreadPOSIX  thread 함수를 위한 thread Library
    Math 관련 library-lmmath 함수 사용을 위한 Library

    Dynamic Linking Loader(DL) Library

    		-ldlDynamically loaded (DL) library 

    C++ library

    		-lstdc++Altibase 5.3.3 이하 버전에서 gcc 를 사용하여 컴파일경우 C++ library 명시
    Realtime Extensions Library 추가-lrt 

     

     

  2. 컴파일 옵션
    성능 향상과 컴파일 bit  타입 지정을 위한 아래의 옵션 지정이 필요하다.

    옵션명옵션표시설명
    32bit/64bit 컴파일 모드 지정


    		-m64

    64비트 코드를 생성

    -m3232비트 코드를 생성
    Icon
     $ALTIBASE_HOME/install/altibase_env.mk 파일과  $ALTIBASE_HOME/sample/APRE/Makefile을 참고하면 APRE 컴파일시에 최적화된 컴파일 및 링크 옵션들을 참조할 수 있다.

     

     

  3. 간단한 Makefile 예
    이제 Linux  gcc 환경에서 APRE를 컴파일할 수 있는 가장 간단한 형태의 Makefile 이 아래와 같이 완성되었다.   이외에도  프로그램에서 참조하는 library 가  추가적으로 있다면 해당 Library 를  Makefile 에 추가적으로 기술해 주어야 한다.

     

    $ cat Makefile
    ALTI_INCLUDE=${ALTIBASE_HOME}/include
    ALTI_LIBRARY=${ALTIBASE_HOME}/lib -lapre -lodbccli

    SYS_LIBS= -lpthread -lm -ldl -lcrypt -lstdc++ -lrt

    connect1.c:connect1.sc

    apre -t c connect1.sc

    connect1:connect1.c

    cc -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(SYS_LIBS)


32비트 컴파일을 위한 Makefile 예

32bit 컴파일 옵션을 명시한  gcc 용 APRE Makefile 의 예는 아래와 같다.   컴파일 옵션으로 "-m32"를 명시하고  Header 파일 과 Library를 참조하는 경로에   32bit 용 APRE Library가 설치되어 있는 경로를 지정해야 한다.  또한 APRE Precompiler도  32bit 용 APRE 가 실행되도록 경로를 명시한다.

ALTI_INCLUDE=/alticlient32/include
ALTI_LIBRARY=/alticlient32/lib -lapre -lodbccli

SYS_LIBS=-lpthread -lm -ldl -lc

connect1.c:connect1.sc

/alticlient32/bin/apre -t c connect1.sc

connect1:connect1.c

gcc -m32 -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(SYS_LIBS)

clean:

rm *.c *.o

 

 

AIX xlc 용 Makefile

앞서 "기초적인 Makefile의 작성방법" 을 통해서   기본적인 APRE library를 추가하는 방법을 알아 보았다.  이번 장에서는 AIX  xlc 컴파일러를 사용하는 환경에서 Makefile에 추가적으로 기술해 주어야 하는 Library 와  컴파일옵션에 대해서 설명한다.

 

AIX 환경에서 APRE 컴파일을 위한 Library와 컴파일 옵션

 

  1. Makefile에 추가해 주어야 하는 Library
    앞서 이미 설명한 바와 같이 아래와 같이 기본적인 APRE library인 "-lapre -lodbccli" 가 Makefile 에 기술되어 있어야 한다. 
    기본적인 Library 만 추가한 상태에서 컴파일을 할 경우  APRE library 에서 참조하는 시스템 Library들이 있어 참조 오류가 발생한다.   따라서  APRE에서 사용하는  시스템 library들을  Makefile 에  아래와 같이 명시해 주어야 한다.

    Library 종류Makefile 추가 Library이름설명
    Thread library-lpthreadsPOSIX  thread 함수를 위한 thread Library
    Math 관련 library-lmmath 함수 사용을 위한 Library
    C++ library-lC5.3.3 이하버전에서 C 컴파일러를 사용하여 컴파일할 경우 추가

     

     

  2. 컴파일 옵션
    성능 향상과 컴파일 bit  타입 지정을 위한 아래의 옵션 지정이 필요하다.

    옵션명옵션표시설명
    최대 Memory segment 크기 지정 옵션-bmaxdata32bit 프로그램 컴파일시 최대 사용가능 메모리 segment 크기 지정( default 256M )
    32bit/64bit 컴파일 모드 지정


         		-q32

    32bit 프로그램 컴파일시

    -q64 64bit 프로그램 컴파일시
    컴파일러 최적화 모드-O2컴파일러 최적화 Level 2 단계 사용
    인라인함수 사용여부-qinline성능 향상을 위해 함수 call 대신 inline 함수 사용 설정
    runtime linking 옵션-brtlruntime linking 위한 옵션, shared library 를 사용할 경우 설정
    symbol export 옵션
    -bexpall
    		shared library 생성시 global symbol 을 export하기 위한 설정
    Icon
     $ALTIBASE_HOME/install/altibase_env.mk 파일과 $ALTIBASE_HOME/sample/APRE/Makefile 참고하면 APRE 컴파일시에 최적화된 컴파일 및 링크 옵션들을 참조할 수 있다.

     

     

  3. 간단한 Makefile 예
    이제 AIX  xlc 환경에서 APRE를 컴파일할 수 있는 가장 간단한 형태의 Makefile 이 아래와 같이 완성되었다.   이외에도  프로그램에서 참조하는 library 가  추가적으로 있다면 해당 Library 를  Makefile 에 추가적으로 기술해 주어야 한다.

     

    ALTI_INCLUDE=$(ALTIBASE_HOME)/include
    ALTI_LIBRARY=$(ALTIBASE_HOME)/lib
    LIBS=-lapre -lodbccli -lpthreads -lm
    LFLAGS=-O2 -qinline -q64 #64bit 컴파일모드

    connect1.c:connect1.sc

    $(ALTIBASE_HOME)/bin/apre -t c connect1.sc

    connect1:connect1.c

    cc $(LFLAGS) -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

    clean:

    rm *.c *.o

     

     

     


32비트 컴파일을 위한 Makefile 예

32bit 컴파일을 위한 Makefile 예는 아래와 같다.   컴파일 옵션으로 "-q32"를 명시하고  Header 파일 과 Library를 참조하는 경로에   32bit 용 APRE Library가 설치되어 있는 경로를 지정해야 한다. 또한 APRE Precompiler도  32bit 용 APRE 가 실행되도록 경로를 명시한다.

"-bmaxdata:0x80000000 " 와 같이  프로그램에서  사용할 메모리 세그먼트를 크기를 필요하면  늘려준다.  "-bmaxdata:0x80000000"  로 할 경우 최대 2G까지 사용 가능하다.

ALTI_INCLUDE=/alticlient32/include
ALTI_LIBRARY=/alticlient32/lib
LIBS=-lapre -lodbccli -lpthreads -lm
LFLAGS= -O2 -qinline -q32 -bmaxdata:0x80000000 -L. #32bit 컴파일모드, 최대메모리 segment 크기 설정

connect1.c:connect1.sc

/alticlient32/bin/apre -t c connect1.sc

connect1:connect1.c

cc $(LFLAGS) -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

clean:

rm *.c *.o

 

APRE Shared Library(libapre_sl.so)를 사용하는 Makefile 예

$ALTIBASE_HOME/lib 에는 static library인  libapre.a 외에도   shared library 형태로 제공하는  libapre_sl.so 와 libodbccli_sl.so  가 있다.  shared library 를 사용하면  static library 를 사용할 때와 비교하여 아래의 장점이 있다.

  •  실행파일의 크기를 줄일 수 있다.
  •  library 를 메모리에 적재한 후 공유할 수 있어  프로그램의 메모리 사용량을 줄일 수 있다.
  • 사용 library 가 변경될 경우 library 만 교체하면 되고  실행파일을 재 컴파일 필요가 없다.

아래는 AIX 에서 xlc 컴파일러를 사용하여 shared library를 이용하는 Makefile의 예는 다음과 같다.    runtime linking 을 사용하기 위해서  링크옵션으로 "-brtl" 을 추가하고    Library 로  APRE shared library를  추가하였다.

ALTI_INCLUDE=$(ALTIBASE_HOME)/include
ALTI_LIBRARY=$(ALTIBASE_HOME)/lib
LIBS=-lapre_sl -lodbccli_sl -lc -lpthreads -lm
LFLAGS=-O2 -brtl -qinline -q64 #64bit 컴파일모드
connect1.c:connect1.sc

$(ALTIBASE_HOME)/bin/apre -t c connect1.sc

connect1:connect1.c

cc $(LFLAGS) -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

clean:

rm *.c *.o

 

APRE 소스를 이용한 Shared Library Build를 의한 Makefile 예

필요에 따라서는 APRE 를 통해서  DB를 조회하는 함수로  구성된  shared library 를 만들고 이를  프로그램에서 호출해서 사용해야 하는 경우가 있다. 아래의 예는  APRE 로  shared library를 만들기 위한  Makefile 의 예이다.

먼저 library를 만들이 위한 C source를 아래와 같이 작성한다.

connect1.sc

connect1.sc 를 이용하여  프로그래에서 호출해서 사용할 libconn_sl.so 를 만들기 위한 Makefile 은 아래와 같다.   

 

Shared Library Build 용 Makefile 예

Shared library 용 Makefile

 ALTI_INCLUDE=$(ALTIBASE_HOME)/include

ALTI_LIBRARY=$(ALTIBASE_HOME)/lib
LIBS= -lc -lpthreads -lm # -lapre_sl -lodbccli_sl 은 실행파일 빌드시에 link 해 주어야 한다.
LFLAGS=-O2 -lc -q64 #64bit 컴파일모드

SHLLIB=libconn_sl.so
OBJS=connect1.o

all: $(SHLLIB)

$(SHLLIB):$(OBJS)

xlc_r -G -o $(SHLLIB) $(OBJS) -b64 -bexpall -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

connect1.o:connect1.c

xlc_r $(LFLAGS) -c connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

connect1.c:connect1.sc

$(ALTIBASE_HOME)/bin/apre -t c connect1.sc

clean:

rm *.o

 

APRE 함수로 만들어진 Shared Library 를 호출하여 사용하는 프로그램을 컴파일하는 Makefile 예

먼저  APRE shared library를 위한  Header 파일로 "alticonn.h" 를 만든다.   

사용자 프로그램은   libconn_sl.so 에  등록된  contest_db() 를  호출하여 사용하게 된다.   사용자 프로그램의 소스는  아래와 같다.

 

실행프로그램 Build를 위한 Makefile 예

libconn_sl.so 에 등록된  contest_db() 함수를 호출하여 사용하는 사용자 프로그램을 컴파일하기 위한 Makefile 은  아래와 같다.

ALTI_INCLUDE=$(ALTIBASE_HOME)/include

ALTI_LIBRARY=$(ALTIBASE_HOME)/lib
LIBS=-lapre_sl -lodbccli_sl -lc -lpthreads -lm
LFLAGS=-O2 -brtl -qinline -q64 #64bit 컴파일모드

INC_ALL=-I. -I$(ALTI_INCLUDE)
LIB_ALL=-L. -L$(ALTI_LIBRARY)

all:test

test:

xlc_r $(LFLAGS) -o test test.c $(INC_ALL) $(LIB_ALL) -lconn_sl $(LIBS)

clean:

rm *.c *.

 

Shared Library Build 시 주의사항

Icon

AIX에서는 shared library를 두개 이상 만들어서 사용할 때 shared library build 시에는 -lapre_sl 과 -lodbccl_sl 을 추가하지 말아야 한다.

AIX의 shared library 에서는 apre_sl, odbccli_sl library 상의 global 변수들을 각각 다른 변수로 인식을 하여 shared library 끼리 공유가 되지 않는다. 그러므로 shared library 를 만들 때는 APRE library (apre_sl, odbccli_sl) 들을 링크하지 말고 실행 바이너리를 만들 때 APRE library를 링크 하도록 한다.

예들 들어, connection 관련 shared library 는 con.so 로 select 관련 shared library는 sel.so 두고 binary 를 build하고 실행할 경우 sel.so에서는 con.so 에 있는 connection 관련 객체 정보를 참조하지 못해서 error가 발생하게 된다. 이러한 문제를 방지하기 위해서는 실행 바이너리를 만들 때에만 apre_sl 과 odbccli_sl 을 링크로 추가해 주어야만 한다.

 

 

 

HP-UX acc 용 Makefile

앞서 "기초적인 Makefile의 작성방법" 을 통해서   기본적인 APRE library를 추가하는 방법을 알아 보았다.  이번 장에서는 HP-UX 에서  acc(C컴파일러)를 사용하는 환경에서 Makefile에 추가적으로 기술해 주어야 하는 Library 와  컴파일옵션에 대해서 설명한다.

 

HP-UX 환경에서 APRE 컴파일을 위한 Library와 컴파일 옵션

 

  1. Makefile에 추가해 주어야 하는 Library
    앞서 이미 설명한 바와 같이 아래와 같이 기본적인 APRE library인 "-lapre -lodbccli" 가 Makefile 에 기술되어 있어야 한다. 
    기본적인 Library 만 추가한 상태에서 컴파일을 할 경우  APRE library 에서 참조하는 시스템 Library들이 있어 참조 오류가 발생한다.   따라서  APRE에서 사용하는  시스템 library들을  Makefile 에  아래와 같이 명시해 주어야 한다.

    Library 종류Makefile Library설명
    Posix thread library-lpthreadPOSIX  thread 함수를 위한 thread Library
    Math 관련 library-lmmath 함수 사용을 위한 Library

    Dynamic Linking Loader(DL) Library

    		-ldldDynamically loaded (DL) library 
    Unwind Express Library-lunwindItanium 기반 서버에서 스택추적,스택 와인딩 해제하는 API 사용을 위한 Library

    C++ library

    		-lstd –lstream –lCsup -lcAltibase 5.3.3 이하 버전에서 acc C컴파일러를 사용하여 컴파일경우 C++ library 명시
    Realtime Extensions Library 추가-lrt 

     

     

  2. 컴파일 옵션
    성능 향상과 컴파일 bit  타입 지정을 위한 아래의 옵션 지정이 필요하다.

    옵션명옵션표시설명
    Multithread 프로그램 컴파일 옵션-mt프로그램을 multi thread로 작성할 경우 지정 필요
    Instruction Set Architecture (ISA) 지정


    		+DD64

    IA64에서 HP-UX용 64비트 코드를 생성

    +DD32IA64에서 HP-UX용 32비트 코드를 생성
    Warning 옵션+vnocompatwarnings불필요한 warning 메세지를 줄이기 위한 옵션
    Icon
     $ALTIBASE_HOME/install/altibase_env.mk 파일을 참고하면 APRE 컴파일시에 최적화된 컴파일 및 링크 옵션들을 참조할 수 있다.

     

     

     

  3. 간단한 Makefile 예
    HP  acc 환경에서 APRE를 컴파일할 수 있는 가장 간단한 형태의 Makefile 이 아래와 같이 완성되었다.   이외에도  프로그램에서 참조하는 library 가  추가적으로 있다면 해당 Library 를  Makefile 에 추가적으로 기술해 주어야 한다.

     

    ALTI_INCLUDE=$(ALTIBASE_HOME)/include
    ALTI_LIBRARY=$(ALTIBASE_HOME)/lib
    LIBS=-lapre -lodbccli -lpthread -lunwind -lm
    LFLAGS= -mt +DD64 -Wl,+vnocompatwarnings -L.

    connect1.c:connect1.sc

    $(ALTIBASE_HOME)/bin/apre -t c connect1.sc

    connect1:connect1.c

    cc $(LFLAGS) -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

    clean:

    rm *.c *.o


32비트 컴파일을 위한 Makefile 예

32bit 컴파일 옵션을 명시한  acc 용 APRE Makefile 의 예는 아래와 같다.   컴파일 옵션으로 "+DD32"를 명시하고  Header 파일 과 Library를 참조하는 경로에   32bit 용 APRE Library가 설치되어 있는 경로를 지정해야 한다. 또한 APRE Precompiler도  32bit 용 APRE 가 실행되도록 경로를 명시한다.

ALTI_INCLUDE=/alticlient32/include
ALTI_LIBRARY=/alticlient32/lib
LIBS=-lapre -lodbccli -lpthread -lunwind -lm
LFLAGS= -mt +DD32 -Wl,+vnocompatwarnings -L.

connect1.c:connect1.sc

/alticlient32/bin/apre -t c connect1.sc

connect1:connect1.c

cc $(LFLAGS) -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

clean:

rm *.c *.o

 

 

SUN(Solaris) cc 용 Makefile

앞서 "기초적인 Makefile의 작성방법" 을 통해서  기본적인 APRE library를 추가하는 방법을 알아 보았다.  이번 장에서는 SUN(Solaris)  cc 컴파일러를 사용하는 환경에서 Makefile에 추가적으로 기술해 주어야 하는 Library 와  컴파일옵션에 대해서 설명한다.

 

SUN(Solaris) 환경에서 APRE 컴파일을 위한 Library와 컴파일 옵션

 

  1. Makefile에 추가해 주어야 하는 Library
    앞서 이미 설명한 바와 같이 아래와 같이 기본적인 APRE library인 "-lapre -lodbccli" 가 Makefile 에 기술되어 있어야 한다. 
    기본적인 Library 만 추가한 상태에서 컴파일을 할 경우  APRE library 에서 참조하는 시스템 Library들이 있어 참조 오류가 발생한다.   따라서  APRE에서 사용하는  시스템 library들을  Makefile 에  아래와 같이 명시해 주어야 한다.

    Library 종류Makefile 추가 Library이름설명
    Thread library-lpthread 또는 -lthreadPOSIX  thread 함수를 위한 thread Library
    Math 관련 library-lmmath 함수 사용을 위한 Library

    Dynamic Linking Loader(DL) Library

    		-ldlDynamically loaded (DL) Library 
    Networking Services Library-lnslNetworking Services 함수 사용을 위한 Library
    Sockets Library-lsocketSockets 함수 사용을 위한 Library

    C++ library

    		-lCrun -ldemangleAltibase 5.3.3 이하 버전에서 cc 를 사용하여 컴파일할 경우 C++ library 명시
    Realtime Extensions Library 추가-lrt 

     

     

  2. 컴파일 옵션
    성능 향상과 컴파일 bit  타입 지정을 위한 아래의 옵션 지정이 필요하다.

    옵션명옵션표시설명
    Multithread 프로그램 컴파일 옵션-mt프로그램을 multi thread로 작성할 경우 지정 필요
    Instruction Set Architecture (ISA) 지정


    		-xarch=amd64

    AMD cpu (X86) 사용 플랫폼에서 64bit 프로그램 컴파일시

    -xarch=sse2a AMD cpu (X86) 사용 플랫폼에서 32bit 프로그램 컴파일시
    -xarch=v9SUN sparc cpu 사용 플랫폼에서 64bit 프로그램 컴파일시
    -xarch=v8plusSUN sparc cpu 사용 플랫폼에서 32bit 프로그램 컴파일시
    Performance 옵션-fastRuntime performance 향상을 위한 옵션
    Icon

    $ALTIBASE_HOME/install/altibase_env.mk 파일을 참고하면 APRE 컴파일시에 최적화된 컴파일 및 링크 옵션들을 참조할 수 있다.

     

     

  3. 간단한 Makefile 예
    이제 SUN X86  cc 환경에서 APRE를 컴파일할 수 있는 가장 간단한 형태의 Makefile 이 아래와 같이 완성되었다.   이외에도  프로그램에서 참조하는 library 가  추가적으로 있다면 해당 Library 를  Makefile 에 추가적으로 기술해 주어야 한다. 플랫폼타입에  따라서 메모리 모델(32bit/64bit)  지정을 위한 옵션은 달라질 수 있으므로 앞서 설명한 컴파일 옵션표를 참조해서  플랫폼 타입에 맞게 설정한다.

    ALTI_INCLUDE=/altibase_home/include
    ALTI_LIBRARY=/altibase_home/lib
    LIBS=-lapre -lodbccli -lthread -lposix4 -ldl -lkvm -lkstat -lsocket -lnsl -lgen -lC -lCrun -ldemangle -lm
    LFLAGS= -fast -mt -xarch=amd64 -L/opt/SUNWspro/lib/amd64 -L/usr/lib/amd64

    connect1.c:connect1.sc

    /altibase_home/bin/apre -t c connect1.sc

    connect1:connect1.c

    /opt/SUNWspro/bin/cc $(LFLAGS) -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

    clean:

    rm *.c *.o


32비트 컴파일을 위한 Makefile 예

32bit 컴파일 옵션을 명시한 SUN X86 cc 용 APRE Makefile 의 예는 아래와 같다.   컴파일 옵션으로 "-xarch=sse2a"를 명시하고  Header 파일 과 Library를 참조하는 경로에   32bit 용 APRE Library가 설치되어 있는 경로를 지정해야 한다. 또한 APRE Precompiler도  32bit 용 APRE 가 실행되도록 경로를 명시한다

ALTI_INCLUDE=/alticlient32/include
ALTI_LIBRARY=/alticlient32/lib
LIBS=-lapre -lodbccli -lpthread -lrt -ldl -lkvm -lkstat -lsocket -lnsl -lgen -lm

LFLAGS= -fast -mt -xarch=sse2a -L/opt/SUNWspro/lib/amd64 -L/usr/lib/amd64

connect1.c:connect1.sc

/alticlient32/bin/apre -t c connect1.sc

connect1:connect1.c

/opt/SUNWspro/bin/cc $(LFLAGS) -o connect1 connect1.c -I$(ALTI_INCLUDE) -L$(ALTI_LIBRARY) $(LIBS)

clean:

rm *.c *.o

 

 

유의사항

앞에서는 이해를 돕기 위해 간단한 . sc소스의 make 과정에서 발생할 수 있는 몇 가지 오류와 해당 오류를  Makefile 수정을 통해 어떻게 해결하는지 살펴보았다. 컴파일관련 문제는 무엇보다도 어떤 유형의 문제인지를 파악하는 것이 가장 중요하다.

컴파일관련 문제발생시 아래항목은 기본적으로 확인되어야 할 사항이다.

  1. 컴파일러에 적합한 올바른 라이브러리를 사용하고 있는가?
  2. Makefile에 오류가 없는가? (경로 지정, 오타, 변수 명의 사용 등)
  3. 라이브러리 또는 오브젝트간의 컴파일 비트가 다르지 않는가?
  4. 필요한 벤더 사의 라이브러리를 정확히 링크하고 있는가?
  5. 필요한 시스템 라이브러리를 명시하고 있는가?
  6. C/C++ 간의 호환을 위한 라이브러리를 명시하고 있는가?

 

 

 

  • No labels