ttyname ou isatty Subroutine

Propósito

Obtém o nome de um terminal ou determina se o dispositivo é um terminal.

Biblioteca

Biblioteca C Padrão (libc.a)

Sintaxe

#include <unistd.h>
char *ttyname( FileDescriptor)
int FileDescriptor;
int isatty(FileDescriptor)
int FileDescriptor;

Descrição

Atenção: Não use a subroutine ttyname em um ambiente multiencadeado.

A subroutine ttyname recebe o nome do caminho de um terminal.

A sub-rotina isatty determina se o descritor de arquivo especificado pelo parâmetro FileDescriptor está associado a um terminal

A subroutine isatinho não indica necessariamente que uma pessoa esteja disponível para interação, uma vez que os dispositivos não terminais podem estar conectados à linha de comunicações.

Parâmetros

Item Descrição
FileDescriptor Especifica um descritor de arquivo aberto.

Valores De Retorno

A sub-rotina ttyname retorna um ponteiro para uma sequência contendo o nome do caminho terminado em nulo do dispositivo terminal associado ao descritor de arquivo especificado pelo parâmetro FileDescriptor . Um ponteiro nulo é retornado e a variável global errno é configurada para indicar o erro se o descritor de arquivos não descrever um dispositivo de terminal no diretório /dev ..

O valor de retorno da subroutine ttyname pode apontar para dados estáticos cujo conteúdo é sobrescrito por cada chamada.

Se o descritor de arquivo especificado estiver associado a um terminal, a subroutine isatinho retornará um valor de 1. Se o descritor de arquivo não estiver associado a um terminal, um valor de 0 será retornado e a variável global errno será definida para indicar o erro.

Códigos De Erro

As subroutines ttyname e isatinho são malsucedidas se uma das seguintes for verdadeira:

Item Descrição
EBADF O parâmetro FileDescriptor não especifica um descritor de arquivo válido
ENOTTY O parâmetro FileDescriptor não especifica um dispositivo terminal.

Arquivos

Item Descrição
/dev/* Arquivos especiais do dispositivo terminal.