.\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\" 
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date.  The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein.  The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\" 
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Traduction 14/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 8/04/97
.\" Mise a jour 18/04/97
.\" Mise a jour 19/07/97
.TH MSGOP 2 "19 Juillet 1997" "Linux" "Manuel du programmeur Linux"
.SH NOM
msgop, msgrcv, msgsnd \- Oprations sur les messages.
.SH SYNOPSIS
.nf
.B
# include <sys/types.h>
.br
.B
# include <sys/ipc.h>
.br
.B
# include <sys/msg.h>
.fi
.sp
.BI "int msgsnd (int " msqid ,
.BI "struct msgbuf * " msgp ,
.BI "int " msgsz ,
.BI "int " msgflg ")"
.sp
.BI "int msgrcv (int " msqid ,
.BI "struct msgbuf * " msgp ,
.BI "int " msgsz ,
.BI "long " msgtyp ,
.BI "int " msgflg ")"
.SH DESCRIPTION
Pour envoyer ou recevoir un message, le processus appelant alloue
une structure comme celle-ci :

.nf
struct msgbuf {
  long  mtype;    /* type de message ( > 0 ) */
  char  mtext[1]; /* contenu du message      */
};
.fi

avec une table
.B mtext
de taille
.IR msgsz ,
valeur entire non-ngative.

Le membre 
.B mtype
doit avoir une valeur strictement positive qui puisse
tre utilise par le processus lecteur pour la
slection de messages (voir plus bas).
.PP
Le processus doit avoir une permission d'criture sur la
file pour envoyer un message, et une permission de
lecture pour en recevoir un.
.PP
L'appel systme
.B msgsnd
insre une copie du message point par l'argument
.I msgp
dans la file dont l'identificateur est indiqu par la valeur
de l'argument
.IR msqid .
.PP
L'argument
.I msgflg
prcise le comportement de l'appel systme si l'insertion du
nouveau message ncessite plus de
.B msg_qbytes
dans la file.
En indiquant
.B IPC_NOWAIT
le message ne sera pas envoy et l'appel systme chouera en retournant
.BR EAGAIN
dans
.BR errno .

Sinon, le processus sera suspendu jusqu' ce que la condition de
blocage soit leve (auquel cas le message sera envoy et l'appel
systme russira), ou que la file soit supprime
(auquel cas l'appel systme chouera et 
.B errno
contiendra
.BR EIDRM ),
ou que le processus reoive un signal  intercepter (auquel cas
l'appel systme chouera et 
.B errno
contiendra
.BR EINTR ).
.PP
Si l'appel russit, la structure de file de messages sera mise
 jour ainsi :
.IP
.B msg_lspid
contient le PID du processus appelant.
.IP
.B msg_qnum
est incrment de 1.
.IP
.B msg_stime
est rempli avec l'heure actuelle.
.PP
l'appel systme
.B msgrcv
lit un message depuis la file indique par
.I msqid
dans la structure
.B msgbuf
pointe par l'argument
.IR msgp ,
en extrayant le message en cas de russite.
.PP
L'argument
.I msgsz
indique la taille maximale en octets du membre
.B mtext
de la structure pointe par l'argument
.IR msgp .
Si le contenu du message est plus long que
.IR msgsz 
octets, et si l'argument
.I msgflg
contient
.BR MSG_NOERROR ,
alors le message sera tronqu (et la partie tronque sera perdue).
Sinon le message ne sera pas extrait de la file, et l'appel
systme chouera en indiquant
.BR E2BIG
dans
.B errno
.PP
L'argument
.I msgtyp
indique le type de message dsir :
.IP
Si
.I msgtyp
vaut
.BR 0 ,
le premier message est lu.
.IP
Si
.I msgtyp
est suprieur 
.BR 0 ,
alors le premier message de type
.I msgtyp
est extrait de la file.
Si
.I msgflg
contient
.B MSG_EXCEPT
l'inverse est effectu, le premier message de
type 
.B diffrent
de
.I msgtyp
est extrait de la file.
.IP
Si
.I msgtyp
est infrieur  
.BR 0 ,
le premier message de la file avec un type infrieur ou gal
 la valeur absolue de
.I msgtyp
est extrait.
.PP
L'argument
.I msgflg
est compos d'un
.I OU
binaire ( | ) avec les options suivantes :
.IP
.B IPC_NOWAIT
Si aucun message du type desir n'est prsent, l'appel systme choue
et
.B errno
est fix 
.BR ENOMSG.
.IP
.B MSG_EXCEPT
Utilis avec
.I msgtyp
suprieur 
.B 0
pour lire les messages de type diffrent de
.IR msgtyp.
.IP
.B MSG_NOERROR
Tronque silencieusement les messages trop longs
.PP
Si aucun message du type requis n'est disponible et
si on n'a pas demand
.B IPC_NOWAIT
dans
.IR msgflg ,
Le processus appelant est bloqu jusqu' l'occurrence d'un
des vnements suivants.
.IP
Un message du type dsir arrive dans la file.
.IP
La file de messages est supprime.
L'appel systme choue et 
.B errno
contient
.BR EIDRM.
.IP
Le processus appelant reoit un signal  intercepter.
L'appel systme choue et
.B errno
contient
.BR EINTR.
.PP
Si l'appel systme russit, la structure dcrivant la file de messages
est mise  jour comme suit :
.IP
.B msg_lrpid
est rempli avec le PID du processus appelant.
.IP
.B msg_qnum
est dcrment de 1
.IP
.B msg_rtime
est rempli avec l'heure actuelle.
.SH "VALEUR RENVOYE"
En cas d'chec les deux appels systmes renvoient
.B \-1
et 
.B errno
contient le code d'erreur. 
Sinon
.B msgsnd
renvoie
.B 0
et
.B msgrvc
renvoie le nombre d'octets copis dans la table
.B mtext.
.SH ERREURS
.B msgsnd :
.TP 11
.B EAGAIN
Le message n'a pas pu tre envoy  cause de la limite
.B msg_qbytes
pour la file et de la requte
.B IPC_NOWAIT
dans
.IR mgsflg.
.TP
.B EACCES
le processus appelant n'a pas de permissions de lecture dans la file.
.TP
.B EFAULT
.I msgp
pointe en dehors de l'espace d'adressage accessible.
.TP
.B EIDRM
La file de message a t supprime
.TP
.B EINTR
Un signal est arriv avant d'avoir pu crire quoi que ce soit.
.TP
.B EINVAL
.I msqid
ou
.I mtype
ou
.I msgsz
sont invalides.
.TP
.B ENOMEM
pas assez de mmoire pour le noyau.
.PP
.B msgrcv :
.TP
.B E2BIG
message trop long, et
.B MSG_NOERROR
n'a pas t requis.
.TP
.B EACCES
Le processus appelant n'a pas de permission de lecture dans la file.
.TP
.B EFAULT
.I msgp
pointe en dehors de l'espace d'adressage accessible.
.TP
.B EIDRM
La file de messages a t supprime.
.TP
.B EINTR
Un signal est arriv avant d'avoir pu lire quoi que ce soit.
.TP
.B EINVAL
.I msgqid
ou
.I msgsz
invalides.
.TP
.B ENOMSG
.B IPC_NOWAIT
a t requis et aucun message du type reclam n'existe dans la file.
.SH NOTES
Les limites systmes suivantes influent sur
.B msgsnd :
.TP 11
.B MSGMAX
Taille maximum d'un message : l'implmentation Linux 0.99.13 fixe cette
limite  4080 bytes.
.TP
.B MSGMNB
Taille maximale d'une file de messages. Peut tre augmente par
le Super\-User.
.SH CONFORMIT
SVr4, SVID.
.SH "VOIR AUSSI"
.BR ipc (5),
.BR msgctl (2),
.BR msgget (2),
.BR msgrcv (2),
.BR msgsnd (2).

.SH TRADUCTION
Christophe Blaess, 1997.