getttyent, getttynam, setttyent, endttyent − Lire le fichier des terminaux.

#include <ttyent.h>

struct ttyent *getttyent(void);

struct ttyent *getttynam(const char *nom);

int setttyent(void);

int endttyent(void);

Ces fonctions fournissent une interface pour le fichier _PATH_TTYS (par exemple /etc/ttys).

La fonction setttyent() ouvre le fichier, ou reprend la lecture au début s’il était déjà ouvert.

La fonction endttyent() ferme le fichier.

La fonction getttynam() recherche un nom de terminal dans le fichier. Elle renvoie un pointeur sur une structure ttyent (voir ci-dessous).

La fonction getttyent() ouvre le fichier _PATH_TTYS (si besoin) et renvoie la première entrée. Si le fichier est déjà ouvert, elle renvoie l’entrée suivante.

La structure ttyent

struct ttyent {
        char    *ty_name;       /* nom du terminal */
        char    *ty_getty;      /* commande à exécuter (p.ex. : getty) */
        char    *ty_type;       /* type termcap de terminal */
        int     ty_status;      /* attributs d’état */
        char    *ty_window;     /* commande gestionnaire de fenêtres */
        char    *ty_comment;    /* commentaires */
};

Le champ ty_status peut valoir

#define TTY_ON       0x01   /* autoriser les logins (avec ty_getty) */
#define TTY_SECURE   0x02   /* autoriser login de l’UID zéro */

Sous Linux, le fichier /etc/ttys, et les fonctions décrites ci-dessus ne sont pas utilisés.

Pas dans POSIX.1-2001. Présente sur les BSD et peut être sur d’autres systèmes.

ttyname(3), ttyslot(3)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 21 juillet 2003 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 getttyent ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.