'\" t
.\"     Title: setterm
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-04-27
.\"    Manual: Commandes de l'utilisateur
.\"    Source: util-linux 2.40
.\"  Language: English
.\"
.TH "SETTERM" "1" "2024-04-27" "util\-linux 2.40" "Commandes de l\*(Aqutilisateur"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NOM"
setterm \- Définir les attributs du terminal
.SH "SYNOPSIS"
.sp
\fBsetterm\fP [options]
.SH "DESCRIPTION"
.sp
\fBsetterm\fP writes to standard output a character string that will invoke the specified terminal capabilities. Where possible \fIterminfo\fP is consulted to find the string to use. Some options however (marked "virtual consoles only" below) do not correspond to a \fBterminfo\fP(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.
.SH "OPTIONS"
.sp
Pour les options booléennes (\fBon\fP ou \fBoff\fP), la valeur par défaut est \fBon\fP.
.sp
Ci\-dessous, une valeur \fI8_couleurs\fP peut être \fBblack\fP, \fBred\fP, \fBgreen\fP, \fByellow\fP, \fBblue\fP, \fBmagenta\fP, \fBcyan\fP ou \fBwhite\fP.
.sp
Une valeur \fI16\-couleurs\fP peut être une des valeurs \fI8\-couleurs\fP, ou \fBgrey\fP ou \fBbright\fP suivis de \fBred\fP, \fBgreen\fP, \fByellow\fP, \fBblue\fP, \fBmagenta\fP, \fBcyan\fP, or \fBwhite\fP.
.sp
Les différentes options de couleur peuvent être définies séparément, au moins sur les consoles virtuelles, bien que l\(cqeffet de la définition de plusieurs modes (par exemple, \fB\-\-underline\fP et \fB\-\-half\-bright\fP) dépend du matériel.
.sp
The optional arguments are recommended with \*(Aq=\*(Aq (equals sign) and not space between the option and the argument. For example \-\-option=argument. \fBsetterm\fP can interpret the next non\-option argument as an optional argument too.
.sp
\fB\-\-appcursorkeys\fP on|off
.RS 4
Activer ou désactiver le «\(rs Cursor Key Application Mode\(rs ». En mode actif (« \fBon\fP »), ESC O A, ESC O B, etc., seront envoyés à la place de ESC [ A, ESC [ B, etc. Les utilisateurs de \fBvi\fP se référeront à la section «\(rs vi and Cursor\-Keys\(rs » du \fIText\-Terminal\-HOWTO\fP (en anglais) pour connaître la raison des problèmes que cela peut poser. Consoles virtuelles uniquement.
.RE
.sp
\fB\-\-append\fP \fInuméro_console\fP
.RS 4
Identique à \fB\-\-dump\fP, mais ajoute au fichier d’instantané au lieu de l\(cqécraser. Ne fonctionne que si aucune option \fB\-\-dump\fP n’est donnée.
.RE
.sp
\fB\-\-background\fP \fIcouleurs\fP|default
.RS 4
Définir la couleur d\(cqarrière\-plan du texte.
.RE
.sp
\fB\-\-blank\fP[=0\-60|force|poke]
.RS 4
Définir l\(cqintervalle d\(cqinactivité, en minute, après lequel la console sera éteinte (en utilisant APM s\(cqil est disponible). Sans option, renvoyer l\(cqétat de la console (renvoyer la console qui a été éteinte ou zéro pour une console non éteinte). Consoles virtuelles uniquement.
.sp
Le paramètre \fBforce\fP laisse l\(cqécran vide même si une touche est pressée.
.sp
Le paramètre \fBpoke\fP réveille l\(cqécran.
.RE
.sp
\fB\-\-bfreq\fP[=\fInuméro\fP]
.RS 4
Définir la fréquence du bip en hertz. Sans paramètre, \fB0\fP est utilisé par défaut. Pour les consoles virtuelles uniquement.
.RE
.sp
\fB\-\-blength\fP[=0\-2000]
.RS 4
Définir la durée du bip en milliseconde. Sans paramètre, \fB0\fP est utilisé par défaut. Pour les consoles virtuelles uniquement.
.RE
.sp
\fB\-\-blink\fP on|off
.RS 4
Activer ou désactiver le mode clignotant. À part sur une console virtuelle, \fB\-\-blink off\fP désactive tous les attributs (gras, demi\-teinte, clignotant, inverse).
.RE
.sp
\fB\-\-bold\fP on|off
.RS 4
Activer ou désactiver le mode gras (surbrillance). À part sur une console virtuelle, \fB\-\-bold off\fP désactive tous les attributs (gras, demi\-luminosité, clignotant, inverse).
.RE
.sp
\fB\-\-clear\fP[=all|rest]
.RS 4
Sans argument, ou avec l’argument \fBall\fP, tout l’écran est nettoyé et le curseur est défini à la position d’origine, comme \fBclear\fP(1) le fait. Avec l’argument \fBrest\fP, l’écran est nettoyé à partir de la position actuelle du curseur jusqu’à la fin.
.RE
.sp
\fB\-\-clrtabs\fP[=\fItab1 tab2 tab3\fP ...]
.RS 4
Effacer les taquets de tabulation horizontale à partir des positions données du curseur, échelonnées de \fB1\fP à \fB160\fP. Sans paramètre, effacer tous les taquets de tabulation. Sur les consoles virtuelles uniquement.
.RE
.sp
\fB\-\-cursor\fP on|off
.RS 4
Activer ou désactiver le curseur.
.RE
.sp
\fB\-\-default\fP
.RS 4
Positionner les options de rendu du terminal à leurs valeurs par défaut.
.RE
.sp
\fB\-\-dump\fP[=\fInuméro_console\fP]
.RS 4
Écrire un instantané de la console virtuelle avec le numéro donné dans le fichier indiqué par l\(cqoption \fB\-\-file\fP, en écrasant son contenu ; par défaut, il s\(cqagit de \fIscreen.dump\fP. Sans option, vider la console virtuelle active. Cela remplace \fB\-\-append\fP.
.RE
.sp
\fB\-\-file\fP \fIfichier\fP
.RS 4
Définir le nom de \fIfichier\fP de l\(cqinstantané pour les options \fB\-\-dump\fP ou \fB\-\-append\fP sur une même ligne de commande. Si cette option n\(cqest pas présente, \fIscreen.dump\fP est écrit dans le répertoire actuel. Un nom de chemin qui dépasse le maximum du système sera tronqué, consultez \fBPATH_MAX\fP dans \fIlinux/limits.h\fP pour connaître sa valeur.
.RE
.sp
\fB\-\-foreground\fP \fIcouleurs\fP|default
.RS 4
Définir la couleur du texte.
.RE
.sp
\fB\-\-half\-bright\fP on|off
.RS 4
Activer ou désactiver le mode sombre (demi\-teinte). À part sur une console virtuelle, \fB\-\-half\-bright off\fP désactive tous les attributs (gras, demi\-teinte, clignotant, inverse).
.RE
.sp
\fB\-\-hbcolor\fP \fI16\-color\fP
.RS 4
Définir la couleur des caractères en demi\-teintes («\(rs half\-bright\(rs »).
.RE
.sp
\fB\-\-initialize\fP
.RS 4
Afficher la chaîne d\(cqinitialisation du terminal qui définit normalement aux valeurs par défaut les options de rendu du terminal et d\(cqautres attributs.
.RE
.sp
\fB\-\-inversescreen\fP on|off
.RS 4
Échanger les couleurs de premier plan et d’arrière\-plan sur tout l’écran.
.RE
.sp
\fB\-\-linewrap\fP on|off
.RS 4
Laisser le terminal continuer sur une nouvelle ligne quand une ligne est pleine.
.RE
.sp
\fB\-\-msg\fP on|off
.RS 4
Activer ou désactiver l\(cqaffichage de messages \fBprintk\fP() du noyau sur la console. Consoles virtuelles uniquement.
.RE
.sp
\fB\-\-msglevel\fP 0\-8
.RS 4
Définir le niveau de journalisation de la console pour les messages \fBprintk()\fP du noyau. Tous les messages de niveau strictement plus élevés seront affichés, de telle sorte qu\(cqun niveau \fB0\fP aura le même effet que \fB\-\-msg on\fP et qu\(cqun niveau \fB8\fP affichera tous les messages du noyau. \fBklogd\fP(8) peut être une interface plus appropriée pour la journalisation des messages du noyau.
.sp
Consoles virtuelles uniquement.
.RE
.sp
\fB\-\-powerdown\fP[=0\-60]
.RS 4
Définir le délai avant arrêt du moniteur VESA, en minute. Sans option, la valeur par défaut est \fB0\fP (désactiver l\(cqarrêt). Si la console est éteinte ou si le moniteur est en mode suspendu, le moniteur se placera alors respectivement en mode \fBvsync\fP ou en mode \fBpowerdown\fP après l\(cqécoulement de la période.
.RE
.sp
\fB\-\-powersave\fP \fImode\fP
.RS 4
Les valeurs autorisées de \fImode\fP sont :
.sp
\fBvsync|on\fP
.RS 4
Placer le moniteur en mode \fIvsync\fP de suspension VESA.
.RE
.sp
\fBhsync\fP
.RS 4
Placer le moniteur en mode hsync de suspension VESA.
.RE
.sp
\fBpowerdown\fP
.RS 4
Placer le moniteur en mode d’arrêt VESA.
.RE
.sp
\fBoff\fP
.RS 4
(Dés)activer les propriétés d\(cqéconomie d\(cqénergie du moniteur VESA.
.RE
.RE
.sp
\fB\-\-regtabs\fP[=1\-160]
.RS 4
Effacer tous les taquets de tabulation, puis définir un motif régulier de taquets de tabulation, avec une tabulation toutes les \fIx\fP positions. Sans argument, la valeur par défaut est \fB8\fP. Consoles virtuelles uniquement.
.RE
.sp
\fB\-\-repeat\fP on|off
.RS 4
Activer ou désactiver la répétition de touches du clavier. Consoles virtuelles uniquement.
.RE
.sp
\fB\-\-reset\fP
.RS 4
Afficher la chaîne de restauration du terminal, qui rétablit habituellement le terminal dans son état de démarrage.
.RE
.sp
\fB\-\-resize\fP
.RS 4
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 \fBioctl\fP(2) but just byte streams and breaks.
.RE
.sp
\fB\-\-reverse\fP on|off
.RS 4
Activer ou désactiver le mode vidéo inverse. À part sur une console virtuelle, \fB\-\-reverse off\fP désactive tous les attributs (gras, demi\-teinte, clignotant, inverse).
.RE
.sp
\fB\-\-store\fP
.RS 4
Conserver les options de rendu du terminal actif (couleurs de premier plan et d\(cqarrière\-plan) comme celles à utiliser lors d\(cqune restauration des valeurs par défaut. Consoles virtuelles uniquement.
.RE
.sp
\fB\-\-tabs\fP[=\fItab1 tab2 tab3\fP ...]
.RS 4
Placer des taquets de tabulation horizontale à des positions données du curseur, échelonnées de \fB1\fP à \fB160\fP. Sans paramètre, afficher les taquets de tabulation actuels.
.RE
.sp
\fB\-\-term\fP \fInom_terminal\fP
.RS 4
Remplacer la variable d\(cqenvironnement \fBTERM\fP.
.RE
.sp
\fB\-\-ulcolor\fP \fI16\-color\fP
.RS 4
Définir la couleur des caractères soulignés. Consoles virtuelles uniquement.
.RE
.sp
\fB\-\-underline\fP on|off
.RS 4
Activer ou désactiver le mode souligné.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afficher l’aide\-mémoire puis quitter.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afficher le numéro de version et quitter.
.RE
.SH "AVERTISSEMENT"
.sp
Use of \fBsetterm\fP 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.
.SH "COMPATIBILITÉ"
.sp
Depuis la version 2.25, \fBsetterm\fP prend en charge les options longues avec deux tirets, par exemple \fB\-\-help\fP, en plus des options longues historiques avec un seul tiret, par exemple \fB\-help\fP. 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.
.SH "BOGUES"
.sp
Les différences entre les versions MINIX et Linux ne sont pas documentées.
.SH "VOIR AUSSI"
.sp
\fBstty\fP(1),
\fBtput\fP(1),
\fBtty\fP(4),
\fBterminfo\fP(5)
.SH "SIGNALER DES BOGUES"
.sp
Pour signaler un bogue, utilisez le gestionnaire de bogues sur \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "DISPONIBILITÉ"
.sp
La commande \fBsetterm\fP fait partie du paquet util\-linux, elle est disponible sur \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "l’archive du noyau Linux" "."