Man page - ptsname_r(3)

Packages contains this manual

Available languages:

en fr pl ja ru ro

Manual

PTSNAME

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

名 前

ptsname, ptsname_r - ス レ ー ブ 擬 似 端 末 の 名 前 を 取 得 す る

書 式

#include <stdlib.h>

char *ptsname(int fd );
int ptsname_r(int fd , char * buf , size_t buflen );

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

ptsname ():

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

ptsname_r ():
_GNU_SOURCE

説 明

ptsname () 関 数 は 、 フ ァ イ ル デ ィ ス ク リ プ タ ー fd で 参 照 さ れ る マ ス タ 擬 似 端 末 (pts) デ バ イ ス に 対 応 す る ス レ ー ブ 擬 似 端 末 デ バ イ ス の 名 前 を 返 す 。

ptsname_r () 関 数 は ptsname () の リ エ ン ト ラ ン ト な バ ー ジ ョ ン で あ る 。 こ の 関 数 は 、 ス レ ー ブ 疑 似 端 末 デ バ イ ス の 名 前 を 、 ヌ ル で 終 端 さ れ た 文 字 列 の 形 で buf で 指 定 さ れ た バ ッ フ ァ ー に 格 納 し て 返 す 。 buflen 引 数 に は buf の バ イ ト 数 を 指 定 す る 。

返 り 値

成 功 の 場 合 、 ptsname () は 静 的 記 憶 領 域 の 文 字 列 へ の ポ イ ン タ ー を 返 す 。 こ の 記 憶 領 域 は こ の 後 の ptsname () の 呼 び 出 し で 上 書 き さ れ る 。 こ の ポ イ ン タ ー を free し て は い け な い 。 エ ラ ー の 場 合 は NULL を 返 す 。

成 功 の 場 合 、 ptsname_r () は 0 を 返 す 。 エ ラ ー の 場 合 、 0 以 外 の 値 を 返 し 、 エ ラ ー を 示 す た め 、 エ ラ ー 番 号 が 返 さ れ る 。

エ ラ ー

EINVAL

( ptsname_r () only) buf is NULL. (This error is returned only for glibc 2.25 and earlier.)

ENOTTY

fd が マ ス タ 疑 似 端 末 デ バ イ ス を 参 照 し て い な い 。

ERANGE

( ptsname_r () の み ) buf が 小 さ す ぎ る 。

バ ー ジ ョ ン

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

属 性

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

Image grohtml-32086-1.png

準 拠

ptsname ():
POSIX.1-2001, POSIX.1-2008.

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

ptsname_r () は Linux に よ る 拡 張 で あ り 、 POSIX.1 の 次 の メ ジ ャ ー バ ー ジ ョ ン (Issue 8) に 含 め る よ う に 提 案 さ れ て い る 。 こ の 関 数 に つ い て の 記 載 が あ る も の と し て Tru64 と HP-UX が あ る が 、 こ れ ら の OS で の 実 装 で は エ ラ ー の 場 合 -1 を 返 し 、 errno に エ ラ ー を 示 す 値 を 設 定 す る 。 移 植 を 考 慮 し た プ ロ グ ラ ム で は こ の 関 数 の 使 用 は 避 け る こ と 。

関 連 項 目

grantpt (3), posix_openpt (3), ttyname (3), unlockpt (3), pts (4), pty (7)

こ の 文 書 に つ い て

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