aboutsummaryrefslogtreecommitdiff
path: root/ja_JP.eucJP/man/man3/popen.3
diff options
context:
space:
mode:
Diffstat (limited to 'ja_JP.eucJP/man/man3/popen.3')
-rw-r--r--ja_JP.eucJP/man/man3/popen.3204
1 files changed, 0 insertions, 204 deletions
diff --git a/ja_JP.eucJP/man/man3/popen.3 b/ja_JP.eucJP/man/man3/popen.3
deleted file mode 100644
index 7cb4dab905..0000000000
--- a/ja_JP.eucJP/man/man3/popen.3
+++ /dev/null
@@ -1,204 +0,0 @@
-.\" Copyright (c) 1991, 1993
-.\" The Regents of the University of California. All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\" must display the following acknowledgement:
-.\" This product includes software developed by the University of
-.\" California, Berkeley and its contributors.
-.\" 4. Neither the name of the University nor the names of its contributors
-.\" may be used to endorse or promote products derived from this software
-.\" without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" @(#)popen.3 8.2 (Berkeley) 5/3/95
-.\" %FreeBSD: src/lib/libc/gen/popen.3,v 1.10.2.3 2001/12/14 18:33:51 ru Exp %
-.\"
-.\" $FreeBSD$
-.\"
-.Dd May 3, 1995
-.Dt POPEN 3
-.Os
-.Sh 名称
-.Nm popen ,
-.Nm pclose
-.Nd
-.Tn 入出力処理
-.Sh ライブラリ
-.Lb libc
-.Sh 書式
-.In stdio.h
-.Ft FILE *
-.Fn popen "const char *command" "const char *type"
-.Ft int
-.Fn pclose "FILE *stream"
-.Sh 解説
-.Fn popen
-関数は、双方向パイプフォークを作成し、シェルを起動してプロセスを
-.Dq 開き
-ます。
-親プロセスで事前に
-.Fn popen
-を呼び出して開いたストリームは、
-新しい子プロセスによってクローズされます。
-以前の
-.Fn popen
-は単方向のパイプで実装されていたため、
-.Fn popen
-の多くの実装は、
-読み書きの両方ではなく、
-.Fa type
-引数が読込もしくは書込のどちらかを指定すること
-だけ許可していました。
-現在の
-.Fn popen
-は双方向パイプで実装しているので、
-.Fa type
-引数で双方向データフローを要求できます。
-.Fa type
-引数はヌル文字で終わる文字列のポインタで、
-読取りの場合は
-.Ql r
-、書込みの場合は
-.Ql w
-、読み書きの場合は
-.Ql r+
-である必要があります。
-.Pp
-.Fa command
-引数は、シェルコマンドラインを含む、
-ヌル文字で終了する文字列のポインタです。
-このコマンドは、
-.Fl c
-フラグで
-.Pa /bin/sh
-に渡されます。解釈がある場合、シェルで実行されます。
-.Pp
-.Fn popen
-の戻り値は通常の標準
-.Tn 入出力
-とあらゆる点で同等のものです。
-ただし、閉じるときは、
-.Fn fclose
-ではなく
-.Fn pclose
-を使わなければなりません。
-このようなストリームに書込むと、
-コマンドの標準入力に書込まれます。
-コマンドの標準出力は、
-そのコマンド自体で変更しないかぎり、
-.Fn popen
-で呼び出したプロセスのものと同じです。
-反対に、
-.Fn popen
-で
-.Dq 開かれた
-ストリームからの読込みは、
-コマンドの標準出力から読込まれます。
-コマンドの標準入力は
-.Fn popen
-を呼び出したプロセスのものと同じです。
-.Pp
-出力
-.Fn popen
-ストリームは、デフォルトで完全にバッファ
-されることに注意してください。
-.Pp
-.Fn pclose
-関数は、結び付けられたプロセスの終了を待機し、
-.Fn wait4
-が戻すコマンドの終了ステータスを返します。
-.Sh 戻り値
-.Fn popen
-関数は、
-.Xr fork 2
-か
-.Xr pipe 2
-でエラーが発生した場合、またはメモリを割り当てられない場合は
-.Dv ヌル
-を戻します。
-.Pp
-.Fn pclose
-関数は、
-.Fa ストリーム
-が
-.Fn popen
-で
-.Dq 開いた
-コマンドと
-結び付いていなかった場合、または
-.Fa ストリーム
-がすでに
-.Fn pclose
-で
-.Dq 閉じている
-場合、あるいは
-.Xr wait4
-でエラーが発生した場合は \-1 を戻します。
-.Sh エラー
-.Fn popen
-関数は、信頼性のある
-.Va errno
-を設定しません。
-.Sh 関連項目
-.Xr sh 1 ,
-.Xr fork 2 ,
-.Xr pipe 2 ,
-.Xr wait4 2 ,
-.Xr fclose 3 ,
-.Xr fflush 3 ,
-.Xr fopen 3 ,
-.Xr stdio 3 ,
-.Xr system 3
-.Sh バグ
-読取り用に開いたコマンドの標準入力は、
-.Fn popen
-を呼び出したプロセスとシークオフセットを共有するので、
-オリジナルプロセスがバッファ読取りを実行すると、
-コマンドの入力位置が予想どおりにならないことがあります。
-同様に、書込み用に開いたコマンドの出力は、
-オリジナルプロセスのものと混ざることがあります。後者は、
-.Fn popen
-の前に
-.Xr fflush 3
-を呼び出すことで回避できます。
-.Pp
-シェルを実行しないことには、それが実行できないコマンドのシェル
-なのか、すぐに終了してしまうコマンドか、区別できません。
-終了ステータスの 127 のみがヒントになります。
-.Pp
-.Fn popen
-の引数は常に
-.Xr sh 1
-を呼び出し、
-.Xr csh 1
-は呼び出しません。
-.Sh 歴史
-.Fn popen
-関数と
-.Fn pclose
-関数は、
-.At v7
-で登場しました。
-.Pp
-双方向機能は、
-.Fx 2.2.6
-で追加されました。