02 간단한 Make 사용법

원문 : http://kkamagui.springnote.com/pages/359124

 

들어가기 전에...

0.시작하면서...

 통합 개발툴(IDE)를 이용해서 개발하는 경우에 굳이 Makefile을 생성할 필요는 없지만 IDE를 사용하지 않고 개발할 경우, 많은 소스파일을 관리하기위해서 makefile이 필수이다. make는 실제로 굉장히 많은 기능을 가지고 있지만, 그중 몇가지 유용한 기능만 알아도 훨씬 코드 관리가 편리해 진다.

 이제 그 몇가지에 대해서 알아보자. @0@)/~

1.makefile의 기본 형식

 makefile은 기본적으로 아래와 같은 형식으로 이루어진다.

1. Target File : Source File(Dependency) 
   1. <tab> command

 좌측의 Target File은 make command의 실행 결과로 생성할 파일이고 Source File은 make command에 사용될 파일이다. 아래의 command는 탭으로 한칸 띄우는데 이 탭이 command의 구분자의 역할을 한다. 만약 Abc.c 파일을 gcc -c로 컴파일 해서 Abc.o 파일을 생성한다면 아래와 같이 된다(주의-대소문자 구분함).

1. Abc.o : Abc.c 
   1. <tab> gcc -c Abc.o Abc.c

 실제로 여러 파일을 생성한다고 가정하면 위와 같은 코드들이 아래와 같이 나열된다.

1. # 이건 주석입니다.
2. Abc.o : Abc.c 
   1. <tab> gcc -c Abc.o \   <- 멀티라인 사용법
      1. Abc.c

3. Abb.o : Abb.c

   1. <tab> gcc -c Abb.o Abb.c
   
   

4. A.exe : Abc.o Abb.o

   1. <tab> gcc -o A.exe Abb.o Abc.o
5. ...... 반복.....

  주석은 #로 시작하고 멀티라인은 \를 마지막 라인에 추가하면 된다. 아주 간단하지 않는가? 위와 같이 파일을 생성하여 makefile을 만든 후, make.exe를 실행하면 자동으로 makefile을 읽어서 위의 조건에 따라 파일을 생성해 준다.

 만약 어떤 Target File이 생성되기 위해 다른 파일이 Target File이 필요한 경우 makefile이 알아서 필요한 파일 순서대로 결과 파일을 만든 후 최종 결과물을 만들어 준다. 위의 makefile을 수행하면 A.exe와 각종 .o 파일들이 생긴다.

2.매크로(Macro)의 사용

 만약 소스파일이 손으로 칠 수 없을 만큼 많다면? 또는 어떤 Target File을 생성하는데 규칙이 일정하다면?(.c 파일을 .o 파일로 바꾸는 것과 같은 경우) 과연 이런 경우에도 일일이 다 손으로 써줘야 할까?

 매크로를 이용하면 이것을 편리하게 할 수 있다. GNU-Make에서 매크로는 아래와 같이 정의하고 사용한다.

1. OBJECT = A.o B.o C.o
2. CC = gcc
3. A.exe : $(OBJECT) 
   1. <tab> $(CC) -o A.exe $(OBJECT)

 OBJECT 매크로가 없다면 일일이 손으로 저 파일들을 다 쳐줘야 할 것을 OBJECT 매크로를 정의함으로써 편리하게 해결했다.

 그럼 이제 좀더 이것을 확장해 보자. 일반적으로 .c 파일을 .o 파일로 만드는 규칙은 거의 동일하다. 컴파일 옵션에 -c 옵션을 줄 것이며 A.o A.c와 같은 같은 파일명을 사용하고 확장자만 다르다. 이것을 어떻게 간단하게 할 수 있을까? 답은 패턴 규칙을 이용하는 것이다. %를 사용하는 아래를 보자.

1. %.o : %.c

   1. <tab> gcc -c $@ $<
   
   

 위와 같이 하면, .c가 들어간 파일은 .o로 바꾸어 주는데 gcc -c 옵션을 적용하여 .o 파일을 생성한다. 즉 %는 확장자를 제외한 파일명을 의미한다. $@와 같은 생소한 문자를 볼 수 있는데, 이것은 make에서 미리 정의해둔 매크로로 아래와 같은 것들이 있다.

 그럼 패턴 규칙을 이용할때 파일명 그대로만 사용 가능할까? 답은 "그렇지 않다" 이다. 아래와 같은 사용도 가능하다.

1.  %_debug.o : %.c

   1. <tab> gcc -c $@ $<
   
   

 위처럼하면 파일이름에 _debug가 붙은 파일을 생성할 수 있다. 저 규칙을 잘 이용하면 여러가지 종류의 파일을 생성할 수 있다.

  자 그러면 매크로로 정의한 내용 중에 필요한 내용만 따로 치환할 수 는 없을까? 물론 가능하다. 아래는 .o를 .c로 치환하는 문장이다.

1. OBJECT = a.o b.o c.o d.o
2. SOURCE = $(OBJECT:.o=.c)

 아주 간단하지 않은가? @0@)/~ 정말 놀랍다. @0@)/~~!!!!

 그럼 만약 target에서 사용될 이름과 동일한 파일명이 존재한다면? 즉 make clean과 같이 clean을 사용해야 하는데 마침 clean의 이름을 가지는 항목이 있다면 어떻게 할까? make clean을 하면 해당 항목이 컴파일 될 것인데... 우리가 원하는 것은 그것이 아니다...

 이런 경우 아래와 같이 사용하면 된다.

1. .PHONY : clean

 .PHONY가 의미하는 것은 clean이 build의 대상이 아님을 말한다.

 이번에는 make 실행 시 입력값에 의해 Active하게 플래그를 변경해서 실행해 보자. makefile안에 여러 모드로 컴파일하는 기능도 넣어보자. 아무옵션이 없이 그냥 make만 실행되었을 때, 디폴트로 가는 레이블은 all 이다. 이 기능을 이용해서 디폴트 Target 파일을 지정해보고 clean 기능을 넣어서 .o 파일을 모두 지우게 하자.

1. all : A.exe
2. .... 어쩌구 저쩌구 ...
3. A.exe : $(OBJ) 
   1. <tab> $(CC) $(FLAG) $(OBJ)
4. .... 어쩌구 저쩌구 ...
5. clean :
   1. <tab> del *.o

 위 처럼 Source File 즉 Dependency에 아무것도 넣지 않거나 만들 Target File 명을 넣으면 된다. A.exe를 만들고 싶으면 "make"라고 입력하던지 "make all"이라고 입력하면 되고 clean 기능을 동작 시키려면 "make clean"이라고 입력하면 된다.

 조금 더 응용해서 make 시에 컴파일 플래그를 조절하도록 해보자

1. ifdef FULL
2. FLAG = -f -c
3. endif

  위와 같이 한 뒤에 "make FULL=yes" 라고 실행하면 FULL 플래그를 설정하여 FLAG를 활성화 시킬 수 있다.

3.디렉토리의 변경

 makefile을 생성하여 사용할때 여러개의 프로젝트를 동시에 빌드하여 하나의 output이 나와야 할 경우가 있다. 이런 경우 하위 폴더에 프로젝트들을 넣어두고 상위 폴더에 하위 폴더를 다 make 하는 형식을 사용하는데, 이때 각 프로젝트 폴더로 이동해서 해당 폴더의 makefile을 실행해야한다.

 이때 사용하는 옵션이 -C 이고 make를 실행하기 전에 폴더를 변경하라는 옵션이다.

1. make -C "Boot" -f makefile

위의 명령은 Boot 폴더로 폴더를 이용해서 make를 수행하라는 명령이다.

4.출력 메시지

 make 도중에 메시지를 화면에 출력하고 싶으면 @echo "메시지" 의 형태로 사용하면 된다.

1. @echo "빌드중입니다..."

5.마무리-makefile 적용

5.1 Build 파일을 직접 선택

 자 이제 이것을 실제로 적용해 보자. 아래의 makefile은 make에 대해서 잘 몰랐을 때, 노가다로 작성한 파일이다. 상당히 불현하고 특히 자주 파일이 추가되거나 변경되는 Custom 폴더의 경우 파일이 추가될때 마다 일일이 명령을 추가해줘야하는 단점이 있었다.

1. #   Kernel Make File
   #
   #   Written KKAMAGUI, http://kkamagui.egloos.com
2. all: Kkernel
3. # Compile 옵션
   GCC = gcc -ffreestanding -c
   NASM = nasm -f coff
   FWDIR = FW/
   CUSTOMDIR = Custom/
4. # Frame Work 파일
   # Compile할 파일 이름 다 적기
   A.o: $(FWDIR)Asm.asm
    $(NASM) -o A.o $(FWDIR)Asm.asm
   Is.o: $(FWDIR)Isr.asm
    $(NASM) -o Is.o $(FWDIR)Isr.asm
   K.o: $(FWDIR)Kernel.c
    $(GCC) -o K.o $(FWDIR)Kernel.c
   D.o: $(FWDIR)Descriptor.c
    $(GCC) -o D.o $(FWDIR)Descriptor.c
   Int.o: $(FWDIR)Interrupt.c
    $(GCC) -o Int.o $(FWDIR)Interrupt.c
   Key.o: $(FWDIR)Keyboard.c
    $(GCC) -o Key.o $(FWDIR)Keyboard.c
   Stdlib.o : $(FWDIR)stdlib.c
    $(GCC) -o Stdlib.o $(FWDIR)Stdlib.c
   Task.o : $(FWDIR)Task.c
    $(GCC) -o Task.o $(FWDIR)Task.c
5. # 응용 프로그램 파일
   FW.o : $(CUSTOMDIR)Framework.c
    $(GCC) -o FW.o $(CUSTOMDIR)FrameWork.c
   KShell.o : $(CUSTOMDIR)KShell.c
    $(GCC) -o KShell.o $(CUSTOMDIR)KShell.c
   Sched.o : $(CUSTOMDIR)Scheduler.c
    $(GCC) -o Sched.o $(CUSTOMDIR)Scheduler.c
6. #Object 파일 이름 다 적기
   #아래의 순서대로 링크된다.
   OBJ = A.o K.o Is.o D.o Int.o Key.o Stdlib.o Task.o FW.o KShell.o Sched.o
7. Kkernel: $(OBJ)
    ld $(OBJ) -o kkernel.bin --oformat binary -Ttext 0x100000
8. clean:
    del *.o

 위의 makefile을 배운 것을 이용하여 간단하게 정리하면 아래와 같이 쓸 수 있다.

1. #   Kernel Make File
   #
   #   Written KKAMAGUI, http://kkamagui.egloos.com
2. all: kernel
3. # Compile 옵션 및 폴더 설정
   GCC = gcc -ffreestanding -c
   NASM = nasm -f coff
   FWDIR = FW/
   CUSTOMDIR = Custom/
4. #Object 파일 이름 다 적기
   #아래의 순서대로 링크된다. 새로운 파일이 생기면 뒤에다 추가하자
   OBJ = Asm.o Kernel.o Isr.o Descriptor.o Interrupt.o Keyboard.o StdLib.o Task.o \
         FrameWork.o KShell.o Scheduler.o
5. #컴파일할 파일의 확장자에 따른 규칙
6. # FW 폴더 밑의 파일들 컴파일
7. %.o: $(FWDIR)%.asm
    $(NASM) -o $@ $<
   %.o: $(FWDIR)%.c
    $(GCC) -o $@ $<
8. # Custom 폴더 밑의 파일들 컴파일
   %.o : $(CUSTOMDIR)%.c
    $(GCC) -o $@ $<
9. # 최종 링크
   kernel: $(OBJ)
    ld $(OBJ) -o kkernel.bin --oformat binary -Ttext 0x100000
10. clean:
     del *.o

  우와~ 정말 깔끔해졌다. 확장 또한 한부분만 추가하면 되니까 훨씬 간단해 졌다. makefile 사용해서 효율적인 프로젝트 관리를 해보자.

5.2 특정 폴더의 특정 확장자의 파일을 모두 빌드

 이클립스 버전으로 옮겨가면서 makefile 또한 정리하였다. 자세한 내용은 21 OS 프레임워크 소스 릴리즈의 릴리즈 파일을 참고하도록하고 아래는 00Kernel 폴더의 makefile이다.

1. #   Kernel Make File
   #
   #   Written KKAMAGUI, http://kkamagui.egloos.com
2. all: kernel
3. # Compile 옵션 및 폴더 설정
   GCC = djgcc -ffreestanding -c
   LD = djld
   NASM = nasm -f coff
   FWDIR = FW
   CUSTOMDIR = Custom
   SOURCEDIR = $(FWDIR) $(CUSTOMDIR)
4. #Object 파일 이름 다 적기
   #아래의 순서대로 링크된다. 새로운 파일이 생기면 뒤에 다 추가하자
   #커널에 꼭 필요한 Object 파일들. ASM.o 파일은 항상 제일 앞에 와야한다. 그 이유는
   #커널의 엔트리포인트가 있는 함수이기 때문이다.
   ESSENTIALOBJ = Asm.o Isr.o
5. # 디렉토리에 있는 C 파일들을 다 찾아서 넣도록 한다.
   CFILE = $(foreach dir,$(SOURCEDIR),$(notdir $(wildcard $(dir)/*.c )))
   CFILEOBJ = $(CFILE:.c=.o)
6. #확장자 규칙을 이용해서 컴파일 한다.
   %.o: $(FWDIR)\%.asm
    $(NASM) -o $@ $<
   %.o: $(FWDIR)\%.c
    $(GCC) -o $@ $<
   %.o: $(CUSTOMDIR)\%.asm
    $(NASM) -o $@ $<
   %.o: $(CUSTOMDIR)\%.c
    $(GCC) -o $@ $<
    
   # 최종 링크
   kernel: $(ESSENTIALOBJ) $(CFILEOBJ)
    @echo "==> Making Kernel..."
    $(LD) $(ESSENTIALOBJ) $(CFILEOBJ) -o kkernel.bin --oformat binary -Ttext 0x100000
    @echo "==> Complete"
7. clean:
    del *.o
    del kkernel.bin

6.make 문법 quick reference

 GNU make의 quick refernce는 http://www.viper.pe.kr/docs/make-ko/make-ko_15.html 에서 찾을 수 있다.

이 부록은 GNU make 가 이해하는 지시어, 텍스트 조작 함수, 그리고 특수 변수들에 대해서 요약한 것이다. 다른 요약들을 보고자 한다면 See section 특수 내장 타겟 이름(Special Built-in Target Names), section 묵시적 규칙들의 카달로그(Catalogue of Implicit Rules), and section 옵션들의 요약(Summary of Options).

다음은 GNU make 가 인식하는 지시어들을 요약한 것이다:

define variable

endef

멀티-라인, 재귀적으로 확장되는 변수 하나를 정의한다.
See section 명령들을 묶어서 정의하기(Defining Canned Command Sequences).

ifdef variable

ifndef variable

ifeq (a,b)

ifeq "a" "b"

ifeq 'a' 'b'

ifneq (a,b)

ifneq "a" "b"

ifneq 'a' 'b'

else

endif

makefile 의 조건 평가 부분.
See section Makefile의 조건 부분(Conditional Parts of Makefiles).

include file

다른 makefile 을 포함한다.
See section 다른 makefile 삽입(Including Other Makefiles).

override variable = value

override variable := value

override variable += value

override define variable

endef

변수 하나를 정의하고 이전의 정의를 오버라이드하다. 심지어 명령행에서의 정의까지 오버라이드한다.
See section override 지시어.

export

make 에게 차일드 프로세스들에게 디폴트로 모든 변수들을 익스포트하도록 지시.
See section 서브-make에 대한 통신 변수(Communicating Variables to a Sub-make).

export variable

export variable = value

export variable := value

export variable += value

unexport variable

make 에게 특정한 변수를 차일드 프로세스들에게 익스포트할 것인가 아닌가를 지시한다.
See section 서브-make에 대한 통신 변수(Communicating Variables to a Sub-make).

vpath pattern path

`%' 패턴과 일치하는 파일들에 대해서 검색 경로를 지정.
See section vpath 지시어.

vpath pattern

pattern 로 사전에 지정된 모든 검색 경로들을 제거.

vpath

vpath 지시어에 의해서 사전에 지정된 모든 검색 경로들을 제거.

다음은 텍스트 조작 함수들의 요약이다 (see section 텍스트 변환을 위한 함수(Functions for Transforming Text)): Here is a summary of the text manipulation functions (see section 텍스트 변환을 위한 함수(Functions for Transforming Text)):

$(subst from,to,text)

text 에서 from 를 to 로 교체.
See section 문자 대입과 분석을 위한 함수들(Functions for String Substitution and Analysis).

$(patsubst pattern,replacement,text)

text 에서 pattern 과 일치하는 것을 replacement 로 교체.
See section 문자 대입과 분석을 위한 함수들(Functions for String Substitution and Analysis).

$(strip string)

string 로부터 여분의 공백 문자들을 제거.
See section 문자 대입과 분석을 위한 함수들(Functions for String Substitution and Analysis).

$(findstring find,text)

text 에서 find 를 찾음(locate).
See section 문자 대입과 분석을 위한 함수들(Functions for String Substitution and Analysis).

$(filter pattern...,text)

pattern 단어들중의 하나와 일치하는 text 내의 단어들을 선택.
See section 문자 대입과 분석을 위한 함수들(Functions for String Substitution and Analysis).

$(filter-out pattern...,text)

pattern 단어들중의 하나와 일치하지 않는 단어들을 text에서 선택.
See section 문자 대입과 분석을 위한 함수들(Functions for String Substitution and Analysis).

$(sort list)

list 에 있는 단어들을 사전식으로 소팅하고 중복된 것들을 제거.
See section 문자 대입과 분석을 위한 함수들(Functions for String Substitution and Analysis).

$(dir names...)

각 파일 이름에서 디렉토리 부분을 추출.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(notdir names...)

각 파일 이름에서 비-디렉토리 부분을 추출.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(suffix names...)

각 파일 이름의 확장자(마지막 `.'과 다음 문자들)를 추출.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(basename names...)

각 파일 이름의 몸체 이름(확장자를 뺀 이름)을 추출.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(addsuffix suffix,names...)

names 에 있는 각 단어의 뒤에다 suffix 를 붙인다.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(addprefix prefix,names...)

prefix 를 names 에 있는 각 단어 앞에다 붙인다.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(join list1,list2)

두 단어들의 병렬 리스트를 묶는다.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(word n,text)

text 에서 n번째 단어(시작은 1)를 추출한다.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(words text)

text 에서 단어들의 개수를 계산한다.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(firstword names...)

names 의 첫번째 단어를 추출한다.
See section 파일 이름들을 위한 함수(Functions for File Names).

$(wildcard pattern...)

쉘 파일 이름 패턴 (`%' 패턴이 아님) 과 일치하는 파일 이름들을 찾는다.
See section wildcard 함수(The Function wildcard).

$(shell command)

쉘 명령을 실행하고 그것의 결과를 리턴.
See section shell 함수(The shell Function).

$(origin variable)

make 변수 variable 가 정의된 방법을 설명하는 문자열을 리턴.
See section origin 함수(The origin Function).

$(foreach var,words,text)

words 에 있는 각 단어를 가리키는 var 로 text 를 평가하고 그 결과를 서로 붙인다.
See section foreach 함수(The foreach Function).

다음은 완전한 정보를 대신할 자동 변수들See section 자동 변수들(Automatic Variables)의 요약이다.

$@

타겟의 파일 이름.

$%

타겟이 아카이브 멤버일 때, 타겟의 멤버 이름.

$<

첫번째 종속물의 이름.

$?

타겟보다 더 새로운 모든 종속물들의 이름. 이들 사이는 스페이스들로 구분된다. 아카이브 멤버들인 종속물들의 경우 이름있는 멤버들만이 사용된다 (see section 아카이브 파일을 갱신하기 위해서 make 사용하기(Using make to Update Archive Files)).

$^

$+

모든 종속물들의 이름. 이들 사이는 공백으로 구분된다. 아카이브 멤버들인 종속물들의 경우 이름있는 멤버만이 사용된다 (see section 아카이브 파일을 갱신하기 위해서 make 사용하기(Using make to Update Archive Files)). $^의 값은 중복된 종속물들을 생략한다. 반면에 $+는 그들을 그대로 가지고 그들의 순서를 유지한다.

$*

묵시적인 규칙이 매치된 줄기 (see section 패턴 비교 방법(How Patterns Match)).

$(@D)

$(@F)

$@의 디렉토리-안에 있는-파일 부분과 디렉토리 부분.

$(*D)

$(*F)

$*의 디렉토리-안에 있는-파일 부분과 디렉토리 부분.

$(%D)

$(%F)

$%의 디렉토리-안에 있는-파일 부분과 디렉토리 부분.

$(<D)

$(<F)

$<의 디렉토리-안에 있는-파일 부분과 디렉토리 부분.

$(^D)

$(^F)

$^의 디렉토리-안에 있는-파일 부분과 디렉토리 부분.

$(+D)

$(+F)

$+의 디렉토리-안에 있는-파일 부분과 디렉토리 부분.

$(?D)

$(?F)

$?의 디렉토리-안에 있는-파일 부분과 디렉토리 부분.

다음 변수들은 GNU make에 의해서 특별하게 사용된다:

MAKEFILES

make 의 모든 실행때마다 읽히는 makefile들.
See section MAKEFILES 변수(The Variable MAKEFILES).

VPATH

현재 디렉토리에서 찾을 수 없는 파일들에 대한 디렉토리 검색 경로.
See section VPATH: 모든 종속물에 대한 검색 패스(Search Path for All Dependencies).

SHELL

시스템의 디폴트 명령 해석기의 이름. 일반적으로 `/bin/sh'. 명령들을 실행하는 데 사용되는 쉘을 변경하기 위해서 makefile 에서 SHELL 을 설정할 수 있다. See section 명령 실행(Command Execution).

MAKESHELL

MS-DOS 에서만 사용되며 make 에 의해서 사용되는 명령 해석기의 이름. 이 값은 SHELL 의 값보다 우선한다. See section 명령 실행(Command Execution).

MAKE

make 가 호출된 이름. 이 변수를 명령에서 사용하는 것은 특수한 의미가 있다. See section MAKE 변수가 작동하는 방법(How the MAKE Variable Works).

MAKELEVEL

재귀적 진입의 단계 번호 (서브-make들의).
See section 서브-make에 대한 통신 변수(Communicating Variables to a Sub-make).

MAKEFLAGS

make 에 주어진 플래그들. 플래그들을 설정하기 위해서 환경에서나 makefile 안에서 이것을 설정할 수 있다.
See section 서브-make에 대한 통신 옵션(Communicating Options to a Sub-make).

MAKECMDGOALS

make 에 대해서 명령행에서 주어진 타겟. 이 변수를 설정하는 것은 make 의 작업에 어떤 영향도 미치지 않는다.
See section goal을 지정하는 매개변수(Arguments to Specify the Goals).

CURDIR

현재 작업 디렉토리(모든 -C 옵션들이, 있다면 처리된 후)의 경로명으로 설정된다. 이 변수를 설정하는 것은 make 의 작업에 어떤 영향도 미치지 않는다.
See section make의 재귀적 사용(Recursive Use of make).

SUFFIXES

make 가 makefile 들을 읽기 전의 접미사들의 디폴트 리스트.