stty - Modifier et afficher la configuration de la ligne de terminal.

stty [configuration...]
stty {-a,--all,-f,--file,-g,--help,--save,--version}

Cette page de manuel documente la version GNU de stty.
Si aucun argument n'est fourni, stty affiche la vitesse de communication, le numéro de discipline de ligne (sur les systèmes le supportant) et les éléments de configuration modifiés par rapport aux valeurs fixées par `stty sane'.
La configuration en question est celle de la ligne tty connectée sur l'entrée standard.
stty accepte les arguments suivants, qui modifient le comportement de la ligne.
Un `[-]' devant un argument signifie que l'on peut l'inhiber en le faisant précéder d'un `-'. Certains arguments ne sont pas disponibles sur tous les systèmes, car il s'agit d'extensions non-POSIX. Ils sont indiqués par `(np)'.
Paramètres de contrôle :

[-]parenb

Transmet un bit de parité en sortie, et en attend un en entrée.

[-]parodd

Indique une parité impaire (paire si précédé de `-').

cs5 cs6 cs7 cs8

Indique une taille de caractère de 5, 6, 7, ou 8 bits.

[-]hupcl [-]hup

Envoie un signal de déconnexion (Hangup) lorsque le dernier processus referme la ligne tty.

[-]cstopb

Utilise deux bits d'arrêt par caractère (un seul avec `-').

[-]cread

Permet la réception de données.

[-]clocal

Désactive les signaux de contrôle propres aux modems.

[-]crtscts (np)

Active le contrôle de flux RTS/CTS.

Paramètres d'entrée:

[-]ignbrk

Ignorer les signaux breaks.

[-]brkint

Un break déclenche un signal d'interruption.

[-]ignpar

Ignorer les erreurs de parité.

[-]parmrk

Signaler les erreurs de parité par une séquence 255-0-caractère.

[-]inpck

Active la vérification de parité.

[-]istrip

Effacer le bit de poids fort (8ème) des caractères en entrée.

[-]inlcr

Traduire les Sauts-de-ligne (NewLine) en Retours-Chariots (Carriage Return).

[-]igncr

Ignorer les Retours-Chariot (Carriage Return).

[-]icrnl

Traduire les Retours-Chariots (Carriage Return) en Sauts-de-ligne (NewLine).

[-]ixon

Activer le contrôle de flux XON/XOFF.

[-]ixoff [-]tandem

Activer l'émission d'un caractère d'arrêt lorsque le buffer d'entrée est presque plein, et d'un caractère de redémarrage lorsqu'il est à nouveau vide

[-]iuclc (np)

Convertir les majuscules en minuscules.

[-]ixany (np)

Permet l'utilisation de n'importe quel caractère pour redémarrer la sortie (si l'on utilise `-', seul le caractère Start sera actif).

[-]imaxbel (np)

Valider l'émission d'un signal sonore lorsqu'un caractère arrive alors que le buffer d'entrée est plein, dans ce cas le buffer n'est pas purgé.

Paramètres de sortie :

[-]opost

Postprocess output ([NDT] ???).

[-]olcuc (np)

Traduire les minuscules en majuscules ([NDT] Ceci ne fonctionne pas avec les caractères accentués...)

[-]ocrnl (np)

Convertir les Retours-Chariot (Carriage Return) en Sauts-de-ligne (Newline).

[-]onlcr (np)

Convertir les Sauts-de-ligne (Newline) en Retours-Chariot (Carriage Return).

[-]onocr (np)

Ne pas afficher les Retours-Chariots en première colonne.

[-]onlret (np)

Ajouter un Retour-Chariot au Saut-de-ligne.

[-]ofill (np)

Utiliser des caractères de remplissage plutôt que des délais d'attente.

[-]ofdel (np)

Utiliser l'effacement (Delete) comme caractère de remplissage, à la place du caractère Null.

nl1 nl0 (np)

Type de délai pour le Saut-de-ligne.

cr3 cr2 cr1 cr0 (np)

Type de délai pour le Retour-chariot.

tab3 tab2 tab1 tab0 (np)

Type de délai pour la Tabulation horizontale.

bs1 bs0 (np)

Type de délai pour le Retour en arrière (BackSpace).

vt1 vt0 (np)

Type de délai pour la Tabulation verticale.

ff1 ff0 (np)

Type de délai pour le Saut-de-page (Form Feed).

Paramètres locaux :

[-]isig

Valider les caractères spéciaux Interrupt, Quit, et Suspend.

[-]icanon

Valider les caractères spéciaux Erase, Kill, Werase, et Rprnt.

[-]iexten

Valider les caractères spéciaux non-Posix.

[-]echo

Activer l'écho des caractères saisis.

[-]echoe, [-]crterase

Effectuer l'écho du caractère d'effacement sous forme BackSpace-Espace-BackSpace.

[-]echok

Ajouter l'écho d'un Saut-de-Ligne (NewLine) après le caractère Kill.

[-]echonl

Effectuer l'écho des Sauts-de-Ligne (NewLine) même si l'écho des autres caractères est désactive.

[-]noflsh

Désactiver la purge du buffer après les caractères spéciaux Interrupt et Quit.

[-]xcase (np)

Activer l'entrée et la sortie de caractères majuscules en faisant précéder leur équivalent minuscule par `\', si l'option ICANNON est active.

[-]tostop (np)

Arrêter les travaux en arrière-plan qui tentent d'écrire sur leur terminal.

[-]echoprt [-]prterase (np)

Effectuer l'écho des caractères effacés entre `\' et '/'.

[-]echoctl [-]ctlecho (np)

Afficher l'écho des caractères de contrôle avec la notation (`^c') plutôt que sous leur forme littérale.

[-]echoke [-]crtkill (np)

Effectuer l'écho du caractère spécial Kill en effaçant chaque caractère sur la ligne comme indiqué par les paramètres Echoprt et Echoe, à la place des paramètres Echoctl et Echok.

Paramètres combinés :

[-]evenp [-]parity

Identique à parenb -parodd cs7. Avec `-', identique à -parenb cs8.

[-]oddp

Identique à parenb parodd cs7. Avec `-', identique à -parenb cs8.

[-]nl

Identique à -icrnl -onlcr. Avec `-', identique à icrnl -inlcr -igncr onlcr -ocrnl -onlret.

ek

Réinitialise les caractères spéciaux Erase et Kill à leurs valeurs par défaut.

sane

Identique à cread -ignbrk brkint -inlcr -igncr icrnl -ixoff -iuclc -ixany imaxbel opost -olcuc -ocrnl onlcr -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0 vt0 ff0 isig icanon iexten echo echoe echok -echonl -noflsh -xcase -tostop -echoprt echoctl echoke. Réinitialise également tous les caractères de contrôle à leurs valeurs par défaut.

[-]cooked

Identique à brkint ignpar istrip icrnl ixon opost isig icanon. Réinitialise également les caractères Eof et Eol à leurs valeurs par défaut si ce sont les mêmes que les caractères Min et Time (voir plus bas). Avec `-', identique à raw.

[-]raw

Identique à -ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr -icrnl -ixon -ixoff -iuclc -ixany -imaxbel -opost -isig -icanon -xcase min 1 time 0. Avec `-', identique à cooked.

[-]cbreak

Identique à -icanon.

[-]pass8

Identique à -parenb -istrip cs8. avec `-', identique à parenb istrip cs7.

[-]litout

Identique à -parenb -istrip -opost cs8. Avec `-', Identique à parenb istrip opost cs7.

[-]decctlq (np)

Identique à -ixany.

[-]tabs (np)

Identique à tab0. Avec `-', identique à tab3.

[-]lcase [-]LCASE (np)

Identique à xcase iuclc olcuc.

crt

Identique à echoe echoctl echoke.

dec

Identique à echoe echoctl echoke -ixany. Configure également les caractères spéciaux Interrupt avec la valeur Ctrl-C, Erase avec Del, et Kill avec Ctrl-U.

Caractères spéciaux :

Les valeurs par défaut des caractères spéciaux varient suivant les systèmes. Ils sont configurés en utilisant la syntaxe `nom valeur'. Les noms sont indiqués ci-dessous, et les valeurs peuvent être fournies soit littéralement en utilisant la notation (`^c'), soit avec un entier commençant par `0x' pour une valeur hexadécimale, `0' pour une valeur octale, ou tout autre chiffre pour une valeur décimale. Indiquer la valeur `^-' ou `undef' permet de désactiver le caractère spécial.

intr

Envoie le signal Intr.

quit

Envoie le signal Quit.

erase

Efface le dernier caractère saisi.

kill

Efface la ligne en cours.

eof

Signale une fin de fichier (terminer la saisie).

eol

Fin de ligne.

eol2 (np)

Autre caractère pour terminer la ligne.

swtch (np)

Basculer à un autre niveau de shell.

start

Redémarrage de la sortie après un arrêt.

stop

Arrêt de la sortie.

susp

Émission d'un signal Terminal Stop

dsusp (np)

Émission d'un signal Terminal Stop après avoir vidé le buffer d'entrée.

rprnt (np)

Réafficher la ligne en cours.

werase (np)

Effacement du dernier mot saisi.

lnext (np)

Lire le caractère suivant littéralement, même s'il s'agit d'un caractère spécial.

Paramètres spéciaux :

min N

Lorsque -icanon est configuré, indique le nombre minimal de caractères à lire pendant la durée `time' avant que la lecture n'échoue.

time N

Lorsque -icanon est configuré, indique la durée (en dixièmes de secondes) pour lire `min' caractères avant que la lecture n'échoue.

ispeed N

Configure la vitesse d'entrée à la valeur N

ospeed N

Configure la vitesse de sortie à la valeur N

rows N (np)

Indique au noyau que le terminal dispose de N lignes.

cols N columns N (np)

Indique au noyau que le terminal dispose de N colonnes.

size (np)

Affiche le nombre de lignes et de colonnes dont dispose le terminal selon les informations fournies par le noyau. Les systèmes ne permettant pas la configuration de rows et cols dans le noyau utilisent généralement les variables d'environnement LINES et COLUMNS à la place. Toutefois, la version GNU de stty ne les utilise pas.

line N (np)

Utiliser la discipline de ligne N.

speed

Affiche la vitesse du terminal.

N

Fixe les vitesses d'entrée et de sortie à la valeur N. N peut prendre les valeurs suivantes : 0 50 75 110 134 134.5 150 200 300 600 1200 1800 2400 4800 9600 19200 38400 exta extb. exta est équivalent à 19200, extb a 38400. 0 raccroche la ligne si -clocal est configuré.

-a, --all

Afficher la configuration en cours de manière lisible par un humain.

--help

Afficher un message d'aide sur la sortie standard et se terminer normalement.

-g, --save

Afficher la configuration en cours de manière utilisable comme argument pour une autre commande stty qui restituera le même paramétrage.

-F, --file=FICHIER

Utiliser le périphérique représenté par le FICHIER spécial plutôt que l'entrée standard.

--version

Afficher un numéro de version sur la sortie standard et se terminer normalement.

Christophe Blaess, 1997-2003.