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)