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       int ttyname_r(int fd, char *buf, size_t buflen);
13

DESCRIPTION

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

RETURN VALUE

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

ERRORS

28       Values stored in errno by a failing ttyname() or returned by a  failing
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
43
44
45Linux                             2002-07-20                        TTYNAME(3)
Impressum