*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> mq_getattr (2)              
Title
Content
Arch
Section
 

Contents


 mq_getattr(2)                                                 mq_getattr(2)




 NAME    [Toc]    [Back]
      mq_getattr - get status information and attributes associated with a
      message queue

 SYNOPSIS    [Toc]    [Back]
      #include <sys/mqueue.h>

      int mq_getattr(mqd_t mqdes, struct mq_attr *mqstat);

 DESCRIPTION    [Toc]    [Back]
      The mq_getattr() system call collects status information and
      attributes associated with the message queue specified by mqdes which
      is copied into the mq_attr 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 -lrt
      on the compiler or linker command line.

 RETURN VALUE    [Toc]    [Back]
      mq_getattr() returns the following values:

           0    Successful completion.

           -1   Failure.  errno is set to indicate the error.

 ERRORS    [Toc]    [Back]
      If mq_getattr() fails, errno 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]       mq_getattr() is not supported by the
                          implementation.

 SEE ALSO    [Toc]    [Back]
      mq_open(2), mq_setattr(2).

 STANDARDS CONFORMANCE    [Toc]    [Back]
      mq_getattr(): POSIX 1003.1b


 Hewlett-Packard Company            - 1 -      HP-UX 11i Version 2: Sep 2004
[ Back ]
      
      
 Similar pages
Name OS Title
mq_getattr Tru64 Returns the status and attributes of a message queue (P1003.1b)
miser_qinfo IRIX query information on miser queues, queue resource status, and list of jobs scheduled against a queue
mq_setattr HP-UX set the blocking status of a message queue associated with a descriptor
mq_setattr IRIX set attributes of a message queue
mq_getattr IRIX get attributes of a message queue
mq_setattr Tru64 Sets the mq_options attributes associated with a message queue (P1003.1b)
mq_open Tru64 Establishes the connection between a message queue and a message queue descriptor (P1003.1b)
mq_receive Tru64 Receives the oldest, highest-priority message from the message queue (P1003.1b)
mq_send Tru64 Places a message in the message queue (P1003.1b)
msgsnd Tru64 Send a message to a message queue
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service