Man page - grantpt(3)

Packages contains this manual

Available languages:

en fr pl ja ru ro

Manual

GRANTPT

名 前
書 式
説 明
返 り 値
エ ラ ー
バ ー ジ ョ ン
属 性
準 拠
注 意
関 連 項 目
こ の 文 書 に つ い て

名 前

grantpt - ス レ ー ブ 擬 似 端 末 へ の ア ク セ ス を 許 可 す る

書 式

#include <stdlib.h>

int grantpt(int fd );

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 ( feature_test_macros (7) 参 照 ):

grantpt ():

glibc 2.24 以 降 :
_XOPEN_SOURCE >= 500 ||
(_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED)
glibc 2.23 以 前 :
_XOPEN_SOURCE

説 明

grantpt () 関 数 は 、 フ ァ イ ル デ ィ ス ク リ プ タ ー fd で 参 照 さ れ た マ ス タ 擬 似 端 末 に 対 応 す る ス レ ー ブ 擬 似 端 末 デ バ イ ス の モ ー ド と 所 有 者 を 変 更 す る 。 ス レ ー ブ の ユ ー ザ ー ID は 呼 び 出 し た プ ロ セ ス の 実 UID に 設 定 さ れ る 。 グ ル ー プ ID と し て 設 定 さ れ る 値 は 規 定 さ れ て い な い (例 え ば tty に な る )。 ス レ ー ブ の モ ー ド は 0620 (crw--w----) に 設 定 さ れ る 。

SIGCHLD シ グ ナ ル を 捕 捉 す る た め に シ グ ナ ル ハ ン ド ラ ー が 設 定 さ れ て い る 場 合 の grantpt () の 動 作 は 規 定 さ れ て い な い 。

返 り 値

成 功 し た 場 合 、 grantpt () は 0 を 返 す 。 そ う で な い 場 合 、 -1 を 返 し 、 errno に 適 切 な 値 が セ ッ ト さ れ る 。

エ ラ ー

EACCES

対 応 す る ス レ ー ブ 擬 似 端 末 に ア ク セ ス で き な か っ た 。

EBADF

引 数 fd が 有 効 な オ ー プ ン さ れ た フ ァ イ ル デ ィ ス ク リ プ タ ー で な い 。

EINVAL

引 数 fd は 有 効 だ が 、 マ ス タ 擬 似 端 末 に 対 応 す る も の で は な い 。

バ ー ジ ョ ン

grantpt () は 、 バ ー ジ ョ ン 2.1 以 降 の glibc で 提 供 さ れ て い る 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-20201-1.png

準 拠

POSIX.1-2001, POSIX.1-2008.

注 意

こ れ は UNIX 98 疑 似 端 末 仕 様 の 一 部 で あ る 。 pts (4) を 参 照 。

Many systems implement this function via a set-user-ID helper binary called "pt_chown". On Linux systems with a devpts filesystem (present since Linux 2.2), the kernel normally sets the correct ownership and permissions for the pseudoterminal slave when the master is opened ( posix_openpt (3)), so that nothing must be done by grantpt (). Thus, no such helper binary is required (and indeed it is configured to be absent during the glibc build that is typical on many systems).

関 連 項 目

open (2), posix_openpt (3), ptsname (3), unlockpt (3), pts (4), pty (7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。