[Makefile] Makefile 구조와 rule

📌 Makefile 구조

target: dependencies
    commands

• target: 만들고자 하는 파일 이름 (보통 실행 파일 또는 라이브러리 이름)
• dependencies: 해당 타겟을 생성하기 위해 필요한 파일들 (소스 파일, 헤더 파일 등)
• commands: dependencies를 이용해 target을 만드는 명령어
  명령어는 반드시 탭(tab)으로 시작해야 한다. 아니면 Makefile: missing separator 오류가 발생한다.

 

📌 ar

ar(archiver)은 여러 오브젝트 파일(.o)을 묶어서 하나의 정적 라이브러리(.a) 파일로 만들어주는 도구이다.

• .a파일은 정적 라이브러리로, 실행 파일을 컴파일할 때 코드가 프로그램에 직접 포함된다.
• 정적 라이브러리는 링킹 시점에 실행 파일에 병합되어서, 배포 시 별도의 라이브러리 파일이 필요하지 않다.
• 정적 라이브러리와는 다르게 동적 라이브러리(.so)는 프로그램 실행 시 필요하다.

 

-rcs 옵션

• r (replace): 기존 라이브러리에 파일이 있으면 덮어쓰기. 없으면 새로 추가.
• c (create): 새로운 라이브러리 생성. 만약 라이브러리가 이미 있어도 경고 메시지를 출력하지 않는다.
• s (index): 라이브러리의 인덱스 테이블 생성. 인덱스가 있어야 컴파일러가 라이브러리 내에서 심볼(symbol)을 쉽게 찾을 수 있다.

# file1.o, file2.o, file3.o 파일을 정적 라이브러리 libmylib.a로 묶기
ar rcs libmylib.a file1.o file2.o file3.o

libmylib.a라는 정적 라이브러리가 만들어지고, 링킹할 때 사용한다.

# main.c를 libmylib.a와 함께 컴파일
gcc main.c -L. -lmylib -o myprogram

lmylib는 libmylib.a를 링크하겠다는 의미이다.

 

ar 인덱스 확인 ar -t

라이브러리 내부에 어떤 파일들이 들어 있는지 확인하고 싶다면 아래 명령어를 실행한다.

ar -t libmylib.a

 

출력 예시

file1.o
file2.o
file3.o

 

📌 Makefile rules

1. all

all은 프로젝트를 빌드하는 타겟이다.
보통 make 명령만 입력하면 all이 실행된다. (make = make all)

 

역할
프로그램이나 라이브러리(.a 등)를 컴파일하고 생성한다.

 

예시

all: $(NAME)

$(NAME)은 .a 같은 최종 생성물을 의미한다.
all이 실행되면 오브젝트 파일을 만들어서 라이브러리를 생성하게 된다.

 

2. clean

clean은 컴파일 과정에서 생긴 오브젝트 파일(.o)을 삭제하는 규칙이다.
소스 파일과 최종 생성물은 남겨둔다.

 

역할
중간 산출물인 .o 파일들을 삭제한다.

 

예시

clean:
    rm -f $(OBJ)

rm -f $(OBJ)는 오브젝트 파일(.o)을 삭제한다.
$(OBJ)는 $(SRC:.c=.o)로 .c를 .o로 바꾼 목록이다.

 

3. fclean (full clean)

fclean은 clean이 하는 일을 포함하면서, 라이브러리(.a)나 실행 파일도 삭제한다.
모든 빌드 결과물을 완전히 제거할 때 사용한다.

 

역할
오브젝트 파일 + 최종 결과물(.a)을 모두 삭제한다.

 

예시

fclean: clean
    rm -f $(NAME)

 

4. re (rebuild)

re는 fclean 후 all을 다시 실행하는 규칙이다.
모든 파일을 지우고 처음부터 다시 빌드할 때 사용한다.

 

역할
완전히 빌드 과정 리셋 후 재컴파일한다.

 

예시

re: fclean all

make re를 실행하면 fclean으로 모든 파일을 삭제하고, all을 다시 실행해서 프로젝트를 새로 빌드한다.

 

Rule	설명	삭제 대상	최종 생성
all	프로젝트 빌드	없음	O
clean	오브젝트 파일 삭제	.o 파일	X
fclean	모든 빌드 산출물 삭제	.o + 라이브러리 등	X
re	모든 파일 삭제 후 재컴파일	.o, 라이브러리	O