ptsnameのヘルプ・マニュアル
日本語 英語
ptsname --help
man ptsname
PTSNAME(3) Linux Programmer’s Manual PTSNAME(3)
名前
ptsname, ptsname_r - スレーブ擬似端末の名前を取得する
書式
#define _XOPEN_SOURCE
#include
char *ptsname(int fd);
#define _GNU_SOURCE
#include
int ptsname_r(int fd, char *buf, size_t buflen);
説明
ptsname() 関数は fd で参照されるマスタ擬似端末 (pts) デバイスに対応する
スレーブ擬似端末デバイスの名前を返す。
ptsname_r() 関数は ptsname() のリエントラントなバージョンである。この関
数 は、スレーブ疑似端末デバイスの名前を、 NULL で終端された文字列の形で
buf で指定されたバッファに格納して返す。 buflen 引き数には buf のバイト
数を指定する。
返り値
成功の場合、 ptsname() は静的記憶領域の文字列へのポインタを返す。この記
憶領域はこの後の ptsname() の呼び出しで上書きされる。このポ イ ン タ を
free してはいけない。エラーの場合は NULL ポインタを返す。
成 功の場合、 ptsname_r() は 0 を返す。エラーの場合、0 以外の値を返し、
errno をエラーを示す値に設定する。
エラー
EINVAL (ptsname_r() のみ) buf が NULL である。
ENOTTY fd がマスタ疑似端末デバイスを参照していない。
ERANGE (ptsname_r() のみ) buf が小さすぎる。
バージョン
ptsname() は、バージョン 2.1 以降の glibc で提供されている。
準拠
ptsname() は Unix98 疑似端末仕様の一部である (pts(4) を参照のこと)。 こ
の関数は POSIX.1-2001 で規定されている。
ptsname_r() は Linux による拡張である。この関数についての記載があるもの
として Tru64 と HP-UX があるが、これらの OS での実装ではエラーの場合 -1
を返し、 errno にエラーを示す値を設定する。移植を考慮したプログラムでは
この関数の使用は避けること。
関連項目
grantpt(3), posix_openpt(3), ttyname(3), unlockpt(3), pts(4), fea-
ture_test_macros(7), pty(7)
2008-09-03 PTSNAME(3)
PTSNAME(3) Linux Programmer’s Manual PTSNAME(3)
NAME
ptsname, ptsname_r - get the name of the slave pseudo-terminal
SYNOPSIS
#define _XOPEN_SOURCE
#include
char *ptsname(int fd);
#define _GNU_SOURCE
#include
int ptsname_r(int fd, char *buf, size_t buflen);
DESCRIPTION
The ptsname() function returns the name of the slave pseudo-terminal
(pty) device corresponding to the master referred to by fd.
The ptsname_r() function is the reentrant equivalent of ptsname(). It
returns the name of the slave pseudo-terminal device as a null-termi-
nated string in the buffer pointed to by buf. The buflen argument
specifies the number of bytes available in buf.
RETURN VALUE
On success, ptsname() returns a pointer to a string in static storage
which will be overwritten by subsequent calls. This pointer must not
be freed. On failure, a NULL pointer is returned.
On success, ptsname_r() returns 0. On failure, a non-zero value is
returned and errno is set to indicate the error.
ERRORS
EINVAL (ptsname_r() only) buf is NULL.
ENOTTY fd does not refer to a pseudo-terminal master device.
ERANGE (ptsname_r() only) buf is too small.
VERSIONS
ptsname() is provided in glibc since version 2.1.
CONFORMING TO
ptsname() is part of the Unix98 pseudo-terminal support (see pts(4)).
This function is specified in POSIX.1-2001.
ptsname_r() is a Linux extension. A version of this function is docu-
mented on Tru64 and HP-UX, but on those implementations, -1 is returned
on error, with errno set to indicate the error. Avoid using this func-
tion in portable programs.
SEE ALSO
grantpt(3), posix_openpt(3), ttyname(3), unlockpt(3), pts(4), fea-
ture_test_macros(7), pty(7)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
2008-09-03 PTSNAME(3)