How to Compile C Programs with POSIX Threads on Linux

On Linux, pthread support comes from the system C library. You normally do not install a package named pthread. Include pthread.h, compile with GCC’s -pthread option, and use the POSIX thread application programming interface in your program.

Compile a pthread program with GCC

Save this program as pthread_demo.c.

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

static void *worker(void *arg) {
    const char *message = arg;
    printf("%s\n", message);
    return NULL;
}

int main(void) {
    pthread_t thread;
    if (pthread_create(&thread, NULL, worker, "worker thread ran") != 0) return 1;
    if (pthread_join(thread, NULL) != 0) return 1;
    puts("main thread finished");
    return 0;
}

Compile and run it with this command. The recorded GCC run printed worker thread ran followed by main thread finished.

gcc -Wall -Wextra -pthread pthread_demo.c -o pthread_demo && ./pthread_demo

The -pthread option affects compilation and linking. GCC documents it as the thread-support option, so use it for a POSIX thread program instead of adding -lpthread only at the end of the command.

Install a C development toolchain

You need a C compiler and the development files supplied by your Linux distribution. On Debian or Ubuntu, install build-essential. Fedora, RHEL, and compatible systems use Development Tools, while Arch Linux supplies GCC through the gcc package.

Check the installed thread implementation with getconf GNU_LIBPTHREAD_VERSION. The test command returned NPTL 2.41, the GNU Native POSIX Thread Library interface used by the compiler.

Why a pthread package is missing

pthread is an interface defined by POSIX, not a separate runtime package that ordinary Linux C programs fetch from a repository. The header and implementation arrive with the C library and development toolchain.

If GCC reports pthread.h: No such file or directory, install your distribution’s compiler development package. If linking reports an undefined reference to pthread_create, add -pthread to the GCC command and compile every source file that uses thread-aware headers with the same option.

Use an explicit thread lifecycle

pthread_create receives a function that returns void pointer and one argument pointer. pthread_join gives the calling thread a defined point to wait for completion.

Pass shared data only after deciding who owns it and when it can change. Create and join are enough for this example, but shared counters and collections need a mutex or another synchronization primitive before concurrent writes begin.

Continue with Linux C tooling

These LinuxForDevices tutorials help with the next compiler or build task.

• GCC flags that change compilation behavior
• build and run C or C++ code from the terminal
• install CMake for larger C projects
• set up the standard C development headers
• install G++ on Red Hat Linux

Keep -pthread in your build command, then add synchronization only where shared state requires it. That gives you a small program whose thread lifetime is explicit before the program grows.