NAME    [Toc]    [Back]

       mq_unlink - Removes a message queue (P1003.1b)

SYNOPSIS    [Toc]    [Back]

       #include <mqueue.h>

       int mq_unlink ( const char *name);

LIBRARY    [Toc]    [Back]

       Realtime Library (librt.so, librt.a)

PARAMETERS    [Toc]    [Back]

       Specifies a pointer to the pathname of a message queue.

DESCRIPTION    [Toc]    [Back]

       The  mq_unlink  function  removes a message queue named by
       the pathname. After a successful call  to  this  function,
       subsequent  calls  to  the  mq_open  function fail if they
       specify the queue identified by the name argument and  the
       O_CREAT option is not set.

       Close  the  connection  to  the  queue  with a call to the
       mq_close function before calling the  mq_unlink  function.
       If  one or more processes have the message queue open when
       mq_unlink is called, destruction of the queue is postponed
       until  all references to the message queue are removed. In
       this situation, the  mq_unlink  function  returns  immediately,
  without  waiting  for  all  queue references to be
       closed.

RETURN VALUES    [Toc]    [Back]

       On successful completion, the function returns the value 0
       (zero); otherwise, the function returns the value -1, sets
       errno  to  indicate  the  error,  and  the  message  queue
       remains.

ERRORS    [Toc]    [Back]

       The  mq_unlink  function  fails under the following conditions:


       Permission is denied to unlink  the  message  queue.   The
       length   of  the  name  string  exceeds  {NAME_MAX}  while
       {_POSIX_NO_TRUNC} is in effect.  The named  message  queue
       does not exist.

       Additionally,  any  error that can be returned by the open
       or  fstat  file  system  calls  can  be  returned  by  the
       mq_unlink function.

SEE ALSO    [Toc]    [Back]

       Functions: mq_close(3), mq_open(3)

       Guide to Realtime Programming



                                                     mq_unlink(3)