1TTYNAME(3)                 Linux Programmer's Manual                TTYNAME(3)
2
3
4

NAME

6       ttyname, ttyname_r - return name of a terminal
7

SYNOPSIS

9       #include <unistd.h>
10
11       char *ttyname(int fd);
12
13       int ttyname_r(int fd, char *buf, size_t buflen);
14

DESCRIPTION

16       The  function  ttyname() returns a pointer to the null-terminated path‐
17       name of the terminal device that is open on the file descriptor fd,  or
18       NULL on error (for example, if fd is not connected to a terminal).  The
19       return value may point to static data, possibly overwritten by the next
20       call.   The function ttyname_r() stores this pathname in the buffer buf
21       of length buflen.
22

RETURN VALUE

24       The function ttyname() returns a pointer to a pathname on success.   On
25       error,  NULL is returned, and errno is set appropriately.  The function
26       ttyname_r() returns 0 on success, and an error number upon error.
27

ERRORS

29       ttyname_r():
30
31       EBADF  Bad file descriptor.
32
33       ENOTTY File descriptor does not refer to a terminal device.
34
35       ERANGE buflen was too small to allow storing the pathname.
36

CONFORMING TO

38       4.2BSD, POSIX.1-2001.
39

SEE ALSO

41       fstat(2), isatty(3)
42

COLOPHON

44       This page is part of release 3.22 of the Linux  man-pages  project.   A
45       description  of  the project, and information about reporting bugs, can
46       be found at http://www.kernel.org/doc/man-pages/.
47
48
49
50Linux                             2008-07-14                        TTYNAME(3)
Impressum