pipe − Créer un tube.

#include <unistd.h>

int pipe(int filedes[2]);

pipe() crée une paire de descripteurs de fichiers, pointant sur un i−noeud de tube, et les place dans un tableau filedes. filedes[0] est utilisé pour la lecture, et filedes[1] pour l’écriture.

En général, deux processus (créés par fork) vont se partager le tube et utiliser les fonctions read() et write() pour se transmettre des données.

pipe() renvoie 0 s’il réussit, ou −1 s’il échoue, auquel cas errno contient le code d’erreur.

EFAULT

filedes est invalide.

EMFILE

Trop de descripteurs de fichiers sont utilisés par le processus.

ENFILE

La limite du nombre total de fichiers ouverts sur le système a été atteinte.

Le programme suivant crée un tube puis se dédouble (fork(2)) pour créer un processus fils. Après le fork(2), chaque processus ferme les descripteurs dont il n’a pas besoin pour le tube (voir pipe(7)). Le père écrit la chaîne contenue dans l’argument de la ligne de commande du programme et le fils lit cette chaîne, un octet à la fois, qu’il affiche sur sa sortie standard.

#include <sys/wait.h>
#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>

int
main(int argc, char *argv[])
{
    int pfd[2];
    pid_t cpid;
    char buf;

   assert(argc == 2);

   if (pipe(pfd) == -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(pfd[1]);  /* Ferme l’extrémité écriture inutilisée */

       while (read(pfd[0], &buf, 1) > 0)
            write(STDOUT_FILENO, &buf, 1);

       write(STDOUT_FILENO, "\n", 1);
        close(pfd[0]);
        _exit(EXIT_SUCCESS);

   } else {                    /* Le père écrit argv[1] dans le tube */
        close(pfd[0]);          /* Ferme l’extrémité lecture inutilisée */
        write(pfd[1], argv[1], strlen(argv[1]));
        close(pfd[1]);          /* Le lecteur verra EOF */
        wait(NULL);             /* Attente du fils */
        exit(EXIT_SUCCESS);
    }
}

POSIX.1-2001.

fork(2), read(2), socketpair(2), write(2), popen(3), pipe(7)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 10 octobre 1996 et révisée le 14 août 2006.

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 2 pipe ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.