Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       mq_getattr,  mq_setattr  -  Obtenir/definir les attributs d'une file de
       messages

SYNOPSIS

       #include <mqueue.h>

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

       int mq_setattr(mqd_t mqdes, struct mq_attr *newattr,
                        struct mq_attr *oldattr);

       Effectuez l'edition des liens avec l'option -lrt.

DESCRIPTION

       Les fonctions mq_getattr() et mq_setattr() extraient et  modifient  les
       attributs de la file de messages referencee par le descripteur mqdes.

       mq_getattr()  renvoie  une  structure mq_attr dans le tampon pointe par
       attr. Cette structure est definie comme suit :

           struct mq_attr {
               long mq_flags;       /* Drapeaux : 0 or O_NONBLOCK */
               long mq_maxmsg;      /* Max. # de messages dans la file */
               long mq_msgsize;     /* Max de la taille du message (octets) */
               long mq_curmsgs;     /* # de messages actuellement dans la file */
           };

       Le champ mq_flags contient des drapeaux associes a la description de la
       file  de  messages ouverte. Ce champ est initialise lorsque la file est
       creee avec mq_open(3). Le seul drapeau  qui  peut  apparaitre  dans  ce
       champ est O_NONBLOCK.

       Les  champs  mq_maxmsg  et  mq_msgsize  sont definis lorsque la file de
       messages est creee avec mq_open(3). Le champ mq_maxmsg  est  le  nombre
       maximal  de  messages  qui  peuvent  etre  places  dans  la  file  avec
       mq_send(3). Le champ mq_msgsize est la taille maximale des messages qui
       peuvent  etre  places dans la file. Chacun de ces champs doit avoir une
       valeur superieure a zero. Deux fichiers de  /proc  qui  plafonnent  ces
       valeurs pour ces champs sont decrites dans mq_open(3).

       Le  champ mq_curmsgs renvoie le nombre de messages actuellement dans la
       file.

       mq_setattr() definit les attributs de la  file  de  messages  avec  les
       informations  fournies par la structure mq_attr pointee par newattr. Le
       seul attribut qui peut  etre  modifie  est  le  drapeau  O_NONBLOCK  de
       mq_flags.  Les  autres  champs  de  newattr  sont  ignores. Si le champ
       oldattr est non NULL, alors le tampon qu'il  pointe  est  utilise  pour
       renvoyer  une structure mq_attr contenant les memes informations que la
       fonction mq_getattr() renverrait.

VALEUR RENVOY'EE

       En cas de succes, mq_getattr() et  mq_setattr()  renvoient  0.  En  cas
       d'erreur, elles renvoient -1 et definissent errno en consequence.

ERREURS

       EBADF  Le descripteur specifie dans mqdes n'est pas valable.

       EINVAL newattr->mq_flags   contient   des   bits   definis  autres  que
              O_NONBLOCK.

CONFORMIT'E

       POSIX.1-2001.

NOTES

       Sous  Linux,  mq_getattr()  et  mq_setattr()   sont  des  fonctions  de
       bibliotheque au dessus de l'appel systeme mq_getsetattr(2).

VOIR AUSSI

       mq_close(3),   mq_notify(3),   mq_open(3),  mq_receive(3),  mq_send(3),
       mq_unlink(3), mq_overview(7)

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis  2010,  cette  traduction est maintenue a l'aide de l'outil po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone        au        sein        du       projet       perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/> (2003-2006).  Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

       Veuillez  signaler  toute  erreur   de   traduction   en   ecrivant   a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

Linux                            29 aout 2010                    MQ_GETATTR(3)