Manual Pages for UNIX Operating System command usage for man sem_unlink

Standard C Library Functions                       sem_unlink(3C)



NAME
     sem_unlink - remove a named semaphore

SYNOPSIS
     #include 

     int sem_unlink(const char *name);


DESCRIPTION
     The sem_unlink() function removes the semaphore named by the
     string  name.  If  the  semaphore named by name is currently
     referenced by other  processes,  then  sem_unlink()  has  no
     effect  on  the  state  of  the  semaphore.   If one or more
     processes have  the  semaphore  open  when  sem_unlink()  is
     called,  destruction of the semaphore is postponed until all
     references to the semaphore have been destroyed by calls  to
     sem_close(3C),  _Exit(2),  or one of the exec functions (see
     exec(2)) . Calls to sem_open(3C) to re-create or  re-connect
     to   the   semaphore   refer   to   a  new  semaphore  after
     sem_unlink() is called.   The  sem_unlink()  call  does  not
     block  until  all references have been destroyed; it returns
     immediately.

RETURN VALUES
     Upon successful completion, sem_unlink() returns  0.  Other-
     wise,  the semaphore is not changed and the function returns
     a value of -1 and sets errno to indicate the error.

ERRORS
     The  sem_unlink() function will fail if:

     EACCES           Permission is denied to  unlink  the  named
                      semaphore.


     ENAMETOOLONG     The length of name string exceeds PATH_MAX,
                      or  a  pathname  component  is  longer than
                      NAME_MAX  while   _POSIX_NO_TRUNC   is   in
                      effect.


     ENOENT           The named semaphore does not exist.


     ENOSYS           The sem_unlink() function is not  supported
                      by the system.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                       sem_unlink(3C)



     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     exec(2),  exit(2),   sem_close(3C),   sem_open(3C),   attri-
     butes(5), standards(5)

NOTES
     Solaris 2.6 was the first release to support  the  Asynchro-
     nous  Input  and  Output option. Prior to this release, this
     function always returned -1 and set errno to ENOSYS.




































SunOS 5.11           Last change: 5 Feb 2008                    2