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> int FileDescriptor;
int isatty(FileDescriptor)
int FileDescriptor;Descrição
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. |