When debugging a program I came across a bug that was caused by using  in a multi-threaded program. I thought it's worth to write some words about mixing POSIX threads with  because there are non-obvious problems when doing that.

What happens after fork() in a multi-threadeed program

The   function creates a copy of the process, all memory pages are copied, open file descriptors are copied etc. All this stuff is intuitive for a UNIX programmer. One important thing that differs the child process from the parent is that the child has only one thread. Cloning the whole process with all threads would be problematic and in most cases not what the programmer wants. Just think about it: what to do with threads that are suspended executing a system call? So the   call clones just the thread which executed it.

What are the problems

Critical sections, mutexes

The non-obvious problem in this approach is that at the moment of the   call some threads may be in critical sections of code, doing non-atomic operations protected by mutexes. In the child process the threads just disappears and left data half-modified without any possibility to "fix" them, there is no way to say what other threads were doing and what should be done to make the data consistent. Moreover: state of mutexes is undefined, they might be unusable and the only way to use them in the child is to call  pthread_mutex_init() to reset them to a usable state. It's implementation dependent how mutexes behave after   was called. On my Linux machine locked mutexes are locked in the child.

Library functions

Problem with mutexes and critical code sections implies another non-obvious issue. It's theoretically possible to write your code executed in threads so that you are sure it's safe to call fork when such threads run but in practice there is one big problem: library functions. You're never sure if a library function you are using doesn't use global data. Even if it is thread safe, it may be achieved using mutexes internally. You are never sure. Even system library functions that are thread-safe may use locks internally. One non-obvious example is the  malloc()function which at least in multi-threaded programs on my system uses locks. So it's not safe to call   at the moment some other thread calls  malloc()! What the standard says about it? After   in a multi-threaded program you may only call async-safe functions (listed in  ). It's similar limitation to the list of functions you are allowed to call in a   and the reason is similar: in both cases the thread might be "interrupted" while executing a function.

Here is a list of few functions that use locks internally on my system, just to show you that really almost nothing is safe:

• malloc()
• stdio functions like printf() - this is required by the standard.
• syslog()

execve() and open file descriptors

It seems that calling   to start another program is the only sane reason you would like to call   in a multi-threaded program. But even doing that has at least one problem. When calling   one must remember that open file descriptors remain open and the program that was executed may read and write to them. It creates a problem if you leave open file descriptor at the time you call  that was not intended to be visible by the executed program. It even creates security issues in some cases. There is a solution for that: you must set the  FD_CLOEXEC flag on all file descriptors using   so they are automatically closed on new programs execution. Unfortunately it's not as simple in multi-threaded program. When using   to set the  FD_CLOEXEC flag there is a race:

When another thread executes  and  just between this thread does  but before  a new program is started having this file descriptor duplicated. This is not what we want. A solution was created with newer standards (like POSIX.1-2008) and newer Linux kernel (changes in 2.6.23 and later). We now have O_CLOEXEC flag to the  function, so the whole operation of opening a file and setting the FD_CLOEXEC flag is atomic.

There are other ways to create file descriptors than using : duplicating them with , creating sockets with  etc. All those functions have now a flag similar to O_CLOEXEC or a newer version that can take similar flag (some of them, like  does not have a flags argument, so  was created).

It's worth to mention that a similar thing may happen in a single threaded program when it does  and  in a signal handler. This operation is perfectly legal because both of the functions are async-safe and can be called from a signal handler, but the problem is the program may be interrupted between  and .

For more information about the new API to set FD_CLOEXEC flag see .

Useful system functions: pthread_atfork()

One useful function that tries to solve the problem with   in multi-threaded programs is  . It has the following prototype:

It allows to set handler functions that will be automatically executed on fork call:

• prepare - Called just before a new process is created.
• parent - Called after a new process is created in the parent.
• child - Called after a new process is created in the child.

The purpose of this call is to deal with critical sections of a multi-threaded program at the time  is called. A typical scenario is when in the prepare handler mutexes are locked, in the parent handler unlocked and in the child handler reinitialized.

Summary

In my opinion there are so many problems with   in multi-threaded programs that it's almost impossible to do it right. The only clear case is to call   in the child process just after  . If you want to do something more, just do it some other way, really. From my experience it's not worth trying to make the   call save, even with  pthread_atfork(). I truly hope you read this article before hitting problems described here.

Resources