Content-type: text/html Man page of sem_unlink

sem_unlink

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

sem_unlink - Removes the specified named semaphore (P1003.1b)  

SYNOPSIS

#include <semaphore.h>

int sem_unlink (
const char *name) ;  

PARAMETERS

*name
The semaphore name.
 

DESCRIPTION

The sem_unlink function remove a semaphore named by the string name. If the semaphore is referenced by other processes, sem_unlink does not change the state of the semaphore.

If other processes have the semaphore open when sem_unlink is called, the semaphore is not destroyed until all references to the semaphore have been destroyed by calls to sem_close. The sem_unlink function returns immediately; it does not wait untill all references have been destroyed.

Calls to sem_open to recreate or reconnect to the semaphore refer to a new semaphore after sem_unlink is called.  

RETURN VALUES

On a successful call, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate that an error occurred.  

ERRORS

The sem_unlink function fails under the following conditions:

[EACCES]
Permission is denied to unlink the named semaphore.
[ENAMETOOLONG]
The length of the name string exceeds {NAME_MAX} while {_POSIX_NO_TRUNC} is in effect.
[ENOENT]
The named semaphore does not exist.
 

RELATED INFORMATION

Functions: sem_close(3), sem_open(3) delim off


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:59 GMT, October 02, 2010