mq_unlink Subroutine

Purpose

Removes a message queue.

Library

Standard C Library (libc.a)

Syntax

#include <mqueue.h>

int mq_unlink (name)
const char *name; 

Description

The mq_unlink subroutine removes the message queue named by the pathname name. After a successful call to the mq_unlink subroutine with the name parameter, a call to the mq_open subroutine with the name parameter and the O_CREAT flag will create a new message queue. If one or more processes have the message queue open when the mq_unlink subroutine is called, destruction of the message queue is postponed until all references to the message queue have been closed.

After a successful completion of the mq_unlink subroutine, calls to the mq_open subroutine to recreate a message queue with the same name will succeed. The mq_unlink subroutine never blocks even if all references to the message queue have not been closed.

Parameters

Return Values

Upon successful completion, the mq_unlink subroutine returns a zero. Otherwise, the named message queue is unchanged, and the mq_unlink subroutine returns a -1 and sets errno to indicate the error.

Error Codes