Manpage of TTYNAME

TTYNAME

Section: Linux Programmer's Manual (3)
Updated: 2015-08-08
Index
 

NAME

ttyname, ttyname_r - return name of a terminal  

SYNOPSIS

#include <unistd.h>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 bufof length buflen.  

RETURN VALUE

The function ttyname() returns a pointer to a pathname on success. On error, NULL is returned, and errnois set appropriately. The function ttyname_r() 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
(ttyname_r()) buflenwas too small to allow storing the pathname.
 

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).
InterfaceAttributeValue
ttyname() Thread safetyMT-Unsafe race:ttyname
ttyname_r() Thread safetyMT-Safe
 

CONFORMING TO

POSIX.1-2001, POSIX.1-2008, 4.2BSD.  

SEE ALSO

fstat(2), ctermid(3), isatty(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
ATTRIBUTES
CONFORMING TO
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 16:30:22 GMT, October 09, 2016 Click Here!