Linux Certif

Toute la documentation sur la certification Linux LPI

pipe

名前

pipe - パイプを生成する

書式

#include <unistd.h>

int pipe(int filedes[2]);

説明

pipe() はパイプの inode を指すファイル・ディスクリプター (descripter) の組を生成し、 そのファイル・ディスクリプターを filedes で示される配列に格納する。 filedes[0] には読み出し用、 filedes[1] には書き込み用のファイル・ディスクリプターが格納される。

返り値

成功した場合 0 が返る。失敗した場合 -1 が返り、 errno がエラーの内容に従って設定される。

エラー

EFAULT

filedes が無効な値である。

EMFILE

このプロセスで使われているファイル・ディスクリプターが多すぎる。

ENFILE

オープンされているファイルの総数がシステムの制限に達した。

準拠

POSIX.1-2001.

例

以下のプログラムではパイプを生成し、その後 fork(2) で子プロセスを生成する。 fork(2) の後、各プロセスはパイプ (pipe(7) を参照) に必要がなくなったディスクリプターをクローズする。 親プロセスはプログラムのコマンドライン引き数に含まれる 文字列をパイプへ書き込み、 子プロセスはこの文字列をパイプから 1 バイトずつ読み込んで標準出力にエコーする。

 
 #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) {    /* 子プロセスがパイプから読み込む */
         close(pfd[1]);  /* 使用しない write 側はクローズする */
 
         while (read(pfd[0], &buf, 1) > 0)
             write(STDOUT_FILENO, &buf, 1);
 
         write(STDOUT_FILENO, "\n", 1);
         close(pfd[0]);
         _exit(EXIT_SUCCESS);
 
     } else {            /* 親プロセスは argv[1] をパイプへ書き込む */
         close(pfd[0]);  /* 使用しない read 側はクローズする */
         write(pfd[1], argv[1], strlen(argv[1]));
         close(pfd[1]);          /* 読み込み側が EOF に出会う */
         wait(NULL);             /* 子プロセスを待つ */
         exit(EXIT_SUCCESS);
     }
 }
 

関連項目

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