TTYNAME(3)

名前
ttyname, ttyname_r - 端末名を返す

書式
#include <unistd.h>

char *ttyname(int fd);

int ttyname_r(int fd, char *buf, size_t buflen);

説明
ttyname() 関数は、ファイルディスクリプター fd がオープンしている端末デバイスの NULL 終端されたパス名へのポインターを返す。 エラーが起きたならば NULL を返す (たとえば、fd が端末を参照していないとき)。 返り値は静的データを指しているので、次の呼び出しで上書きされる可能性がある。 ttyname_r() 関数は、このパス名を長さ buflen のバッファー buf に格納する。

返り値
ttyname() 関数は、成功時はパス名へのポインターを返す。 エラー時は NULL を返し、 errno が適切に設定される。 ttyname_r() 関数は、成功時には 0 を返し、エラー時にはエラー番号を返す。

エラー

EBADF
    ファイルディスクリプターが不正。

ENODEV
    fd refers to a slave pseudoterminal device but the corresponding pathname could not be found (see NOTES).

ENOTTY
    fd が端末デバイスを参照していない。

ERANGE
    (ttyname_r()) buflen がパス名を格納するには短すぎる。

属性
この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース | 属性 | 値
ttyname() | Thread safety | MT-Unsafe race:ttyname
ttyname_r() | Thread safety | MT-Safe

準拠
POSIX.1-2001, POSIX.1-2008, 4.2BSD.

注意
A process that keeps a file descriptor that refers to a pts(4) device open when switching to another mount namespace that uses a different /dev/ptmx instance may still accidentally find that a device path of the same name for that file descriptor exists. However, this device path refers to a different device and thus can't be used to access the device that the file descriptor refers to. Calling ttyname() or ttyname_r() on the file descriptor in the new mount namespace will cause these functions to return NULL and set errno to ENODEV.

関連項目
tty(1), fstat(2), ctermid(3), isatty(3), pts(4)

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