mq_unlink2

Usage

Library

library “librt”

Overview

The mq_unlink() function removes the message queue named by the string name. If one or more processes have the message queue open when mq_unlink() is called, destruction of the message queue will be postponed until all references to the message queue have been closed. However, the mq_unlink() call need not block until all references have been closed; it may return immediately.

After a successful call to mq_unlink(), reuse of the name will subsequently cause mq_open(2) to behave as if no message queue of this name exists.

Return values

The mq_unlink() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

Errors

The mq_unlink() system call will fail if:

[EACCESS]

Permission is denied to unlink the message queue represented by name.

[EINVAL]

name is invalid.

[ENAMETOOLONG]

The length of the name argument exceeds {PATH_MAX} or a pathname component is longer than {NAME_MAX}.

[ENOENT]

The message queue does not exist.

[ENOSYS]

mqueuefs(4) module is neither loaded nor included in the kernel.