Les files de messages sont créées et ouvertes avec mq_open(3) ; cette fonction renvoie un descripteur de file de messages (mqd_t), qui sera utilisé pour faire référence à une file de messages ouverte dans des appels ultérieurs. Chaque file de messages est identifiée par un nom de la forme /unnom. Deux processus peuvent agir sur la même file en passant le même nom à mq_open(3).

Les messages sont transférés de et vers une file avec respectivement mq_receive(3) et mq_send(3). Lorsqu'un processus a fini d'utiliser une file, il la ferme avec mq_close(3), et lorsque la file n'est plus nécessaire, elle peut être supprimée avec mq_unlink(3). Les attributs peuvent être obtenus et (dans certains cas) modifiés avec mq_getattr(3) et mq_setattr(3). Un processus peut demander une notification asynchrone de l'arrivée d'un message sur une file précédemment vide avec mq_notify(3).

Un descripteur de file de messages est une référence à une description de file de messages ouverte (cf. open(2)). Après un fork(2), un fils hérite d'une copie des descripteurs de file de messages du père, et ces descripteurs font référence aux mêmes descriptions de file de messages ouvertes que les descripteurs du père. Les descripteurs correspondants dans les deux processus partagent les attributs (mq_flags) qui sont associés à la description de file de messages ouverte.

Chaque message a une priorité priority, associée et les messages sont toujours délivrés au processus récepteur avec la plus forte priorité. Les priorités des messages s'échelonnent de 0 (plus basse) à sysconf(_SC_MQ_PRIO_MAX) - 1 (plus haute). Sous Linux, sysconf(_SC_MQ_PRIO_MAX) renvoie 32768 mais POSIX.1-2001 ne réclame qu'un intevalle de priorité entre 0 et 31 ; certaines implémentations ne fournissent que cet intervalle.

Le reste de cette section décrit certains détails spécifiques à l'implémentation Linux des files de messages POSIX.  

/proc/sys/fs/mqueue/msg_max

Ce fichier est utilisé pour voir et modifier la valeur plafond du nombre maximal de messages dans une file. Cette valeur agit comme plafond pour l'argument attr->mq_maxmsg fourni à mq_open(3). La valeur par défaut et valeur minimum de msg_max est 10 ; la limite haute est HARD_MAX : (131072 / sizeof(void *)) (32768 sous Linux/86). Cette limite est ignorée par les processus privilègiés (CAP_SYS_RESOURCE), mais le plafond HARD_MAX malgré tout imposé.

/proc/sys/fs/mqueue/msgsize_max

Ce fichier est utilisé pour voir et modifier la valeur plafond de la taille maximale des messages. Cette valeur agit comme plafond pour l'argument attr->mq_msgsize fourni à mq_open(3). La valeur par défaut et valeur minimum de msgsize_max est 8192 octets ; la limite haute est INT_MAX : (2147483647 sous Linux/86). Cette limite est ignorée par les processus privilègiés. (CAP_SYS_RESOURCE).

/proc/sys/fs/mqueue/queues_max

Ce fichier est utilisé pour voir et modifier la limite à l'échelle du système du nombre de files de messages qui peuvent être créées. Seuls les processus privilègiés (CAP_SYS_RESOURCE) peuvent créer de nouvelles files de messages une fois que cette limite a été atteinte. La valeur par défaut de queues_max est 256 ; elle peut être modifiée en toute valeur comprise en 0 et INT_MAX.

$ mkdir /dev/mqueue
$ mount -t mqueue none /dev/mqueue

Après que le système de fichiers ait été monté, les files de messages sur le système de fichiers peuvent être vues et manipulées avec des commandes génralement utilisées pour les fichiers (par exemple, ls(1), rm(1), etc.).

Le contenu de chaque fichier du répertoire consiste en une ligne unique d'information sur la file :

$ ls /dev/mqueue/mymq
QSIZE:129     NOTIFY:2    SIGNO:0    NOTIFY_PID:8260
$ mount -t mqueue none /dev/mqueue

QSIZE

Nombre d'octets de données dans tous les messages de la file.

NOTIFY_PID

Si ce champ n'est pas nul, c'est que le processus avec ce PID a utilisé mq_notify(3) pour enregistrer une notification de message asynchrone, et les champs restant décrivent comment les notifications surviennent.

NOTIFY

Méthode de notification : 0 est SIGEV_SIGNAL , 1 est SIGEV_NONE et 2 est SIGEV_THREAD.

SIGNO

Numéro de signal pour utiliser avec SIGEV_SIGNAL.

Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> le 23 juillet 2006 et révisée le 6 juin 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 7 mq_overview ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

DESCRIPTION

Interfaces bibliothèque et appels système

Versions

Configuration du noyau

Persistence

Édition de liens

Interfaces /proc

Limites resources

Monter le système de fichiers des files de messages

Scrutation des descripteurs de file de messages

CONFORMITÉ

NOTES

EXEMPLE

VOIR AUSSI

TRADUCTION