How do you include pthread in a C Makefile?

To include the `pthread` library in a C Makefile, you need to link against the library during the linking phase. The `pthread` library is typically called `libpthread.so` or a similar variation, and is usually linked with the `-lpthread` flag.

Here's a breakdown of how to modify your Makefile to include `pthread`:

1. Basic C Makefile (Without pthreads)

Let's start with a typical C Makefile without any threading:

CC = gcc
CFLAGS = -Wall -g
TARGET = myprogram
SOURCES = main.c helpers.c
OBJECTS = $(SOURCES:.c=.o)

$(TARGET): $(OBJECTS)
  $(CC) $(CFLAGS) -o $(TARGET) $(OBJECTS)

%.o: %.c
  $(CC) $(CFLAGS) -c $< -o $@

clean:
  rm -f $(TARGET) $(OBJECTS)

2. Adding pthreads to the Makefile

To use pthreads, you need to add the `-lpthread` flag to the linker command. Here's the modified Makefile:

CC = gcc
CFLAGS = -Wall -g
LDFLAGS = -lpthread
TARGET = myprogram
SOURCES = main.c helpers.c
OBJECTS = $(SOURCES:.c=.o)

$(TARGET): $(OBJECTS)
  $(CC) $(CFLAGS) $(LDFLAGS) -o $(TARGET) $(OBJECTS)

%.o: %.c
  $(CC) $(CFLAGS) -c $< -o $@

clean:
  rm -f $(TARGET) $(OBJECTS)

Explanation of Changes:

• `LDFLAGS = -lpthread`: We've introduced a new variable `LDFLAGS` to hold linker flags. The `-lpthread` flag tells the linker to link against the pthread library.

• `$(CC) $(CFLAGS) $(LDFLAGS) -o $(TARGET) $(OBJECTS)`: The `-lpthread` flag is added to the linking command, alongside the compiler flags and output target specification.

3. Example Usage:

Here's a simple example of how you might use pthreads in a main.c file:

#include <stdio.h>
#include <pthread.h>

void thread_function(void arg) {
  printf("Hello from a thread!\\n");
  pthread_exit(NULL);
}

int main() {
  pthread_t thread_id;
  int result;

  result = pthread_create(&thread_id, NULL, thread_function, NULL);
  if (result != 0) {
    perror("Failed to create thread");
    return 1;
  }

  pthread_join(thread_id, NULL);
  printf("Thread completed\\n");
  return 0;
}

4. Important Considerations:

• Ensure you have the pthreads development libraries installed on your system. If you get a linker error (undefined reference to `pthread_create` etc.), you might need to install it. On Debian-based systems, this usually involves installing `libpthread-stubs0-dev`.

• The `-lpthread` flag must be placed during the linking phase and not during compilation with `-c`. It specifies which libraries to include in the final executable file.

• Be aware of potential errors during the linking phase. If the system cannot find `libpthread.so`, you might have to ensure the correct linker path is set up.

By adding the `-lpthread` flag to your Makefile's linker command, you can successfully use the pthread library for multi-threaded programming in your C applications.

Learn more about this