NAME
mq_unlink - 销毁一个消息队列 (REALTIME)
SYNOPSIS
#include <mqueue.h>
int mq_unlink(const char *name);
DESCRIPTION
函数 mq_unlink() 会从内核中删除名为name的消息队列.
如果该函数被调用了,但是仍然有进程已经打开了这个消息队列,那么这个消息队列的销毁会被推迟到所有的引用都被关闭时执行.
并且函数 mq_unlink() 不需要阻塞到所有的引用都被关闭为止,它会立即返回.
函数 mq_unlink()调用成功后, 如果在随后调用 mq_open() 时重用这个消息队列名字,效果就像这个名字的消息队列不存在,
如果没有设置O_CREAT标志,函数mq_open() 会返回失败,否则会创建一个新的消息队列.
PARAMETERS
①name
参数 name 是一个指向消息队列名字的指针.
名字的形式是 "/somename",是一个以NULL结尾的字符串,字符串的最大长度为NAME_MAX。
消息队列名字的第一个字符必须是"/",并且之后的字符中不允许出现"/"
RETURN VALUE
如果函数执行成功, 函数返回0
如果函数执行失败,函数返回 -1 并且设置errno,errno的种别详见下面的ERRORS一节.
ERRORS
[EACCES]
没有权限删除指定的消息队列.
[ENOENT]
指定的消息队列不存在.
[ENAMETOOLONG]
参数 name 的长度超过系统定义的最大长度.
在不支持XSI系统中,name 的长度超过了 {_POSIX_PATH_MAX},在支持XSI系统中,name 的长度超过了 {_XOPEN_PATH_MAX};或者
在不支持XSI系统中,某一级路径的长度超过了 {_POSIX_NAME_MAX},在支持XSI系统中,某一级路径的长度超过了 {_XOPEN_NAME_MAX};