TTYNAME(3) Linux Programmer's Manual TTYNAME(3)
NAME
ttyname, ttyname_r - return name of a terminal//返回终端的名称
SYNOPSIS
#include
char *ttyname(int fd);
int ttyname_r(int fd, char *buf, size_t buflen);
DESCRIPTION
The function ttyname() returns a pointer to the null-terminated pathname of
the terminal device that is open on the file descriptor fd, or NULL on error
(for example, if fd is not connected to a terminal). The return value may
point to static data, possibly overwritten by the next call. The function
ttyname_r() stores this pathname in the buffer buf of length buflen.
//函数ttyname() 返回一个指向以NULL结尾的终端设备的路径的字符串,这个设备通过文件描述符fd打开,或者错误的话返回NULL
//(例如,如果fd没有连向一个终端的话).返回值可能指向静态的数据,可能被下一个调用覆盖.
//函数ttyname_r() 在以buflen标识长度的buf中存储这个路径.
RETURN VALUE
The function ttyname() returns a pointer to a pathname on success. On error,
NULL is returned, and errno is set appropriately. The function ttyname_r()
returns 0 on success, and an error number upon error.
//函数ttyname() 成功的话返回一个指向路径的指针,错误的话返回NULL,错误号自动设置.
//函数ttyname_r() 成功的话返回0,或者是根据错误的错误号.
ERRORS
ttyname_r():
EBADF Bad file descriptor.//错误的文件描述符
ENOTTY File descriptor does not refer to a terminal device.//文件描述符不是指向终端设备
ERANGE buflen was too small to allow storing the pathname.//buflen太小了不够存储路径
CONFORMING TO
4.2BSD, POSIX.1-2001.
SEE ALSO
fstat(2), isatty(3)
COLOPHON
This page is part of release 3.32 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/.
Linux 2008-07-14 TTYNAME(3)