名 前
grantpt − ス レ ー ブ 擬 似 端 末 へ の ア ク セ ス を 許 可 す る
書 式
#define
_XOPEN_SOURCE /* feature_test_macros(7) 参
照 */
#include <stdlib.h>
int grantpt(int fd);
説 明
grantpt() 関 数 は 、 fd で 参 照 さ れ た マ ス タ 擬 似 端 末 に 対 応 す る ス レ ー ブ 擬 似 端 末 デ バ イ ス の モ ー ド と 所 有 者 を 変 更 す る 。 ス レ ー ブ の ユ ー ザ ー ID は 呼 び 出 し た プ ロ セ ス の 実 UID に 設 定 さ れ る 。 グ ル ー プ ID と し て 設 定 さ れ る 値 は 規 定 さ れ て い な い (例 え ば tty に な る )。 ス レ ー ブ の モ ー ド は 0620 (crw−−w−−−−) に 設 定 さ れ る 。
SIGCHLD シ グ ナ ル を 捕 捉 す る た め に シ グ ナ ル ハ ン ド ラ ー が 設 定 さ れ て い る 場 合 の grantpt() の 動 作 は 規 定 さ れ て い な い 。
返 り 値
成 功 し た 場 合 、 grantpt() は 0 を 返 す 。 そ う で な い 場 合 、 −1 を 返 し 、 errno に 適 切 な 値 が セ ッ ト さ れ る 。
エ ラ ー
|
EACCES 対 応 す る ス レ ー ブ 擬 似 端 末 に ア ク セ ス で き な か っ た 。 |
||
|
EBADF 引 き 数 |
fd が 有 効 な オ ー プ ン さ れ た フ ァ イ ル デ ィ ス ク リ プ タ ー で な い 。
|
EINVAL 引 き 数 |
fd は 有 効 だ が 、 マ ス タ 擬 似 端 末 に 対 応 す る も の で は な い 。 |
バ ー ジ ョ ン
grantpt() は 、 バ ー ジ ョ ン 2.1 以 降 の glibc で 提 供 さ れ て い る 。
準 拠
POSIX.1−2001.
注 意
こ れ は UNIX 98 擬 似 端 末 (pseudoterminal) 仕 様 の 一 部 で あ る 。 pts(4) を 参 照 の こ と 。 多 く の シ ス テ ム で は 、 こ の 関 数 は "pt_chown" と 呼 ば れ る set−user−ID さ れ た 補 助 バ イ ナ リ を 用 い て 実 装 さ れ て い る 。 Linux の devpts で は 、 こ の よ う な 補 助 バ イ ナ リ を 必 要 と し な い 。
関 連 項 目
open(2), posix_openpt(3), ptsname(3), unlockpt(3), pts(4), pty(7)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。