No manual entry for -- in section 3 sem_init(3) Library Functions Manual sem_init(3) NAME sem_init - initialize an unnamed semaphore LIBRARY POSIX threads library (libpthread, -lpthread) SYNOPSIS #include <semaphore.h> int sem_init(sem_t *sem, int pshared, unsigned int value); DESCRIPTION sem_init() initializes the unnamed semaphore at the address pointed to by sem. The value argument specifies the initial value for the sema- phore. The pshared argument indicates whether this semaphore is to be shared between the threads of a process, or between processes. If pshared has the value 0, then the semaphore is shared between the threads of a process, and should be located at some address that is vis- ible to all threads (e.g., a global variable, or a variable allocated dynamically on the heap). If pshared is nonzero, then the semaphore is shared between processes, and should be located in a region of shared memory (see shm_open(3), mmap(2), and shmget(2)). (Since a child created by fork(2) inherits its parent's memory mappings, it can also access the semaphore.) Any process that can access the shared memory region can operate on the sem- aphore using sem_post(3), sem_wait(3), and so on. Initializing a semaphore that has already been initialized results in undefined behavior. RETURN VALUE sem_init() returns 0 on success; on error, -1 is returned, and errno is set to indicate the error. ERRORS EINVAL value exceeds SEM_VALUE_MAX. ENOSYS pshared is nonzero, but the system does not support process- shared semaphores (see sem_overview(7)). ATTRIBUTES For an explanation of the terms used in this section, see attributes(7). +--------------------------------------------+---------------+---------+ | Interface | Attribute | Value | +--------------------------------------------+---------------+---------+ | sem_init() | Thread safety | MT-Safe | +--------------------------------------------+---------------+---------+ STANDARDS POSIX.1-2008. HISTORY POSIX.1-2001. Bizarrely, POSIX.1-2001 does not specify the value that should be re- turned by a successful call to sem_init(). POSIX.1-2008 rectifies this, specifying the zero return on success. EXAMPLES See shm_open(3) and sem_wait(3). SEE ALSO sem_destroy(3), sem_post(3), sem_wait(3), sem_overview(7) Linux man-pages 6.9.1 2024-05-02 sem_init(3)