ttyname_r()

Get a fully qualified pathname for a file

Synopsis:

#include <unistd.h>

int ttyname_r( int fildes, 
               char* name, 
               size_t namesize );

Library:

libc

Description:

The ttyname_r() function stores the null-terminated pathname of the terminal associated with the file descriptor fildes in the character array referenced by name. The array is namesize characters long and should have space for the name and the terminating NULL character.

Returns:

Zero for success, or an error number.

Errors:

EBADF

The fildes argument isn't a valid file descriptor.

ENOSYS

The ttyname_r() function isn't implemented for the filesystem specified by filedes.

ENOTTY

The fildes argument doesn't refer to a tty.

ERANGE

The value of namesize is smaller than the length of the string to be returned, including the terminating null character.

Classification:

POSIX 1003.1

See also:

ctermid(), errno, setsid(), ttyname()