Multi-file Projects and Makefiles

# CHAPTER 29

Multi-file Projects and Makefiles #

1. Introduction #

2. Learning Objectives #

• Separate function declarations into Header files.

• Place function definitions into Source files.

• Compile multiple files manually using GCC.

• Write a Makefile to automate compilation.

3. Project Structure #

1. 1. math_utils.h: The Header (Declarations).

1. 2. math_utils.c: The Implementation (Definitions).

1. 3. main.c: The Entry Point (Uses the functions).

4. Step 1: The Header File (math_utils.h) #

#ifndef MATH_UTILS_H
#define MATH_UTILS_H

// Function declarations (Prototypes)
int add(int a, int b);
int subtract(int a, int b);

#endif

5. Step 2: The Source File (math_utils.c) #

#include "math_utils.h"

int add(int a, int b) {
    return a + b;
}

int subtract(int a, int b) {
    return a - b;
}

6. Step 3: The Main File (main.c) #

#include <stdio.h>
#include "math_utils.h"

int main() {
    int sum = add(10, 5);
    int diff = subtract(10, 5);
    
    printf("Sum: %d, Diff: %d\n", sum, diff);
    return 0;
}

7. Compiling Manually #

$ gcc main.c math_utils.c -o calculator
$ ./calculator

8. The Compilation Process (Object Files) #

1. 1. Compile: Converts .c files into Object files (.o or .obj).

1. 2. Link: The Linker combines all .o files into one executable.

# 1. Compile into object files (using -c flag)
$ gcc -c main.c -o main.o
$ gcc -c math_utils.c -o math_utils.o

# 2. Link them into an executable
$ gcc main.o math_utils.o -o calculator

9. Automating with Makefiles #

Create a file exactly named Makefile (no extension):

# Define the compiler
CC = gcc

# Define the target executable name
TARGET = calculator

# Rule to build the target
$(TARGET): main.o math_utils.o
	$(CC) main.o math_utils.o -o $(TARGET)

# Rule to build main.o
main.o: main.c math_utils.h
	$(CC) -c main.c

# Rule to build math_utils.o
math_utils.o: math_utils.c math_utils.h
	$(CC) -c math_utils.c

# Clean rule to remove generated files
clean:
	rm *.o $(TARGET)

*(Note: The indents under rules MUST be a single Tab character, not spaces!)*

To compile the project, just type make in the terminal. To clean up, type make clean.

10. Common Mistakes #

• Putting code in header files: Never put function *definitions* (the actual code) in a .h file. If two .c files include that header, the Linker will crash with a "multiple definition" error. Headers are for declarations only!

• Spaces in Makefiles: If you use spaces instead of the Tab key for indentation in a Makefile, make will throw a "missing separator" error.

• Forgetting #ifndef: Without header guards, circular inclusions will crash the compiler.

11. Exercises #

1. 1. Expand the calculator project by adding multiply and divide functions in math_utils.c, update the header, and recompile.

1. 2. Intentionally remove the #include "math_utils.h" from main.c and observe the compiler warnings.

12. MCQ Quiz with Answers #

13. Interview Questions #

• Q: Explain the compilation pipeline (Pre-processing -> Compilation -> Assembly -> Linking).

• Q: What is the difference between a static library (.a) and a dynamic library (.so / .dll)?

• Q: Why does modifying one .c file using a Makefile compile so much faster than running gcc *.c? (Answer: Make checks timestamps and only recompiles the .c files that changed, reusing the .o files for the rest).

14. Summary #

15. Next Chapter Recommendation #