Index for Section 3

Alphabetical listing for M

Bottom of page

mq_close(3)
NAME
  mq_close - Closes a message queue (P1003.1b)

LIBRARY
  Realtime Library (librt.so, librt.a)

SYNOPSIS
  #include <mqueue.h>

  int mq_close (
  mqd_t mqdes);

PARAMETERS
  mqdes	  Specifies a message queue descriptor.

DESCRIPTION
  The mq_close function closes a message queue.	 This function removes the
  association between the message queue descriptor, mqdes, and its open
  message queue description.  When all message queue descriptors associated
  with an open message queue description have been closed, the associated
  open message queue description is removed.  The message associated with the
  message queue will then be deleted if mq_unlink was already called, or is
  called after all processes have closed the queue.

RETURN VALUES
  On successful completion, the function returns the value 0 (zero);
  otherwise, the function returns the value -1 and sets errno to indicate the
  error.

ERRORS
  The mq_close function fails under the following conditions:

  [EBADF]	 The mqdes argument is an invalid message queue descriptor.

  [EFAULT]	 An internal virtual memory error occurred.

RELATED INFORMATION
  Functions: mq_open(3), mq_unlink(3)

  Guide to Realtime Programming

Index for Section 3

Alphabetical listing for M

Top of page