Sous-routine ttyname ou isatty

Objectif

Extrait le nom d'un terminal ou détermine si l'unité est un terminal.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

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

Descriptif

Attention: N'utilisez pas la sous-routine Nom_ttyt dans un environnement à unités d'exécution multiples.

Le sous-programme Nom_ttyt obtient le nom de chemin d'un terminal.

La sous-routine isatty détermine si le descripteur de fichier spécifié par le paramètre FileDescriptor est associé à un terminal.

Le sous-programme Isatty n'indique pas nécessairement qu'une personne est disponible pour l'interaction, car les périphériques non terminaux peuvent être connectés à la ligne de communication.

Paramètres

Article Descriptif
FileDescriptor Indique un descripteur de fichier ouvert.

Valeurs renvoyées

La sous-routine ttyname renvoie un pointeur vers une chaîne contenant le nom de chemin à terminaison nulle de l'unité de terminal associée au descripteur de fichier spécifié par le paramètre FileDescriptor . Un pointeur null est renvoyé et la variable globale errno est définie pour indiquer l'erreur si le descripteur de fichier ne décrit pas une unité de terminal dans le répertoire /dev .

La valeur de retour de la sous-routine Nom_ttyt peut pointer vers des données statiques dont le contenu est écrasé par chaque appel.

Si le descripteur de fichier spécifié est associé à un terminal, la sous-routine Isatty renvoie une valeur de 1. Si le descripteur de fichier n'est pas associé à un terminal, la valeur 0 est renvoyée et la variable globale Errno est définie pour indiquer l'erreur.

Codes d'erreur

Les sous-routines Nom_ttyt et Isatty ne sont pas réussies si l'une des opérations suivantes est vraie:

Article Descriptif
EBADF Le paramètre FileDescriptor ne spécifie pas de descripteur de fichier valide.
ENOTTY Le paramètre FileDescriptor ne spécifie pas d'unité de terminal.

Fichiers

Article Descriptif
/dev/* Fichiers spéciaux de l'unité de terminal.