.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
+.\"
+.\" Japanese Version Copyright (c) 1997 Takashi Yoshino
+.\" all rights reserved.
+.\" Translated 1997-01-21, Takashi Yoshino <tyoshino@eng.toyo.ac.jp>
+.\" Modified 2007-05-03, Akihiro MOTOKI
+.\" Modified 2008-11-09, Akihiro MOTOKI, LDP v3.13
+.\"
.TH POPEN 3 2013\-04\-19 GNU "Linux Programmer's Manual"
.SH 名前
popen, pclose \- プロセスとの入力/出力用のパイプストリーム
定義から分かるように、パイプは一方向なので、 \fItype\fP 引き数には読み込みか書き込みのどちらか一方だけを指定できる (両方は指定できない)。
生成されるストリームは、この指定に対応して、読み取り専用または 書き込み専用のいずれかとなる。
.PP
-\fIcommand\fP 引き数は、シェルのコマンドラインを含む NULL 終端された文字列へのポインタである。 このコマンドは \fB\-c\fP フラグを用いて
-\fI/bin/sh\fP に渡される。 コマンドの解釈は (もし必要ならば) シェルによって行われる。 \fItype\fP 引き数は、NULL
-終端された文字列へのポインタで、 読み込みを示す文字 \(aqr\(aq か、書き込みを示す文字 \(aqw\(aq の
+\fIcommand\fP 引き数は、シェルのコマンドラインを含むヌル終端された文字列へのポインターである。 このコマンドは \fB\-c\fP フラグを用いて
+\fI/bin/sh\fP に渡される。 コマンドの解釈は (もし必要ならば) シェルによって行われる。 \fItype\fP
+引き数は、ヌル終端された文字列へのポインターで、 読み込みを示す文字 \(aqr\(aq か、書き込みを示す文字 \(aqw\(aq の
どちらか一方を指定しなければならない。 glibc 2.9 以降では、この引き数に文字 \(aqe\(aq を追加で指定できる。 文字
-\(aqe\(aq を指定すると、 対応するファイルディスクリプタにおいて、 close\-on\-exec フラグ (\fBFD_CLOEXEC\fP)
+\(aqe\(aq ã\82\92æ\8c\87å®\9aã\81\99ã\82\8bã\81¨ã\80\81 対å¿\9cã\81\99ã\82\8bã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81«ã\81\8aã\81\84ã\81¦ã\80\81 close\-on\-exec ã\83\95ã\83©ã\82° (\fBFD_CLOEXEC\fP)
がセットされる。 これが役に立つ理由については、 \fBopen\fP(2) の \fBO_CLOEXEC\fP フラグの説明を参照のこと。
.PP
\fBpopen\fP() からの返り値は、通常の標準 I/O ストリームと同じであるが、 \fBfclose\fP(3) ではなく \fBpclose\fP()
で閉じなくてはならないことだけが異なる。 このストリームへ書き込んだ結果はコマンドの標準入力に書き込まれる。 そして、コマンドの標準出力は、
-コマンドそのものが置き換わってしまわない限り、 \fBpopen\fP() を呼んだプロセスの標準出力と同じことになる。 逆に、"popened"
-(\fBpopen\fP() によって開かれた) ストリームからの読み込みは、 そのコマンドの標準出力を読み込むことになる。
-ã\81\9dã\81\97ã\81¦ã\80\81ã\81\9dã\81®ã\82³ã\83\9eã\83³ã\83\89ã\81®æ¨\99æº\96å\85¥å\8a\9bã\81¯ \fBpopen\fP() ã\82\92å\91¼ã\82\93ã\81 ã\83\97ã\83ã\82»ã\82¹ã\81®æ¨\99æº\96å\85¥å\8a\9bã\81¨å\90\8cä¸\80ã\81§ã\81\82ã\82\8bã\80\82
+コマンドそのものが置き換わってしまわない限り、 \fBpopen\fP() を呼んだプロセスの標準出力と同じことになる。 逆に、
+ストリームからの読み込みは、 そのコマンドの標準出力を読み込むことになる。 そして、そのコマンドの標準入力は \fBpopen\fP()
+を呼んだプロセスの標準入力と同一である。
.PP
-デフォルトでは、 \fBpopen\fP() の出力ストリームは完全にバッファリングされることに注意しよう。
+ã\83\87ã\83\95ã\82©ã\83«ã\83\88ã\81§ã\81¯ã\80\81 \fBpopen\fP() ã\81®å\87ºå\8a\9bã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\81¯å®\8cå\85¨ã\81«ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\83ªã\83³ã\82°ã\81\95ã\82\8cã\82\8bã\81\93ã\81¨ã\81«æ³¨æ\84\8fã\81\97ã\82\88ã\81\86ã\80\82
.PP
\fBpclose\fP() 関数は、(パイプに) 関連づけられたプロセスが終了するのを待ち、 \fBwait4\fP(2)
によって返されたコマンドの終了状態を返す。
.SH 返り値
-\fBpopen\fP() 関数は、 \fBfork\fP(2) または \fBpipe\fP(2) 呼び出しが失敗した場合や、 メモリ割り当てができなかった場合、
-NULL を返す。
+\fBpopen\fP() 関数は、 \fBfork\fP(2) または \fBpipe\fP(2) 呼び出しが失敗した場合や、
+メモリー割り当てができなかった場合、 NULL を返す。
.PP
.\" These conditions actually give undefined results, so I commented
.\" them out.
\fBpclose\fP() 関数は、 \fBwait4\fP(2) がエラーを返したり、何か他のエラーが見つかった場合、 \-1 を返す。 その場合、
\fIerrno\fP にエラーの原因を示す値が設定される。
.SH エラー
-\fBpopen\fP() 関数は、メモリアロケーションに失敗しても \fIerrno\fP をセットしない。 \fBpopen\fP() が中で呼び出す
+\fBpopen\fP() é\96¢æ\95°ã\81¯ã\80\81ã\83¡ã\83¢ã\83ªã\83¼ã\82¢ã\83ã\82±ã\83¼ã\82·ã\83§ã\83³ã\81«å¤±æ\95\97ã\81\97ã\81¦ã\82\82 \fIerrno\fP ã\82\92ã\82»ã\83\83ã\83\88ã\81\97ã\81ªã\81\84ã\80\82 \fBpopen\fP() ã\81\8cä¸ã\81§å\91¼ã\81³å\87ºã\81\99
\fBfork\fP(2) や \fBpipe\fP(2) が失敗した場合には、 \fIerrno\fP が適切にセットされる。 引き数 \fItype\fP
が無効であり、この状態が検知された場合には、 \fIerrno\fP が \fBEINVAL\fP にセットされる。
.PP
\fItype\fP に指定できる \(aqe\(aq は Linux での拡張である。
.SH バグ
読み込みのために開かれたコマンドの標準入力は \fBpopen\fP(), を呼んだプロセスと一緒に、その読み取り位置を共有する。
-そのため、もとのプロセスがバッファリングされた読み取りを終了したら、 そのコマンドの入力位置は予想されたものには なっていないかもしれない。
+ã\81\9dã\81®ã\81\9fã\82\81ã\80\81ã\82\82ã\81¨ã\81®ã\83\97ã\83ã\82»ã\82¹ã\81\8cã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\83ªã\83³ã\82°ã\81\95ã\82\8cã\81\9fèªã\81¿å\8f\96ã\82\8aã\82\92çµ\82äº\86ã\81\97ã\81\9fã\82\89ã\80\81 ã\81\9dã\81®ã\82³ã\83\9eã\83³ã\83\89ã\81®å\85¥å\8a\9bä½\8dç½®ã\81¯äº\88æ\83³ã\81\95ã\82\8cã\81\9fã\82\82ã\81®ã\81«ã\81¯ ã\81ªã\81£ã\81¦ã\81\84ã\81ªã\81\84ã\81\8bã\82\82ã\81\97ã\82\8cã\81ªã\81\84ã\80\82
同様に、書き込みのために開かれたコマンドからの出力は、 もとのプロセスの出力と混ざり合うことになるかもしれない。 後者は \fBpopen\fP() の前に
\fBfflush\fP(3) を呼び出すことによって回避可能である。
.PP
\fBsh\fP(1), \fBfork\fP(2), \fBpipe\fP(2), \fBwait4\fP(2), \fBfclose\fP(3), \fBfflush\fP(3),
\fBfopen\fP(3), \fBstdio\fP(3), \fBsystem\fP(3)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.78 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
