mq_getattr(2) System Calls Manual mq_getattr(2)
NAME
mq_getattr - get status information and attributes associated with a message queue
SYNOPSIS
DESCRIPTION
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 structure.
[ENOSYS] is not supported by the implementation.
SEE ALSO
mq_open(2), mq_setattr(2).
STANDARDS CONFORMANCE
mq_getattr(2)
