Interfaces de bibliothèque et appels système¶

Dans la plupart des cas, les interfaces de bibliothèque mq_*() listées ci-dessus sont implémentées au-dessus d'appels système sous-jacents du même nom. Les exceptions à cette règle sont indiquées dans le tableau ci‐dessous :

Versions¶

Les files de messages POSIX ne sont gérées par Linux que depuis le noyau 2.6.6. La gestion n'a été ajoutée à la glibc que depuis la glibc 2.3.4.

Configuration du noyau¶

La gestion des files de messages POSIX est configurable via l'option de configuration du noyau CONFIG_POSIX_MQUEUE. Cette option est activée par défaut.

Persistance¶

Les files de messages POSIX persistent dans le noyau : si une file de messages n'est pas supprimée avec mq_unlink(3), elle existera jusqu'à l'extinction du système.

Liaison¶

Les programmes utilisant l'API des files de messages POSIX doivent être compilés avec cc -lrt pour être liés à la bibliothèque temps réel librt.

/proc interfaces¶

Les interfaces suivantes peuvent être utilisées pour limiter la quantité de mémoire du noyau utilisée par les files de messages POSIX et pour définir les attributs par défaut pour de nouvelles files de message :

/proc/sys/fs/mqueue/msg_default (depuis Linux 3.5)

Ce fichier définit la valeur utilisée par un nouveau réglage mq_maxmsg de file quand une file est créée avec un appel à mq_open(3) où attr est indiqué comme NULL. La valeur par défaut pour ce fichier est 10. Le minimum et le maximum sont comme dans /proc/sys/fs/mqueue/msg_max. Une nouvelle valeur mq_maxmsg par défaut de file sera la plus petite valeur entre msg_default et msg_max. Avant Linux 2.6.28, la valeur par défaut de mq_maxmsg était 10. De Linux 2.6.28 jusqu’à Linux 3.4, c’était la valeur définie de la limite msg_max.

/proc/sys/fs/mqueue/msg_max

Ce fichier peut être utilisé pour visualiser et changer la valeur limite pour le nombre maximal de messages dans une file. Cette valeur agit comme un plafond pour le paramètre attr->mq_maxmsg indiqué à mq_open(3). La valeur par défaut de msg_max vaut 10. La valeur minimale est de 1 (10 avant Linux 2.6.28). La valeur maximale vaut HARD_MSGMAX. La limite msg_max est ignorée pour les processus privilégiés (CAP_SYS_RESOURCE), mais la limite HARD_MSGMAX reste néanmoins imposée.

La définition de HARD_MSGMAX a changé au cours des versions du noyau :

/proc/sys/fs/mqueue/msgsize_default (depuis Linux 3.5)

Ce fichier définit la valeur utilisée pour un nouveau réglage de mq_msgsize de file quand celle-ci est créée par un appel à mq_open(3) où attr est indiqué comme NULL. La valeur par défaut pour ce fichier est 8192 (octets). Le minimum et le maximum sont comme dans /proc/sys/fs/mqueue/msgsize_max. Si msgsize_default excède msgsize_max, une nouvelle valeur par défaut de mq_msgsize pour la file est plafonnée à la limite msgsize_max. Avant Linux 2.6.28, la valeur par défaut de mq_msgsize était 8192. De Linux 2.6.28 jusqu’à Linux 3.4, elle était la valeur définie de la limite msgsize_max.

/proc/sys/fs/mqueue/msgsize_max

Ce fichier peut être utilisé pour visualiser et modifier la limite de la taille maximale des messages. Cette valeur agit comme un plafond pour le paramètre attr->mq_msgsize indiqué à mq_open(3). La valeur par défaut de msgsize_max est de 8192 octets. La valeur minimale est 128 (8192 pour les noyaux antérieurs à 2.6.28). La valeur maximale pour msg_max à variée selon les versions du noyau.

La limite msgsize_max est ignorée pour les processus privilégiés (CAP_SYS_RESOURCE), mais, depuis Linux 3.5, le plafond HARD_MSGSIZEMAX est imposé aux processus privilégiés.

/proc/sys/fs/mqueue/queues_max

Ce fichier peut être utilisé pour visualiser et modifier la limite pour le système entier du nombre de files de messages qui peuvent être créées. La valeur par défaut de queues_max est 256. Aucun plafond n’est imposé pour la limite queues_max. Les processus privilégiés (CAP_SYS_RESOURCE) peuvent dépasser cette limite (mais voir BOGUES).

Limitation des ressources¶

La limitation des ressources RLIMIT_MSGQUEUE, qui indique une limite sur la quantité d'espace qui peut être utilisé par toutes les files de messages appartenant à l'identifiant utilisateur réel du processus, est décrite dans getrlimit(2).

Monter le système de fichiers des files de messages¶

Sous Linux, les files de messages sont créées dans un système de fichiers virtuel. (D'autres implémentations peuvent également fournir une telle fonctionnalité, mais les détails sont probablement différents.) Ce système de fichiers peut être monté (par le superutilisateur) en utilisant les commandes suivantes :

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

Le « sticky bit » est automatiquement activé sur le répertoire de montage.

Une fois le système de fichiers monté, les files de messages sur le système peuvent être visualisées et manipulées avec les commandes utilisées habituellement pour les fichiers (par exemple, ls(1) et rm(1)).

Le contenu de chaque fichier dans le répertoire est composé d'une seule ligne contenant les informations sur la file :

$ cat /dev/mqueue/mymq
QSIZE:129     NOTIFY:2    SIGNO:0    NOTIFY_PID:8260

Ces champs ont les caractéristiques suivantes :

QSIZE

Nombre d'octets de données dans tous les messages de la file (mais voir BOGUES).

NOTIFY_PID

Si différent de zéro, alors le processus avec cet identifiant a utilisé mq_notify(3) pour s'enregistrer pour les notifications asynchrones de messages, et les champs suivants décrivent comment ces notifications se produisent.

NOTIFY

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

SIGNO

Numéro de signal à utiliser pour SIGEV_SIGNAL.

Implémentation de Linux des descripteurs de files de messages¶

Sous Linux, un descripteur de file de messages est en fait un descripteur de fichier (POSIX n’exige pas une telle implémentation). Cela signifie qu’un descripteur de file de messages peut être contrôlé avec select(2), poll(2) ou epoll(7). Cela n'est pas portable.

Le drapeau « close-on-exec » (voir open(2)) est automatiquement positionné sur le descripteur de fichier renvoyé par mq_open(2).

Espaces de noms IPC¶

Pour une discussion sur l’interaction entre les objets de file de messages POSIX et les espaces de noms IPC, consulter ipc_namespaces(7).