NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO
#include <posix/unistd.h> #include <sys/mman.h>int shm_unlink(const char *name);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
POSIX_SHM
The shm_unlink() system call removes the name of the shared memory object named by the string pointed to by name. If one or more references to the shared memory object exist when the object is unlinked, the name is removed before shm_unlink returns. Removal of the memory object contents will be postponed until all open and map references to the shared memory object have been removed.
Upon successful completion, shm_unlink() returns a value of 0. Otherwise, it returns -1 and sets errno to indicate the error condition. If -1 is returned, the named shared memory object will not be changed by this call.
Permission to unlink the shared memory object, name is denied.
The shm_unlink() function is not supported.
The POSIX_SHM feature is not configured.
The name string exceeds SHM_PATHMAX as returned by aconf(2K) or sysconf(3POSIX).
The name shared memory object does not exist.
name points outside the allocated address space of the process.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO