Content-type: text/html Man page of mq_setattr

mq_setattr

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

NAME

mq_setattr - Sets the mq_flags attributes associated with a message queue (P1003.1b)  

SYNOPSIS

#include <mqueue.h>

int mq_setattr (
mqd_t mqdes,
const struct mq_attr *mqstat,
struct mq_attr *omqstat);  

PARAMETERS

mqdes
Describes the message queue for which attributes are to be set.
*mqstat
A pointer to a mq_attr structure that specifies attributes to be set for the specified message queue.
*omqstat
A pointer to a mq_attr structure that stores the previous message queue attributes and the current queue status. These are the values that would be returned by a call to the mq_getattr function at that point.
 

DESCRIPTION

Sets the mq_flags attributes associated with the message queue descriptor for the calling process. Only the blocking attribute of the queue for the calling process can be modified through this call. Modifying the blocking attribute for a queue has no effect on currently blocked processes. Other members of the mq_attr structure are ignored by the mq_setattr function.  

RETURN VALUES

On successful completion, the function returns the value 0 and the message queue attributes will have been changed as specified.

Otherwise, the value -1 is returned, errno is set to indicate the error, and the message queue attributes remain unchanged.  

ERRORS

The mq_setattr function fails under the following conditions:

[EBADF]
The mqdes argument is not a valid message queue descriptor.
[EINVAL]
The mqstat argument is a NULL pointer.
 

RELATED INFORMATION

Functions: mq_open(3), mq_send(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:40:48 GMT, October 02, 2010