mq_unlink

Langue: en

Version: DECEMBER 2002 (mandriva - 01/05/08)

Autres sections - même nom

Section: 2 (Appels système)

NAME

mq_unlink - remove a message queue

SYNOPSIS

gcc [ flag... ] file ... -lmqueue [ library... ]

#include <mqueue.h>

int mq_unlink(const char *name);

DESCRIPTION

The mq_unlink() function removes the message queue named by the pathname name. After a successful call to mq_unlink() with name, a call to mq_open() with name fails if the flag O_CREAT is not set in flags. If one or more processes have the message queue open when mq_unlink() is called, destruction of the message queue is postponed until all references to the message queue have been closed. The mq_unlink() call will not block until all references have been closed; it will return immediately.

RETURN VALUES

Upon successful completion, mq_unlink() returns 0; otherwise, the named message queue is not changed by this function call, the function returns -1 and sets errno to indicate the error.

DIAGNOSTICS

The mq_unlink() function will fail if:
EPERM or EACCES
Permission is denied to unlink the named message queue.
EFAULT
name points outside your accessible address space.
ENAMETOOLONG
name was too long.
EINVAL
name doesn't begin with '/' character.
ENOMEM
Insufficient kernel memory was available.
ENOENT
The named message queue does not exist.

AUTHORS

Michal Wronski <wrona@mat.uni.torun.pl>
Krzysztof Benedyczak <golbi@mat.uni.torun.pl>

CONFORMING TO

IEEE Std 1003.1-2001

SEE ALSO

mq_open(2), mq_close(2)