*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> mq_unlink (3)              



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

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

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

[ Back ]
 Similar pages
Name OS Title
mq_open Tru64 Establishes the connection between a message queue and a message queue descriptor (P1003.1b)
mq_receive Tru64 Receives the oldest, highest-priority message from the message queue (P1003.1b)
mq_close Tru64 Closes a message queue (P1003.1b)
mq_send Tru64 Places a message in the message queue (P1003.1b)
mq_getattr Tru64 Returns the status and attributes of a message queue (P1003.1b)
mq_setattr Tru64 Sets the mq_options attributes associated with a message queue (P1003.1b)
mq_notify Tru64 Attaches a request for asynchronous signal notification to a message queue (P1003.1b)
flushq Tru64 STREAMS: Removes a message from a queue
rmvq Tru64 STREAMS: Removes a message block from a queue
ipcrm Tru64 Removes message queue, semaphore set, or shared memory identifiers
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service