mq_getattr(2)mq_getattr(2)NAMEmq_getattr - get status information and attributes associated with a
message queue
SYNOPSISDESCRIPTION
The system call collects status information and attributes associated
with the message queue specified by mqdes which is copied into the
structure referenced by mqstat.
Upon a successful return, the mq_msgsize and mq_maxmsg fields 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 field contains the number of messages currently on
the queue. In addition, the mq_flags field contains the message queue
blocking status associated with this mqdes.
To use this function, link in the realtime library by specifying on the
compiler or linker command line.
RETURN VALUE
returns the following values:
Successful completion.
Failure.
is set to indicate the error.
ERRORS
If fails, 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 strucā
ture.
[ENOSYS] is not supported by the implementation.
SEE ALSOmq_open(2), mq_setattr(2).
STANDARDS CONFORMANCEmq_getattr(2)