Rechercher une page de manuel
mq_open
Langue: fr
Version: 25 février 2006 (mandriva - 01/05/08)
Section: 3 (Bibliothèques de fonctions)
NOM
mq_open - Ouvrir une file de messagesSYNOPSIS
#include <mqueue.h> mqd_t mq_open(const char *name, int oflag); mqd_t mq_open(const char *name, int oflag, mode_t mode, struct mq_attr *attr);
DESCRIPTION
mq_open() crée une file de messages POSIX ou en ouvre une existante. La file est identifiée par name. Pour les détails de la construction de name, voir mq_overview(7).L'argument oflag spécifie les attributs qui contrôle les opérations de l'appel. Un seul des attributs suivants doit être spécifié dans Exactly one of the following must be specified in oflag :
- O_RDONLY
- Ouvrir la file en reception seulement.
- O_WRONLY
- Ouvrir la file en émission seulement.
- O_RDWR
- Ouvrir la file en émission et reception.
Zéro ou plusieurs des attributs suivants peuvent être ajoutés avec un OU binaire avec oflag :
- O_NONBLOCK
- Ouvrir la file en mode non bloquant. Dans les cas où mq_receive(3) et mq_send(3) bloqueraient normalement, ces fonctions font plutôt échouer l'appel avec l'erreur EAGAIN.
- O_CREAT
- Créer la file de messages si elle n'existe pas. Le propriétaire (UID) de la file de messages devient l'UID effectif du processus appelant. L'appartenance de groupe (GID) est fixée au GID effectif du processus appelant.
- O_EXCL
- Si O_CREAT était spécifié dans oflag, et qu'un file du nom name existe déjà, il échoue avec l'erreur EEXIST.
Si O_CREAT était spécifié dans oflag, deux argument supplémentaires doivent être fournis. then two additional arguments must be supplied. L'argument mode spécifie les prmissions à attribuer à la nouvelle file, comme pour open(2). Le réglagle des permissions est « masquée » avec l'umask du processus. L'argument attr spécifie ls attributs de la file. Voir mq_getattr(3) pour les détails. Si attr est NULL, la file est créée avec les attributs par défaut définis par l'implémentation.
VALEUR RENVOYÉE
S'il réussit, mq_open() renvoie un descripteur de file de messages qui pouura être utilisé avec les autres fonctions des files de messages. S'il échoue mq_open() renvoie (mqd_t) -1, et écrit errno en conséquence.ERREURS
- EACCES
- La file existe, mais l'appelant n'a pas la permission de l'ouvrir dans le mode spécifié.
- EINVAL
- O_CREAT était spécifié dans oflag, et attr n'était pas NULL, mais attr->mq_maxmsg ou attr->mq_msqsize n'était pas valide Ces deux champs doivent être positif. Pour un processus non privilégié (qui n'a pas la capacité CAP_SYS_RESOURCE ), attr->mq_maxmsg doit être inférieur ou égal à la limite msg_max, et attr->mq_msgsize doit être inférieur ou égal à la limite msgsize_max. De plus, même pour un processus privilégié attr->mq_maxmsg ne peut pas excéder la limite HARD_MAX. (Voir mq_overview(7) pour les détails sur ces limites.)
- EEXIST
- O_CREAT et O_EXCL était tous les deux spécifiés dans oflag, mais une file du nom de name existe déjà.
- EMFILE
- Le processus a déjà le nombre maximum de fichiers et de files de messages ouverts.
- ENAMETOOLONG
- name est trop long.
- ENFILE
- La limite système du nombre total de fichiers et fils de messages ouverts a été atteinte.
- ENOENT
- L'attribut O_CREAT n'était pas spécifié dans oflag, et aucune file du nom de name n'existe.
- ENOMEM
- Mémoire insuffisante.
- ENOSPC
- Espace insuffisant pour la création d'une nouvellle file de messages. C'est dans doute parce que la limite queues_max a été atteinte ; voir mq_overview(7).
CONFORMITÉ
POSIX.1-2001.BOGUES
Dans les noyaux précédant la version 2.6.14, l'umask du processus n'était pas appliqué aux permissions spécifiées dans mode.VOIR AUSSI
mq_close(3), mq_getattr(3), mq_notify(3), mq_receive(3), mq_send(3), mq_unlink(3), mq_overview(7)TRADUCTION
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 27 novembre 2007.
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 3 mq_open ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre