Content-type: text/html Man page of mq_unlink

mq_unlink

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

mq_unlink - Removes a message queue (P1003.1b)  

SYNOPSIS

#include <mqueue.h>

int mq_unlink (
const char *name);  

PARAMETERS

*name
A pointer to the pathname of a message queue.
 

DESCRIPTION

Removes a message queue named by the pathname. After a successful call to this function, subsequent calls to the mq_open function fail if they specify the queue identified by the name argument and the O_CREAT flag is not set.

Close the connection to the queue with a call to the mq_close function before calling the mq_unlink function. If one or more processes have the message queue open when mq_unlink is called, destruction of the queue is postponed until all references to the message queue are removed. In this situation, the mq_unlink function returns immediately, without waiting for all queue references to be closed.  

RETURN VALUES

On successful completion, the function returns the value 0; otherwise, the function returns the value -1, sets errno to indicate the error, and the message queue remains.  

ERRORS

In addition to the following errors, any error that can be returned by the open or fstat file system calls can be returned by the mq_unlink function.

[EACCES]
Permission is denied to unlink the message queue.
[ENAMETOOLONG]
The length of the name string exceeds {NAME_MAX} while {_POSIX_NO_TRUNC} is in effect.
[ENOENT]
The named message queue does not exist.
 

RELATED INFORMATION

Functions: mq_close(3), mq_open(3) delim off


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:03 GMT, October 02, 2010