Manpages

名 前

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/ に 書 か れ て い る 。