NAME
ttyname, ttynamer - return name of a terminal SYNOPSIS
#include
char *ttyname(int fd); int ttynamer(int fd, char *buf, sizet buflen); DESCRIPTION The function ttyname() returns a pointer to the null-terminated path‐ name 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 ttynamer() stores this pathname in the buffer buf of length buflen. 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 ttynamer() returns 0 on success, and an error number upon error. ERRORS EBADF Bad file descriptor. ENOTTY File descriptor does not refer to a terminal device. ERANGE (ttynamer()) buflen was too small to allow storing the path‐ name. ATTRIBUTES For an explanation of the terms used in this section, see attributes(7). ┌────────────┬───────────────┬────────────────────────┐ │Interface │ Attribute │ Value │ ├────────────┼───────────────┼────────────────────────┤
│ttyname() │ Thread safety │ MT-Unsafe race:ttyname │ ├────────────┼───────────────┼────────────────────────┤
│ttynamer() │ Thread safety │ MT-Safe │ └────────────┴───────────────┴────────────────────────┘ CONFORMING TO
4.2BSD, POSIX.1-2001. SEE ALSO fstat(2), ctermid(3), isatty(3) COLOPHON
This page is part of release 3.53 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 2013-06-21 TTYNAME(3)