Provided by: manpages-fr-dev_3.65d1p1-1_all 
NOM
pipe, pipe2 - Créer un tube
SYNOPSIS
#include <unistd.h>
int pipe(int pipefd[2]);
#define _GNU_SOURCE /* Consultez feature_test_macros(7) */
#include <fcntl.h> /* Obtenir les définition de constante O_* */
#include <unistd.h>
int pipe2(int pipefd[2], int flags);
DESCRIPTION
pipe() crée un tube, un canal unidirectionnel de données qui peut être utilisé pour la
communication entre processus. Le tableau pipefd est utilisé pour renvoyer deux
descripteurs de fichier faisant référence aux extrémités du tube. pipefd[0] fait référence
à l'extrémité de lecture du tube. pipefd[1] fait référence à l'extrémité d'écriture du
tube. Les données écrites sur l'extrémité d'écriture du tube sont mises en mémoire tampon
par le noyau jusqu'à ce qu'elles soient lues sur l'extrémité de lecture du tube. Pour plus
de détails, consultez pipe(7).
Si flags est nul, alors pipe2() est identique à pipe(). Les valeurs suivantes peuvent être
incluses à l'aide d'un OU binaire dans flags pour obtenir différents comportements :
O_CLOEXEC
Placer l'attribut « close-on-exec » (FD_CLOEXEC) sur les deux nouveaux descripteurs
de fichiers. Consultez la description de cet attribut dans open(2) pour savoir
pourquoi ça peut être utile.
O_DIRECT (depuis Linux 3.4)
Créer un tube qui assure les E/S en mode « packet ». Chaque opération write(2) vers
le tube est exécutée avec un paquet distinct, and les opérations read(2) depuis le
tube lisent un seul paquet à la fois. Notez les précisions suivantes :
* Les opérations d'écriture dont la taille dépasse PIPE_BUF octets (voir pipe(7))
seront fractionnées en plusieurs paquets.
* Si une opération read(2) indique une taille du tampon inférieure à celle du
paquet à venir, alors seul le nombre d'octets demandé sera lu, et les octets
supplémentaires du paquet seront écartés. Si l'on souhaite s'assurer que même
les paquets les plus longs seront lus, il suffit de définir la taille du tampon
à PIPE_BUF(voir le point précédent).
* Les paquets de longueur nulle ne sont pas acceptés (une opération read(2) qui
indique une taille de tampon de longueur zéro est sans effet et renvoie 0).
Les anciens noyaux qui n'acceptent pas cet attribut renvoient une erreur EINVAL.
O_NONBLOCK
Placer l'attribut d'état de fichier O_NONBLOCK sur les deux nouveaux descripteurs
de fichiers ouverts. Utiliser cet attribut économise des appels supplémentaires à
fcntl(2) pour obtenir le même résultat.
VALEUR RENVOYÉE
S'il réussit, cet appel système renvoie 0. S'il échoue, il renvoie -1 et remplit errno en
conséquence.
ERREURS
EFAULT pipefd est invalide.
EINVAL (pipe2()) Valeur incorrecte dans flags.
EMFILE Trop de descripteurs de fichier sont utilisés par le processus.
ENFILE La limite du nombre total de fichiers ouverts sur le système a été atteinte.
VERSIONS
pipe2() a été ajouté à Linux dans la version 2.6.27 ; sa prise en charge par la glibc est
disponible depuis la version 2.9.
CONFORMITÉ
pipe() : POSIX.1-2001.
pipe2() est spécifique à Linux.
EXEMPLE
Le programme suivant crée un tube, puis invoque fork(2) pour créer un processus fils ; le
fils hérite d'un jeu de descripteurs de fichier qui se rapportent au même tube. Après le
fork(2), chaque processus ferme les descripteurs dont il n'a pas besoin pour le tube
(consultez pipe(7)). Le père écrit alors la chaîne contenue dans l'argument de ligne de
commande du programme dans le tube, et le fils lit cette chaîne un octet à la fois dans le
tube, et l'affiche sur la sortie standard.
Source du programme
#include <sys/types.h>
#include <sys/wait.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>
int
main(int argc, char *argv[])
{
int pipefd[2];
pid_t cpid;
char buf;
if (argc != 2) {
fprintf(stderr, "Utilisation : %s <chaîne>\n", argv[0]);
exit(EXIT_FAILURE);
}
if (pipe(pipefd) == -1) {
perror("pipe");
exit(EXIT_FAILURE);
}
cpid = fork();
if (cpid == -1) {
perror("fork");
exit(EXIT_FAILURE);
}
if (cpid == 0) { /* Le fils lit dans le tube */
close(pipefd[1]); /* Fermeture du descripteur en écriture inutilisé */
while (read(pipefd[0], &buf, 1) > 0)
write(STDOUT_FILENO, &buf, 1);
write(STDOUT_FILENO, "\n", 1);
close(pipefd[0]);
_exit(EXIT_SUCCESS);
} else { /* Le père écrit argv[1] dans le tube */
close(pipefd[0]); /* Fermeture du descripteur en lecture inutilisé*/
write(pipefd[1], argv[1], strlen(argv[1]));
close(pipefd[1]); /* Le lecteur verra EOF */
wait(NULL); /* Attente du fils */
exit(EXIT_SUCCESS);
}
}
VOIR AUSSI
fork(2), read(2), socketpair(2), write(2), popen(3), pipe(7)
COLOPHON
Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description
du projet et des instructions pour signaler des anomalies peuvent être trouvées à
l'adresse http://www.kernel.org/doc/man-pages/.
TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a
<http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet
perkamon <http://perkamon.alioth.debian.org/>.
Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal
<http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de
traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet
manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la
commande « man -L C <section> <page_de_man> ».