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

  man pages->IRIX man pages -> mq_unlink (3c)              


mq_unlink(3c)							 mq_unlink(3c)

NAME    [Toc]    [Back]

     mq_unlink - remove	a message queue

C SYNOPSIS    [Toc]    [Back]

     #include <mqueue.h>

     int mq_unlink (const char *mq_name<b>);

DESCRIPTION    [Toc]    [Back]

     mq_unlink removes the message queue named by the pathname,	mq_name.  If
     one or more processes has the message queue opened, the queue will	be
     removed after all the processes close the queue. When all the references
     to	the queue are gone the space occupied by the queue is released.	 After
     a successful call to unlink, the queue, mq_name, will not be accessible
     by	any process that does not already have access to the queue, by a call
     to	mq_open(3c).

     mq_unlink will fail if one	or more	of the following conditions are	true:

     [EACCES]	    Permission to remove the queue is denied.

     [EACCES]	    A component	of path	prefix has no search permission	or
		    does not exist.

     [EINTR]	    A signal interrupted the mq_unlink function	call.

     [ENOENT]	    The	named queue does not exist.

     [ENAMETOOLONG] The	length of the mq_name argument exceeds {PATH_MAX}, or
		    the	length of a mq_name component exceeds {NAME_MAX} while
		    {_POSIX_NO_TRUNC} is in effect.

SEE ALSO    [Toc]    [Back]

     mq_open(3c), mq_close(3c),	intro(3c), mq_receive(3c), mq_send(3c),
     mq_getattr(3c), mq_setattr(3c), mq_notify(3c)

DIAGNOSTICS    [Toc]    [Back]

     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of	-1 is returned and errno is set	to indicate the	error.

									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
ipcrm IRIX remove a message queue, semaphore set or shared memory id
ipcrm HP-UX remove a message queue, semaphore set, or shared memory identifier
pipcrm HP-UX remove a POSIX message queue or a POSIX named semaphore
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)
remque Tru64 General: Add or remove an element from the queue
insque Linux insert/remove an item from a queue
insque OpenBSD insert/remove element from a queue
insque Tru64 General: Add or remove an element from the queue
remque NetBSD insert/remove element from a queue
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service