AGETTY(8) Administration Systeme AGETTY(8) NOM agetty - getty alternatif pour Linux SYNOPSIS agetty [options] port [baud_rate...] [term] DESCRIPTION agetty opens a tty port, prompts for a login name and invokes the /bin/login command. It is normally invoked by init(8). agetty has several non-standard features that are useful for hardwired and for dial-in lines: o Adapter la configuration du terminal aux bits de parite et aux caracteres supprimer, tuer, fin de ligne et majuscules lors de la lecture de l'identifiant de connexion. Le programme peut gerer les caracteres 7 bits avec une parite paire, impaire, aucune ou parite 0 et les caracteres 8 bits sans parite. Les caracteres speciaux suivants sont reconnus : << Ctrl-U >> (tuer) ; suppression et espace arriere (supprimer) ; retour chariot et changement de ligne (fin de ligne). Consultez egalement les options --erase-chars et --kill-chars. o Option pour trouver la vitesse en baud des messages CONNECT produits par les modems Hayestm ou compatibles. o Option pour ne pas raccrocher quand il y a deja une ligne ouverte (utile pour les applications avec rappel). o Option pour ne pas afficher le contenu du fichier /etc/issue. o Option pour afficher un autre fichier ou repertoire issue a la place de /etc/issue ou /etc/issue.d. o Option pour ne pas demander de nom d'utilisateur. o Option pour appeler un programme de connexion non standard au lieu de /bin/login. o Option pour activer le controle materiel de flux. o Option pour forcer la ligne a etre locale sans necessite de detection de porteuse. Ce programme n'utilise pas les fichiers /etc/gettydefs (Systeme V) ou /etc/gettytab (SunOS 4). ARGUMENTS port Un nom de chemin relatif au repertoire /dev. Si un << - >> est utilise, agetty suppose que son entree standard est deja connectee a un port de terminal et que la connexion a un utilisateur distant est deja etablie. Sous Systeme V, un parametre port avec la valeur << - >> doit etre precede de << -- >>. taux_baud,... Une liste de vitesses en baud separees par des virgules. Chaque fois que agetty recoit un caractere BREAK, il avance dans la liste qui sera consideree comme une liste circulaire. Les vitesses devraient etre indiquees en ordre decroissant, de telle sorte que l'octet NULL final (Ctrl-@) puisse etre utilise pour changer de vitesse. Cet argument est facultatif et inutile pour les terminaux virtuels. La valeur par defaut pour les terminaux serie est de conserver la vitesse actuelle (consultez --keep-baud) et en cas d'insucces, la valeur par defaut << 9600 >>. term La valeur a utiliser pour la variable d'environnement TERM. Cela surcharge toute valeur positionnee par init(1) et est heritee par la connexion et l'interpreteur de commandes. La valeur par defaut est << vt100 >> ou << linux >> pour Linux sur un terminal virtuel ou << hurd >> pour le GNU Hurd sur un terminal virtuel. OPTIONS -8, --8bits Supposer que le terminal gere les caracteres 8 bits, desactiver de ce fait la detection de parite. -a, --autologin nom_utilisateur Connecter automatiquement l'utilisateur indique sans demander un identifiant ou un mot de passe. Utiliser cette option fait que l'option et l'argument -f nom_utilisateur sont ajoutes a la ligne de commande de /bin/login. Consultez --login-options qui peut etre utilisee pour modifier le comportement de cette option. Remarquez que --autologin peut affecter la facon dont agetty initialise une ligne serie, car lors d'une connexion automatique agetty ne lit pas a partir de la ligne et n'a aucune opportunite d'optimisation des reglages de la ligne. -c, --noreset Ne pas reinitialiser les cflags du terminal (modes de controle). Consultez termios(3) pour plus de precisions. -E, --remote Classiquement, la commande login(1) est fournie avec un non d'hote distant lorsqu'elle est appelee par quelque chose comme telnetd(8). Cette option permet a agetty de passer ce qu'il utilise comme nom d'hote a login(1) pour une utilisation dans utmp(5). Consultez --host, login(1) et utmp(5). Si une option --host hote_factice est donnee, alors une option -h hote_factice est ajoutee a la ligne de commande /bin/login. Si l'option --nohostname est fournie, alors une option -H est ajoutee a la ligne de commande /bin/login. Consultez --login-options. -f, --issue-file chemin Specifies a ":" delimited list of files and directories to be displayed instead of /etc/issue (or other). All specified files and directories are displayed, missing or empty files are silently ignored. If the specified path is a directory then display all files with .issue file extension in version-sort order from the directory. This allows custom messages to be displayed on different terminals. The --noissue option will override this option. --show-issue Display the current issue file (or other) on the current terminal and exit. Use this option to review the current setting, it is not designed for any other purpose. Note that output may use some default or incomplete information as proper output depends on terminal and agetty command line. -h, --flow-control Activer le controle materiel de flux (RTS/CTS). L'application est libre de desactiver le controle logiciel de flux (XON/XOFF) quand elle le juge opportun. -H, --host hote_factice Ecrire l'hote de connexion hote_factice indique dans le fichier utmp. Normalement, aucun hote de connexion n'est fourni, puisque agetty est utilise pour les connexions filaires locales et les terminaux du systeme. Cependant, cette option peut etre utile pour identifier les concentrateurs de terminaux et materiels similaires. -i, --noissue Ne pas afficher le contenu de /etc/issue (ou autre) avant d'ecrire l'invite de connexion. Les terminaux ou le materiel de communication peuvent ne pas fonctionner normalement lorsqu'ils recoivent beaucoup de texte a une mauvaise vitesse ; les scripts de connexion peuvent echouer si l'invite de connexion est precedee par beaucoup trop de texte. -I, --init-string chaine_initiale Definir une chaine_initiale a envoyer au terminal ou au modem avant d'envoyer des donnees utiles. Cela peut etre utilise pour initialiser un modem. Les caracteres non imprimables peuvent etre envoyes en utilisant leur code octal precede d'une barre oblique inversee (\). Par exemple, pour envoyer le caractere de changement de ligne (ASCII 10, dont le code octal est 012), il faut envoyer << \12 >>. -J, --noclear Ne pas effacer l'ecran avant de demander l'identifiant de connexion. Par defaut, l'ecran est efface. -l, --login-program programme_connexion Appeler le programme de connexion programme_connexion a la place de /bin/login. Cela permet d'utiliser un programme de connexion non standard. Un tel programme, par exemple, peut demander un mot de passe lors de l'etablissement de la connexion ou utiliser un fichier de mot de passe different. Consultez --login-options. -L, --local-line[=mode] Control the CLOCAL line flag. The optional mode argument is auto, always or never. If the mode argument is omitted, then the default is always. If the --local-line option is not given at all, then the default is auto. always Le mode always force la ligne a etre une ligne locale sans detection de porteuse. C'est utile pour un terminal connecte localement dont la ligne serie n'utilise pas le signal << detection de porteuse >>. never Le mode never efface explicitement l'attribut CLOCAL de la configuration de la ligne et le signal << detection de porteuse >> est attendu sur la ligne. auto La valeur par defaut pour agetty. Cela ne modifie pas la configuration CLOCAL et suit la configuration activee par le noyau. -m, --extract-baud Essayer d'extraire la vitesse depuis le message d'etat CONNECT produit par les modems compatibles Hayestm. Ces messages d'etat sont de la forme suivante : << >>. agetty suppose que le modem envoie les messages d'etat a la meme vitesse que celle indiquee (la premiere) par taux_baud sur la ligne de commande. Puisque la fonctionnalite --extract-baud peut echouer sur des systemes lourdement charges, vous devriez activer le traitement de BREAK en enumerant toutes les vitesses attendues sur la ligne de commande. --list-speeds Afficher les vitesses prises en charge. Elles sont determinees au moment de la compilation. -n, --skip-login Ne pas demander d'identifiant de connexion a l'utilisateur. Cela peut etre utilise avec l'option --login-program lors d'une procedure de connexion non standard comme les systemes BBS. Remarquez qu'avec l'option --skip-login, agetty ne recoit pas de saisie de l'utilisateur qui se connecte et donc n'est pas capable de detecter la parite, la taille des caracteres ni le processus de nouvelle ligne de la connexion. La configuration par defaut est : parite 0, caracteres 7 bits et le caractere fin de ligne est le retour chariot RC en ASCII (13). Assurez vous que le programme lance par agetty (en general, /bin/login) est execute avec les droits du superutilisateur. -N, --nonewline Ne pas ajouter de changement ligne avant d'ecrire /etc/issue. -o, --login-options options_connexion Options et arguments passes a login(1), ou \u est remplace par le nom de connexion. Par exemple : --login-options '-h darkstar -- \u' Consultez --autologin, --login-program et --remote. Please read the SECURITY NOTICE below before using this option. -p, --login-pause Attendre une action sur une touche avant de basculer vers l'invite de connexion. Cela peut etre combine avec --autologin pour economiser de la memoire avec les interpreteurs de commandes lents a relancer. -r, --chroot repertoire Modifier la racine vers le repertoire indique. -R, --hangup Appeler vhangup(2) pour faire un raccrochage virtuel du terminal indique. -s, --keep-baud Essayer de conserver la vitesse existante. Les vitesses recues sur la ligne de commande sont utilisees quand agetty recoit un caractere BREAK. Si d'autres vitesses sont indiquees, alors la vitesse originale est aussi enregistree a la fin de la liste des vitesses desirees. Cela peut etre utilise pour retourner a la vitesse originale apres des BREAK inattendus. -t, --timeout delai Quitter si aucun nom d'utilisateur n'a pu etre lu pendant le delai exprime en seconde. Cette option ne devrait pas etre utilisee pour les lignes filaires de terminaux. -U, --detect-case Activer la detection des terminaux a caracteres majuscules seuls. Cela ne detectera qu'un identifiant de connexion ne possedant que des caracteres majuscules et activera des operations de conversions de casse majuscules vers minuscules. Cette option ne gere aucun caractere Unicode. -w, --wait-cr Attendre que l'utilisateur ou le modem envoient un caractere retour a la ligne ou nouvelle ligne avant d'envoyer le fichier /etc/issue (ou autres) et l'invite de connexion. Cela est tres utile lors de connexions avec l'option --init-string. --nohints Ne pas afficher de conseils sur le verrouillage numerique ou majuscules ni sur l'arret de defilement. --nohostname By default the hostname will be printed. With this option enabled, no hostname at all will be shown. This setting is also possible to able by LOGIN_PLAIN_PROMPT option in the /etc/login.defs configuration file (see below for more details). --long-hostname Par defaut, le nom d'hote n'est affiche que jusqu'au premier point. En activant cette option, le nom d'hote pleinement qualifie par gethostname(3P), ou (si non trouve) par getaddrinfo(3), est montre. --erase-chars chaine Cette option indique des caracteres supplementaires a interpreter comme une espace arriere (<< ignorer le caractere precedent >>) lorsque l'utilisateur saisit l'identifiant de connexion. Le caractere supplementaire d'<< effacement >> par defaut etait << # >>, mais depuis util-linux 2.23, aucun caractere supplementaire d'effacement n'est active par defaut. --kill-chars chaine Cette option indique des caracteres supplementaires a interpreter pour tuer (<< ignorer tous les caracteres precedents >>) lorsque l'utilisateur saisit l'identifiant de connexion. Le caractere supplementaire << pour tuer >> par defaut etait << @ >>, mais depuis util-linux 2.23, aucun caractere supplementaire pour tuer n'est active par defaut. --chdir repertoire Changer de repertoire avant la connexion. --delay nombre Temps de sommeil, en seconde, avant d'ouvrir le tty. --nice nombre Executer la connexion avec cette priorite. --reload Ask all running agetty instances to reload and update their displayed prompts, if the user has not yet commenced logging in. After doing so the command will exit. This feature might be unsupported on systems without Linux inotify(7). -h, --help Afficher l'aide-memoire puis quitter. -V, --version Afficher la version et quitter. ELEMENTS DU FICHIER DE CONFIGURATION agetty reads the /etc/login.defs configuration file (see login.defs(5)). Note that the configuration file could be distributed with another package (usually shadow-utils). The following configuration items are relevant for agetty: LOGIN_PLAIN_PROMPT (booleen) Tell agetty that printing the hostname should be suppressed in the login: prompt. This is an alternative to the --nohostname command line option. The default value is no. EXEMPLE Cette section presente des exemples pour le champ processus d'une entree dans le fichier /etc/inittab. Vous devrez faire preceder les autres champs par les valeurs appropriees. Consultez inittab(5) pour plus de precisions. Pour une ligne cablee ou une console tty : /sbin/agetty 9600 ttyS1 Pour un terminal connecte directement sans cablage avec signal << detection de porteuse >>. Utilisez ceci si le terminal se met en veille au lieu de demander un mot de passe : /sbin/agetty --local-line 9600 ttyS1 vt100 Pour une ligne avec un vieux modem acceptant les vitesses de 9600, 2400 et 1200 bauds : /sbin/agetty --extract-baud --timeout 60 ttyS1 9600,2400,1200 Pour un modem Hayes avec une vitesse fixe de 115\ 200 bauds (la chaine d'initialisation de l'exemple desactive l'echo du modem et les codes de retour, fait que le signal DCD du modem/ordinateur suive le signal DCD du modem distant, fait que la disparition du signal DTR provoque une deconnexion et active l'autoreponse apres une sonnerie) : /sbin/agetty --wait-cr --init-string 'ATE0Q1&D2&C1S0=1\015' 115200 ttyS1 AVIS DE SECURITE If you use the --login-program and --login-options options, be aware that a malicious user may try to enter lognames with embedded options, which then get passed to the used login program. agetty does check for a leading "-" and makes sure the logname gets passed as one parameter (so embedded spaces will not create yet another parameter), but depending on how the login binary parses the command line that might not be sufficient. Check that the used login program cannot be abused this way. Certains programmes utilisent -- pour indiquer que la suite de la ligne de commande ne devrait pas etre interpretee en tant qu'options. Utilisez cette fonctionnalite si elle est disponible en passant << -- >> avant que le nom d'utilisateur ne soit passe par \u. FICHIERS ISSUE Le fichier issue par defaut est /etc/issue. Si le fichier existe, alors agetty recherche aussi pour un repertoire /etc/issue.d. Le repertoire est une extension facultative au fichier issue par defaut et le contenu du repertoire est ecrit apres le contenu de /etc/issue. Si /etc/issue n'existe pas, alors le repertoire est ignore. Tous les fichiers avec une extension .issue du repertoire sont ecrits tries selon les versions. Le repertoire peut etre utilise pour gerer independamment les messages de parties tierces dans le fichier principal /etc/issue du systeme. Since version 2.35, additional locations for the issue file and directory are supported. agetty checks for the files /run/issue and /run/issue.d, and then for /usr/lib/issue and /usr/lib/issue.d. The directory /etc is expected for host-specific configuration, /run is expected for generated content, and /usr/lib is used for static configuration maintained by the distribution. Note that in versions 2.35 to 2.40, the additional locations were only read if the default /etc/issue file did not exist. However, since version 2.41, the additional locations are always read, regardless of the existence of the /etc/issue file. This change allows for the generation of issue files by default. The default paths maybe completely overridden by --issue-file option. In this case specified path has to be file or directory and all the default issue file and directory locations are ignored. La fonctionnalite du fichier issue peut etre desactivee completement avec l'option --noissue. Il est possible d'examiner le fichier issue en cours avec agetty --show-issue sur le terminal en cours. Les fichiers issue peuvent contenir certains codes d'echappement afin d'afficher le nom du systeme, la date, l'heure, etc. Tous les codes d'echappement sont formes d'une barre oblique inversee (\) immediatement suivie par l'une des caracteres suivants. 4 ou 4{interface} Insert the IPv4 address of the specified network interface (for example: \4{eth0}). If the interface argument is not specified, then select the first fully configured (UP, non-LOCALBACK, RUNNING) interface. If no configured interface is found, fall back to the IP address of the machine's hostname. 6 ou 6{interface} Comme \4, mais pour l'IPv6. b Inserer la vitesse en baud de la ligne actuelle. d Inserer la date actuelle. e ou e{nom} Transformer le nom lisible avec une sequence d'echappement et l'inserer (par exemple, \e{red}Alert text.\e{reset}). Si l'argument nom n'est pas indique, alors inserer \033. Les noms actuellement geres sont black, blink, blue, bold, brown, cyan, darkgray, gray, green, halfbright, lightblue, lightcyan, lightgray, lightgreen, lightmagenta, lightred, magenta, red, reset, reverse, yellow et white. Tous les noms inconnus sont ignores silencieusement. s Inserer le nom du systeme (le nom du systeme d'exploitation). Identique a uname -s. Consultez egalement le code d'echappement \S. S ou S{VARIABLE} Inserer la donnee VARIABLE de /etc/os-release. Si le fichier n'existe pas, /usr/lib/os-release est alors utilise. Si l'argument VARIABLE n'est pas indique, alors utiliser PRETTY_NAME du fichier ou le nom du systeme (consultez \s). Ce code d'echappement permet de garder les /etc/issue de la distribution et de la publication independants. Remarquez que \S{ANSI_COLOR} est convertie en sequence reelle d'echappement du terminal. l Inserer le nom de la ligne tty actuelle. m Inserer l'identifiant de l'architecture de la machine. Identique a uname -m. n Inserer le nom de noeud de la machine, aussi appele nom d'hote. Identique a uname -n. o Inserer le nom de domaine NIS de la machine. Identique a hostname -d. O Inserer le nom de domaine DNS de la machine. r Inserer le numero de version du systeme d'exploitation. Identique a uname -r. t Inserer l'heure actuelle. u Inserer le nombre d'utilisateurs actuellement connectes. U Inserer la chaine << 1 utilisateur >> ou << utilisateurs >> ou est le nombre d'utilisateurs actuellement connectes. v Inserer la version du systeme d'exploitation, par exemple sa date de construction, etc. Par exemple, si le fichier /etc/issue contient : Voici \n.\o (\s \m \r) \t il pourrait afficher : Voici thingol.orcan.dk (Linux i386 1.1.9) 18:29:30 FICHIERS /var/run/utmp fichier d'etat du systeme /etc/issue affichage avant l'invite de connexion /etc/os-release /usr/lib/os-release donnees d'identification du systeme d'exploitation /dev/console rapports de probleme (si syslog(3) n'est pas utilisee) /etc/inittab init(8) configuration file for SysV-style init daemon. CREDENTIALS agetty supports configuration via systemd credentials (see ). agetty reads the following systemd credentials: agetty.autologin (string) If set, configures agetty to automatically log in the specified user without asking for a username or password, similarly to the --autologin option. BOGUES La detection de la vitesse de connexion (l'option --extract-baud) necessite que agetty soit execute des le debut de l'appel reseau (dans les 30 ms pour un modem communiquant a 2400 bauds). Pour etre robuste, utilisez toujours l'option --extract-baud avec comme argument de ligne de commande differentes vitesses, ainsi le traitement de BREAK est active. Le texte du fichier /etc/issue (ou d'un autre fichier) et l'invite de connexion sont toujours affiches avec des caracteres 7 bits et la parite 0. La fonctionnalite de detection de la vitesse (l'option --extract-baud) necessite que le modem envoie son message d'etat apres avoir mis a un etat haut la ligne DCD. DIAGNOSTICS Suivant la facon dont le programme a ete configure, tous les diagnostics sont diriges vers le peripherique de console ou signales par le service syslog(3). Des messages d'erreur sont produits si le parametre port ne precise pas un peripherique de terminal, s'il n'y a pas d'entree utmp pour le processus actuel (Systeme V uniquement), etc. AUTEURS Werner Fink , Karel Zak L'agetty d'origine pour les terminaux serie a ete ecrit par W.Z. Venema et porte pour Linux par Peter Orbaek . SIGNALER DES BOGUES Pour signaler un bogue, utilisez le gestionnaire de bogues . DISPONIBILITE La commande agetty fait partie du paquet util-linux, elle est disponible sur l'archive du noyau Linux . util-linux 2.41 2025-03-29 AGETTY(8)