.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (C) 2006 Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH mq_receive 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM mq_receive, mq_timedreceive \- Recevoir un message d'une file de messages .SH BIBLIOTHÈQUE Bibliothèque de temps réel (\fIlibrt\fP, \fI\-lrt\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBssize_t mq_receive(mqd_t \fP\fImqdes\fP\fB, char \fP\fImsg_ptr\fP\fB[.\fP\fImsg_len\fP\fB],\fP \fB size_t \fP\fImsg_len\fP\fB, unsigned int *\fP\fImsg_prio\fP\fB);\fP .PP \fB#include \fP \fB#include \fP .PP \fBssize_t mq_timedreceive(mqd_t \fP\fImqdes\fP\fB, char *restrict \fP\fImsg_ptr\fP\fB[.\fP\fImsg_len\fP\fB],\fP \fB size_t \fP\fImsg_len\fP\fB, unsigned int *restrict \fP\fImsg_prio\fP\fB,\fP \fB const struct timespec *restrict \fP\fIabs_timeout\fP\fB);\fP .fi .PP .ad l .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBmq_timedreceive\fP()\ : .nf _POSIX_C_SOURCE >= 200112L .fi .SH DESCRIPTION \fBmq_receive\fP() supprime le plus vieux message avec la plus haute priorité de la file de messages référencée par le descripteur de file de messages \fImqdes\fP, et le place dans un tampon pointé par \fImsg_ptr\fP. L'argument \fImsg_len\fP indique la taille du tampon pointé par \fImsg_ptr\fP\ ; celui\-ci doit être plus large ou aussi grand que l'attribut \fImq_msgsize\fP de la file (consulter \fBmq_getattr\fP(3)). Si \fImsg_prio\fP est non NULL, alors le tampon vers lequel il pointe est utilisé pour renvoyer la priorité associée au message reçu. .PP Si la file est vide, alors par défaut, \fBmq_receive\fP() bloque tant qu'aucun message n'est disponible, ou que l'appel n'est pas interrompu par un gestionnaire de signaux. Si le drapeau \fBO_NONBLOCK\fP est activé dans la description de file de messages, alors l'appel échouera immédiatement avec l'erreur \fBEAGAIN\fP. .PP \fBmq_timedreceive\fP() se comporte comme \fBmq_receive\fP(), excepté que si la file est vide et si le drapeau \fBO_NONBLOCK\fP n'est pas activé dans la description de la file de messages, alors \fIabs_timeout\fP pointe vers une structure qui spécifie un temps pendant lequel l'appel sera bloqué. Cette limite est un délai absolu en secondes et nanosecondes depuis l'époque, 1er\ janvier\ 1970 à 00:00:00 +0000 (UTC), spécifié dans une structure \fBtimespec\fP(3). .PP Si aucun message n'est disponible et si le délai d'attente a déjà expiré pendant la durée de l'appel, \fBmq_timedreceive\fP() s'achève immédiatement. .SH "VALEUR RENVOYÉE" En cas de succès, \fBmq_receive\fP() et \fBmq_timedreceive\fP() renvoient le nombre d'octets du message reçu. En cas d'erreur, \fB\-1\fP est renvoyé et \fIerrno\fP indique l'erreur. .SH ERREURS .TP \fBEAGAIN\fP La file est vide et le drapeau \fBO_NONBLOCK\fP était défini pour la file de messages référencée par le descripteur \fImqdes\fP. .TP \fBEBADF\fP Le descripteur spécifié dans \fImqdes\fP n'est pas valable ou n'est pas ouvert en lecture. .TP \fBEINTR\fP L'appel a été interrompu par un gestionnaire de signal\ ; consultez \fBsignal\fP(7). .TP \fBEINVAL\fP L'appel devrait être bloqué et \fIabs_timeout\fP n'est pas valable, soit car \fItv_sec\fP est inférieur à zéro, ou soit car \fItv_nsec\fP est inférieur à zéro ou plus grand que 1000\ millions. .TP \fBEMSGSIZE\fP \fImsg_len\fP était plus petit que l'attribut \fImq_msgsize\fP de la file de messages. .TP \fBETIMEDOUT\fP Le délai d'attente de l'appel a expiré avant que le message ait été transféré. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \fBmq_receive\fP(), \fBmq_timedreceive\fP() T} Sécurité des threads MT\-Safe .TE .sp 1 .SH VERSIONS Sous Linux, \fBmq_timedreceive\fP() est un appel système et \fBmq_receive\fP() est une fonction de bibliothèque au dessus de la couche des appels systèmes. .SH STANDARDS POSIX.1\-2008. .SH HISTORIQUE POSIX.1\-2001. .SH "VOIR AUSSI" \fBmq_close\fP(3), \fBmq_getattr\fP(3), \fBmq_notify\fP(3), \fBmq_open\fP(3), \fBmq_send\fP(3), \fBmq_unlink\fP(3), \fBtimespec\fP(3), \fBmq_overview\fP(7), \fBtime\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .