Puts a process to sleep when a semaphore is busy.
Standard C Library (libc.a)
#include <sys/mman.h>
int msleep (Sem)
msemaphore * Sem;
The msleep subroutine puts a calling process to sleep when a semaphore is busy. The semaphore should be located in a shared memory region. Use the mmap subroutine to create the shared memory section.
All of the values in the msemaphore structure must result from a msem_init subroutine call. This call may or may not be followed by a sequence of calls to the msem_lock subroutine or the msem_unlock subroutine. If the msemaphore structure value originates in another manner, the results of the msleep subroutine are undefined.
The address of the msemaphore structure is significant. You should be careful not to modify the structure's address. If the structure contains values copied from a msemaphore structure at another address, the results of the msleep subroutine are undefined.
| Sem | Points to the msemaphore structure that specifies the semaphore. |
If the msleep subroutine is unsuccessful, the errno global variable is set to one of the following values:
The mmap (mmap or mmap64 Subroutine) subroutine, msem_init (msem_init Subroutine) subroutine, msem_lock (msem_lock Subroutine) subroutine, msem_unlock (msem_unlock Subroutine) subroutine, mwakeup (mwakeup Subroutine) subroutine.
Understanding Memory Mapping in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.