X-Git-Url: http://git.osdn.net/view?p=linuxjm%2FLDP_man-pages.git;a=blobdiff_plain;f=release%2Fman3%2Fopenpty.3;h=7a06fba9d31ee96ea62a0430f586122ca8f1794e;hp=3f1a0c45aaacc00152f075bcb03f44c7f1d8e320;hb=4fa3e54b837e5814a4598ec901d77446bf5cb9b3;hpb=f8a251df75590049b7aa6f3cd698b6ce733b1ea5 diff --git a/release/man3/openpty.3 b/release/man3/openpty.3 index 3f1a0c45..7a06fba9 100644 --- a/release/man3/openpty.3 +++ b/release/man3/openpty.3 @@ -29,166 +29,70 @@ .\" .\" Added -lutil remark, 030718 .\" -.\" Japanese Version Copyright (c) 2002 Yuichi SATO -.\" all rights reserved. -.\" Translated Tue Jan 22 21:42:05 JST 2002 -.\" by Yuichi SATO -.\" Updated Mon Mar 8 2003 by Akihiro MOTOKI -.\" Updated Sun Sep 14 2003 by Akihiro MOTOKI +.\"******************************************************************* .\" -.\"WORD: tty 端末 -.\"WORD: pseudoterminal 疑似端末 +.\" This file was generated with po4a. Translate the source file. .\" -.TH OPENPTY 3 2010-06-13 "GNU" "Linux Programmer's Manual" +.\"******************************************************************* +.TH OPENPTY 3 2010\-06\-13 GNU "Linux Programmer's Manual" .SH 名前 openpty, login_tty, forkpty \- 端末ユーティリティ関数 .SH 書式 .nf -.B #include +\fB#include \fP .sp -.BI "int openpty(int *" amaster ", int *" aslave ", char *" name , -.BI " const struct termios *" termp , -.BI " const struct winsize *" winp ); +\fBint openpty(int *\fP\fIamaster\fP\fB, int *\fP\fIaslave\fP\fB, char *\fP\fIname\fP\fB,\fP +\fB const struct termios *\fP\fItermp\fP\fB,\fP +\fB const struct winsize *\fP\fIwinp\fP\fB);\fP .sp -.BI "pid_t forkpty(int *" amaster ", char *" name , -.BI " const struct termios *" termp , -.BI " const struct winsize *" winp ); +\fBpid_t forkpty(int *\fP\fIamaster\fP\fB, char *\fP\fIname\fP\fB,\fP +\fB const struct termios *\fP\fItermp\fP\fB,\fP +\fB const struct winsize *\fP\fIwinp\fP\fB);\fP .sp -.B #include +\fB#include \fP .sp -.BI "int login_tty(int " fd ); +\fBint login_tty(int \fP\fIfd\fP\fB);\fP .sp \fI\-lutil\fP でリンクする。 .fi .SH 説明 -.BR openpty () -関数は、使用可能な疑似端末 (pseudoterminal) を見つけて、 -マスタとスレーブのファイル・ディスクリプタを -.I amaster -と -.I aslave -に入れて返す。 -.I name -が NULL でない場合、スレーブのファイル名が -.I name -に返される。 -.I termp -が NULL でない場合、スレーブの端末パラメータは -.I termp -の値に設定される。 -.I winp -が NULL でない場合、スレーブのウインドウサイズは -.I winp -に設定される。 +\fBopenpty\fP() 関数は、使用可能な疑似端末 (pseudoterminal) を見つけて、 マスタとスレーブのファイル・ディスクリプタを +\fIamaster\fP と \fIaslave\fP に入れて返す。 \fIname\fP が NULL でない場合、スレーブのファイル名が \fIname\fP +に返される。 \fItermp\fP が NULL でない場合、スレーブの端末パラメータは \fItermp\fP の値に設定される。 \fIwinp\fP が NULL +でない場合、スレーブのウインドウサイズは \fIwinp\fP に設定される。 -.BR login_tty () -関数は、端末 -.I fd -にログインする準備をする -.RI ( fd -は実際の端末デバイスでも、 -.BR openpty () -で返される疑似端末のスレーブでもよい)。 -具体的には、新しいセッションを作成し、 -.I fd -を呼び出し元のプロセスの制御端末とし、 -呼び出し元の標準入力・標準出力・標準エラーのストリームを -.I fd -に設定した後、 -.I fd -をクローズする。 +\fBlogin_tty\fP() 関数は、端末 \fIfd\fP にログインする準備をする (\fIfd\fP は実際の端末デバイスでも、 \fBopenpty\fP() +で返される疑似端末のスレーブでもよい)。 具体的には、新しいセッションを作成し、 \fIfd\fP を呼び出し元のプロセスの制御端末とし、 +呼び出し元の標準入力・標準出力・標準エラーのストリームを \fIfd\fP に設定した後、 \fIfd\fP をクローズする。 -.BR forkpty () -関数は -.BR openpty (), -.BR fork (2), -.BR login_tty () -を組み合わせ、疑似端末を操作する新しいプロセスを生成する。 -疑似端末のマスタ側のファイル・ディスクリプタは -.I amaster -に返され、 -.I name -が NULL でない場合には、スレーブのファイル名が -.I name -に返される。 -.I termp -と -.I winp -引き数は、NULL でなければ、 -疑似端末のスレーブ側の端末属性とウインドウサイズを決定する。 +\fBforkpty\fP() 関数は \fBopenpty\fP(), \fBfork\fP(2), \fBlogin_tty\fP() +を組み合わせ、疑似端末を操作する新しいプロセスを生成する。 疑似端末のマスタ側のファイル・ディスクリプタは \fIamaster\fP に返され、 +\fIname\fP が NULL でない場合には、スレーブのファイル名が \fIname\fP に返される。 \fItermp\fP と \fIwinp\fP +引き数は、NULL でなければ、 疑似端末のスレーブ側の端末属性とウインドウサイズを決定する。 .SH 返り値 -.BR openpty (), -.BR login_tty (), -.BR forkpty () -の呼び出しが成功しなかった場合、 -\-1 が返されて、 -.I errno -はエラーを示す値に設定される。 -成功した場合、 -.BR openpty (), -.BR login_tty () -および -.BR forkpty () -の子プロセスは 0 を返し、 -.BR forkpty () -の親プロセスは子プロセスのプロセス ID を返す。 +\fBopenpty\fP(), \fBlogin_tty\fP(), \fBforkpty\fP() の呼び出しが成功しなかった場合、 \-1 が返されて、 +\fIerrno\fP はエラーを示す値に設定される。 成功した場合、 \fBopenpty\fP(), \fBlogin_tty\fP() および +\fBforkpty\fP() の子プロセスは 0 を返し、 \fBforkpty\fP() の親プロセスは子プロセスのプロセス ID を返す。 .SH エラー -以下の場合に -.BR openpty () -は失敗する: -.TP -.B ENOENT +以下の場合に \fBopenpty\fP() は失敗する: +.TP +\fBENOENT\fP 使用可能な端末がない。 .LP -.BR ioctl (2) -が -.I fd -を呼び出し元のプロセスの制御端末に設定するのに失敗した場合、 -.BR login_tty () -は失敗する。 +\fBioctl\fP(2) が \fIfd\fP を呼び出し元のプロセスの制御端末に設定するのに失敗した場合、 \fBlogin_tty\fP() は失敗する。 .LP -.BR openpty () -または -.BR fork (2) -のどちらかが失敗した場合、 -.BR forkpty () -は失敗する。 +\fBopenpty\fP() または \fBfork\fP(2) のどちらかが失敗した場合、 \fBforkpty\fP() は失敗する。 .SH 準拠 -これらは BSD の関数であり、libc5 と glibc2 に存在する。 -POSIX での標準化はされていない。 +これらは BSD の関数であり、libc5 と glibc2 に存在する。 POSIX での標準化はされていない。 .SH 注意 -.\" これらの関数は libutil に含まれている。したがって、コンパイル時の -.\" オプションに -.\" .B \-lutil -.\" を加える必要がある。 -.\" -glibc 2.8 で、 -.BR openpty () -と -.BR forkpty () -の構造体へのポインタの引き数に -.B const +glibc 2.8 で、 \fBopenpty\fP() と \fBforkpty\fP() の構造体へのポインタの引き数に \fBconst\fP 修飾子が追加された。 -2.0.92 より前のバージョンの glibc では、 -.BR openpty () -は BSD 疑似端末ペアのファイル・ディスクリプタを返す。 -2.0.92 以降の glibc では、 -.BR openpty () -はまず Unix 98 疑似端末ペアをオープンしようとし、それに失敗した場合に +2.0.92 より前のバージョンの glibc では、 \fBopenpty\fP() は BSD 疑似端末ペアのファイル・ディスクリプタを返す。 +2.0.92 以降の glibc では、 \fBopenpty\fP() はまず Unix 98 疑似端末ペアをオープンしようとし、それに失敗した場合に BSD 疑似端末ペアのオープンへと移行する。 .SH バグ -誰も -.I name -に対してどのくらい大きさを予約しておけばいいか分からない。 -したがって、NULL でない -.I name -を引き数として -.BR openpty () -や -.BR forkpty () -を呼び出すのは安全であるとは言えない。 +誰も \fIname\fP に対してどのくらい大きさを予約しておけばいいか分からない。 したがって、NULL でない \fIname\fP を引き数として +\fBopenpty\fP() や \fBforkpty\fP() を呼び出すのは安全であるとは言えない。 .SH 関連項目 -.BR fork (2), -.BR ttyname (3), -.BR pty (7) +\fBfork\fP(2), \fBttyname\fP(3), \fBpty\fP(7)