ttyname_r() -- get path name of terminal (reentrant)

SYNOPSIS

#include <unistd.h>

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

The ttyname_r() function stores the null-terminated path name of the terminal associated with the file descriptor fildes in the buffer name. The buffer should have space for the name and the terminating null character. The maximum length of the terminal name is TTY_NAME_MAX.

PARAMETERS

fildes: Is the file descriptor that associates with the string containing the null-terminated path name of the terminal.
name: Is the buffer to receive the path name.
namesize: Is the length of name.

RETURN VALUES

On success, ttyname_r() returns 0. On error one of the following values is returned:

EBADF: fildes is not a valid file descriptor.
ENOTTY: fildes does not refer to a terminate device.
ERANGE: The value of namesize is smaller than the length of the string to be returned, including the terminating null character.