EN JA
TTYNAME(3)
TTYNAME(3) FreeBSD Library Functions Manual TTYNAME(3)

名称

ttyname, ttyname_r, isattyファイル記述子から関連する端末 (tty) の名前を取得する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < unistd.h>

char *
ttyname( int fd);

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

int
isatty( int fd);

解説

これらの関数は、端末タイプのデバイスのためのファイル記述子で動作します。

isatty() 関数は、ファイル記述子 fd が有効な端末タイプのデバイスを参照しているかを確認します。

ttyname() 関数は、 isatty() が真であるファイル記述子の関連するデバイス名を取得します。

ttyname() 関数は、その後の呼び出しで上書きされるかもしれない静的なバッファに格納された名前を返します。 ttyname_r() 関数は、この問題を避けるために引数としてバッファと長さを取ります。

戻り値

ttyname() 関数は、デバイスが見つかり、 isatty() が、が真であるなら、ヌル文字で終了する名前を返し、そうでなければ、 NULL ポインタが返されます。 ttyname_r() 関数は、成功すれば、0 を返します。そうでなければ、エラー番号が返されます。

エラー

ttyname_r() は、失敗すれば、次のエラーコードを返します:
[ ENOTTY]
fd 引数が有効なファイル記述子ではありません。
[ ERANGE]
bufsize 引数が返される文字列の長さより小さいです。

歴史

isatty() と ttyname() 関数は、 Version 7 AT&T UNIX で登場しました。 ttyname_r() 関数は、 FreeBSD 6.0 で登場しました。
May 14, 2005 FreeBSD