NOM

       setterm - Définir les attributs du terminal

SYNOPSIS

       setterm [options]

DESCRIPTION

       setterm writes to standard output a character string that will invoke the specified
       terminal capabilities. Where possible terminfo is consulted to find the string to use.
       Some options however (marked "virtual consoles only" below) do not correspond to a
       terminfo(5) capability. In this case, if the terminal type is "con" or "linux" the string
       that invokes the specified capabilities on the PC Minix virtual console driver is output.
       Options that are not implemented by the terminal are ignored.

OPTIONS

       Pour les options booléennes (on ou off), la valeur par défaut est on.

       Ci-dessous, une valeur 8_couleurs peut être black, red, green, yellow, blue, magenta, cyan
       ou white.

       Une valeur 16-couleurs peut être une des valeurs 8-couleurs, ou grey ou bright suivis de
       red, green, yellow, blue, magenta, cyan, or white.

       Les différentes options de couleur peuvent être définies séparément, au moins sur les
       consoles virtuelles, bien que l’effet de la définition de plusieurs modes (par exemple,
       --underline et --half-bright) dépend du matériel.

       The optional arguments are recommended with '=' (equals sign) and not space between the
       option and the argument. For example --option=argument. setterm can interpret the next
       non-option argument as an optional argument too.

       --appcursorkeys on|off
           Activer ou désactiver le «\ Cursor Key Application Mode\ ». En mode actif (« on »),
           ESC O A, ESC O B, etc., seront envoyés à la place de ESC [ A, ESC [ B, etc. Les
           utilisateurs de vi se référeront à la section «\ vi and Cursor-Keys\ » du
           Text-Terminal-HOWTO (en anglais) pour connaître la raison des problèmes que cela peut
           poser. Consoles virtuelles uniquement.

       --append numéro_console
           Identique à --dump, mais ajoute au fichier d’instantané au lieu de l’écraser. Ne
           fonctionne que si aucune option --dump n’est donnée.

       --background couleurs|default
           Définir la couleur d’arrière-plan du texte.

       --blank[=0-60|force|poke]
           Définir l’intervalle d’inactivité, en minute, après lequel la console sera éteinte (en
           utilisant APM s’il est disponible). Sans option, renvoyer l’état de la console
           (renvoyer la console qui a été éteinte ou zéro pour une console non éteinte). Consoles
           virtuelles uniquement.

           Le paramètre force laisse l’écran vide même si une touche est pressée.

           Le paramètre poke réveille l’écran.

       --bfreq[=numéro]
           Définir la fréquence du bip en hertz. Sans paramètre, 0 est utilisé par défaut. Pour
           les consoles virtuelles uniquement.

       --blength[=0-2000]
           Définir la durée du bip en milliseconde. Sans paramètre, 0 est utilisé par défaut.
           Pour les consoles virtuelles uniquement.

       --blink on|off
           Activer ou désactiver le mode clignotant. À part sur une console virtuelle,
           --blink off désactive tous les attributs (gras, demi-teinte, clignotant, inverse).

       --bold on|off
           Activer ou désactiver le mode gras (surbrillance). À part sur une console virtuelle,
           --bold off désactive tous les attributs (gras, demi-luminosité, clignotant, inverse).

       --clear[=all|rest]
           Sans argument, ou avec l’argument all, tout l’écran est nettoyé et le curseur est
           défini à la position d’origine, comme clear(1) le fait. Avec l’argument rest, l’écran
           est nettoyé à partir de la position actuelle du curseur jusqu’à la fin.

       --clrtabs[=tab1 tab2 tab3 ...]
           Effacer les taquets de tabulation horizontale à partir des positions données du
           curseur, échelonnées de 1 à 160. Sans paramètre, effacer tous les taquets de
           tabulation. Sur les consoles virtuelles uniquement.

       --cursor on|off
           Activer ou désactiver le curseur.

       --default
           Positionner les options de rendu du terminal à leurs valeurs par défaut.

       --dump[=numéro_console]
           Écrire un instantané de la console virtuelle avec le numéro donné dans le fichier
           indiqué par l’option --file, en écrasant son contenu ; par défaut, il s’agit de
           screen.dump. Sans option, vider la console virtuelle active. Cela remplace --append.

       --file fichier
           Définir le nom de fichier de l’instantané pour les options --dump ou --append sur une
           même ligne de commande. Si cette option n’est pas présente, screen.dump est écrit dans
           le répertoire actuel. Un nom de chemin qui dépasse le maximum du système sera tronqué,
           consultez PATH_MAX dans linux/limits.h pour connaître sa valeur.

       --foreground couleurs|default
           Définir la couleur du texte.

       --half-bright on|off
           Activer ou désactiver le mode sombre (demi-teinte). À part sur une console virtuelle,
           --half-bright off désactive tous les attributs (gras, demi-teinte, clignotant,
           inverse).

       --hbcolor 16-color
           Définir la couleur des caractères en demi-teintes («\ half-bright\ »).

       --initialize
           Afficher la chaîne d’initialisation du terminal qui définit normalement aux valeurs
           par défaut les options de rendu du terminal et d’autres attributs.

       --inversescreen on|off
           Échanger les couleurs de premier plan et d’arrière-plan sur tout l’écran.

       --linewrap on|off
           Laisser le terminal continuer sur une nouvelle ligne quand une ligne est pleine.

       --msg on|off
           Activer ou désactiver l’affichage de messages printk() du noyau sur la console.
           Consoles virtuelles uniquement.

       --msglevel 0-8
           Définir le niveau de journalisation de la console pour les messages printk() du noyau.
           Tous les messages de niveau strictement plus élevés seront affichés, de telle sorte
           qu’un niveau 0 aura le même effet que --msg on et qu’un niveau 8 affichera tous les
           messages du noyau. klogd(8) peut être une interface plus appropriée pour la
           journalisation des messages du noyau.

           Consoles virtuelles uniquement.

       --powerdown[=0-60]
           Définir le délai avant arrêt du moniteur VESA, en minute. Sans option, la valeur par
           défaut est 0 (désactiver l’arrêt). Si la console est éteinte ou si le moniteur est en
           mode suspendu, le moniteur se placera alors respectivement en mode vsync ou en mode
           powerdown après l’écoulement de la période.

       --powersave mode
           Les valeurs autorisées de mode sont :

           vsync|on
               Placer le moniteur en mode vsync de suspension VESA.

           hsync
               Placer le moniteur en mode hsync de suspension VESA.

           powerdown
               Placer le moniteur en mode d’arrêt VESA.

           off
               (Dés)activer les propriétés d’économie d’énergie du moniteur VESA.

       --regtabs[=1-160]
           Effacer tous les taquets de tabulation, puis définir un motif régulier de taquets de
           tabulation, avec une tabulation toutes les x positions. Sans argument, la valeur par
           défaut est 8. Consoles virtuelles uniquement.

       --repeat on|off
           Activer ou désactiver la répétition de touches du clavier. Consoles virtuelles
           uniquement.

       --reset
           Afficher la chaîne de restauration du terminal, qui rétablit habituellement le
           terminal dans son état de démarrage.

       --resize
           Reset terminal size by assessing maximum row and column. This is useful when actual
           geometry and kernel terminal driver are not in sync. Most notable use case is with
           serial consoles, that do not use ioctl(2) but just byte streams and breaks.

       --reverse on|off
           Activer ou désactiver le mode vidéo inverse. À part sur une console virtuelle,
           --reverse off désactive tous les attributs (gras, demi-teinte, clignotant, inverse).

       --store
           Conserver les options de rendu du terminal actif (couleurs de premier plan et
           d’arrière-plan) comme celles à utiliser lors d’une restauration des valeurs par
           défaut. Consoles virtuelles uniquement.

       --tabs[=tab1 tab2 tab3 ...]
           Placer des taquets de tabulation horizontale à des positions données du curseur,
           échelonnées de 1 à 160. Sans paramètre, afficher les taquets de tabulation actuels.

       --term nom_terminal
           Remplacer la variable d’environnement TERM.

       --ulcolor 16-color
           Définir la couleur des caractères soulignés. Consoles virtuelles uniquement.

       --underline on|off
           Activer ou désactiver le mode souligné.

       -h, --help
           Afficher l’aide-mémoire puis quitter.

       -V, --version
           Afficher le numéro de version et quitter.

AVERTISSEMENT

       Use of setterm in combination with stdout redirection can have unexpected results, as some
       options operate on stdin. To prevent problems, always redirect both stdin and stdout to
       the same device.

COMPATIBILITÉ

       Depuis la version 2.25, setterm prend en charge les options longues avec deux tirets, par
       exemple --help, en plus des options longues historiques avec un seul tiret, par exemple
       -help. Dans les scripts, mieux vaut utiliser un seul tiret au lieu de deux pour être
       rétrocompatible. Actuellement, arrêter la compatibilité avec un seul tiret n’est pas
       prévu.

BOGUES

       Les différences entre les versions MINIX et Linux ne sont pas documentées.

VOIR AUSSI

       stty(1), tput(1), tty(4), terminfo(5)

SIGNALER DES BOGUES

       Pour signaler un bogue, utilisez le gestionnaire de bogues sur
       https://github.com/util-linux/util-linux/issues.

DISPONIBILITÉ

       La commande setterm fait partie du paquet util-linux, elle est disponible sur l’archive du
       noyau Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.