HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

181

182

183

184

185

186

187

188

189

190

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man2/!!!intro.2

________________________________________________________________

___ ___

mq_getattr(2) mq_getattr(2)

NAME

mq_getattr - get status information and attributes associated with a message queue

SYNOPSIS

#include <sys/mqueue.h>

int mq_getattr(mqd_t mqdes, struct mq_attr *mqstat);

DESCRIPTION

The mq_getattr() system call collects status information and attributes associated with the message

queue speciﬁed by mqdes which is copied into the mq_attr structure referenced by mqstat.

Upon a successful return, the mq_msgsize and mq_maxmsg ﬁelds within the mq_attr structure contain the

maximum size of a message for this queue and the maximum number of messages that can be queued at

any time. The mq_curmsgs ﬁeld contains the number of messages currently on the queue. In addition, the

mq_ﬂags ﬁeld contains the message queue blocking status associated with this mqdes.

RETURN VALUE

mq_getattr() returns the following values:

0 Successful completion.

-1 Failure. errno is set to indicate the error.

ERRORS

If mq_getattr() fails, errno is set to one of the following values:

[EBADF] mqdes is not a valid message queue descriptor.

[EINVAL] mqstat does not point to a valid mq_attr structure.

[ENOSYS]

mq_getattr() is not supported by the implementation.