home | help
PTHREAD_MUTEX_INIT(3)	     Library Functions Manual	   PTHREAD_MUTEX_INIT(3)

NAME
     pthread_mutex_init -- create a mutex

LIBRARY
     POSIX Threads Library (libpthread, -lpthread)

SYNOPSIS
     #include <pthread.h>

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

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

RETURN VALUES
     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.

ERRORS
     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  an-
			other mutex.

SEE ALSO
     pthread_mutex_destroy(3),	pthread_mutex_lock(3), pthread_mutex_trylock(3),
     pthread_mutex_unlock(3), pthread_mutexattr(3)

STANDARDS
     The  pthread_mutex_init()	function   conforms   to   ISO/IEC   9945-1:1996
     ("POSIX.1").

FreeBSD 15.1			 August 17, 2018	   PTHREAD_MUTEX_INIT(3)

home | help