名前

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