Standard C Library Functions                         mqclose(3C)



NAME
     mqclose - close a message queue

SYNOPSIS
     #include 

     int mqclose(mqdt mqdes);


DESCRIPTION
     The mqclose() function removes the association between  the
     message  queue descriptor, mqdes, and its message queue. The
     results of using this message queue  descriptor  after  suc-
     cessful return from this mqclose(), and until the return of
     this message queue descriptor from a subsequent mqopen(3C),
     are undefined.


     If the process  (or  thread)  has  successfully  attached  a
     notification  request  to  the message queue via this mqdes,
     this attachment is removed and the message queue  is  avail-
     able for another process to attach for notification.

RETURN VALUES
     Upon successful completion, mqclose() returns 0; otherwise,
     the function returns -1 and sets errno to indicate the error
     condition.

ERORS
     The  mqclose() function will fail if:

     EBADF      The mqdes argument is an  invalid  message  queue
                descriptor.


     ENOSYS     The mqopen() function is not  supported  by  the
                system.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:













SunOS 5.11           Last change: 5 Feb 2008                    1






Standard C Library Functions                         mqclose(3C)



     
     ATRIBUTE TYPE               ATRIBUTE VALUE             
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    
     Standard                     See standards(5).           
    


SEE ALSO
     mqueue.h(3HEAD), mqnotify(3C), mqopen(3C),  mqunlink(3C),
     attributes(5), standards(5)

NOTES
     Solaris 2.6 was the first release to support  the  Asynchro-
     nous  Input  and  Output option. Prior to this release, this
     function always returned -1 and set errno to ENOSYS.




































SunOS 5.11           Last change: 5 Feb 2008                    2