Rechercher une page de manuel
mq_unlink
Langue: en
Version: DECEMBER 2002 (mandriva - 01/05/08)
Section: 2 (Appels système)
NAME
mq_unlink - remove a message queueSYNOPSIS
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-2001SEE ALSO
mq_open(2), mq_close(2)Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre