This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ttyname()

Get a fully qualified pathname for a file

Synopsis:

#include <unistd.h>

char *ttyname( int fildes );

Arguments:

fildes

A file descriptor that's associated with the file whose name you want to get.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The ttyname() function returns a pointer to a static buffer that contains a fully qualified pathname associated with the file associated with fildes.

Returns:

A pointer to the pathname for fildes, or NULL if an error occurred (errno is set).

Errors:

EBADF

The fildes argument is invalid.

ENOSYS

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

ENOTTY

Not a tty.

Examples:

/*
 * The following program prints out the name
 * of the terminal associated with stdin.
 */
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

int main( void )
{
    if( isatty( 0 ) ) {
       printf( "%s\n", ttyname( 0 ) );
    } else {
       printf( "\n" );
    }
    return EXIT_SUCCESS;
}

Classification:

POSIX 1003.1

See also:

ctermid(), setsid(), ttyname_r()