Manual Pages  — PTHREAD_MUTEX_INIT

pthread_mutex_init – create a mutex

LIBRARY SYNOPSIS DESCRIPTION RETURN VALUES ERRORS SEE ALSO STANDARDS

POSIX Threads Library (libpthread, -lpthread)

#include <pthread.h>

int
pthread_mutex_init(pthread_mutex_t *restrict mutex, const pthread_mutexattr_t *restrict attr);

The pthread_mutex_init() function creates a new mutex, with attributes specified with attr. If attr is NULL the default attributes are used.

If successful, pthread_mutex_init() will return zero and put the new mutex id into mutex, otherwise an error number will be returned to indicate the error.

The pthread_mutex_init() function will fail if:

[EINVAL]
	The value specified by attr is invalid.
[ENOMEM]
	The process cannot allocate enough memory to create another mutex.

The pthread_mutex_init() function conforms to IEEE Std 1003.1-96 ("POSIX.1").