xset - utilitaire de préférences utilisateur pour X
SYNOPSIS
xset [-display display]
[-b] [b {on|off}] [b [volume [pitch [duration]]]]
[-bc] [bc]
[-c] [c {on|off}] [c [volume]]
[+dpms] [-dpms]
[dpms standby [ suspend [ off]]]
[dpms force {standby|suspend|off|on}]
[fp=pathlist] [-fp=pathlist] [+fp=pathlist] [fp-pathlist] [fp+pathlist]
[fp default] [fp rehash]
[-led [integer|named indicator]] [led [integer|named indicator]]
[led {on|off}]
[mouse [accel_mult[/accel_div] [threshold]]] [mouse default]
[p pixel color]
[-r [keycode]] [r [keycode]] [r {on|off}] [r rate delay [rate]]
[s [length [period]]] [s {blank|noblank}]
[s {expose|noexpose}] [s {on|off}] [s default] [s activate] [s reset]
[q]
[-version]
DESCRIPTION
Ce programme est utilisé pour définir diverses options de préférences utilisateur de l'écran.
OPTIONS
-display display
Cette option spécifie le serveur à utiliser ; voir X(7).
b L'option b contrôle le volume, la hauteur et la durée de la sonnerie. Cette option accepte jusqu'à trois
paramètres numériques, un tiret (-) ou un indicateur « on/off ». Si aucun paramètre n'est
fourni ou si l'indicateur « on » est utilisé, les valeurs par défaut du système seront utilisées. Si le tiret ou l'indicateur « off » est donné, la sonnerie sera désactivée. Si un seul paramètre numérique est donné, le
volume de la sonnerie sera défini sur cette valeur, en pourcentage de sa valeur maximale. De même, le
deuxième paramètre numérique spécifie la hauteur de la sonnerie, en hertz, et le troisième paramètre
numérique spécifie la durée en millisecondes. Notez que tous les matériels ne peuvent pas faire varier
les caractéristiques de la sonnerie. Le serveur X définira les caractéristiques de la sonnerie le plus
précisément possible en fonction des spécifications de l'utilisateur.
bc L'option bc contrôle le mode de compatibilité des bogues dans le serveur, si possible ; un tiret (-) désactive le mode, sinon le mode est activé. Divers
clients pré-R4 transmettent des valeurs illégales dans certaines requêtes de protocole, et les serveurs pré-R4 ne généraient pas correctement d'erreurs dans ces cas. Ces clients, lorsqu'ils sont exécutés sur un serveur R4, se terminent anormalement ou ne fonctionnent pas correctement. Le mode de compatibilité des bogues réintroduit explicitement certains bogues dans le serveur X, de sorte que de nombreux de ces clients peuvent encore être exécutés.
Ce mode doit être utilisé avec prudence ; le nouveau développement d'applications doit être effectué avec ce mode désactivé. Le serveur doit prendre en charge l'extension de protocole MIT-SUNDRY-NONSTANDARD pour que cette option fonctionne.
c L'option c contrôle le clic de touche. Cette option peut prendre une valeur facultative, un tiret
ou un indicateur « on/off ». Si aucun paramètre ou l'indicateur « on » n'est donné, les valeurs par défaut du système seront utilisées. Si le tiret ou l'indicateur « off » est utilisé, le clic de touche sera désactivé. Si une
valeur comprise entre 0 et 100 est donnée, elle est utilisée pour indiquer le volume, en pourcentage du maximum. Le serveur X définira le volume sur la valeur la plus proche que le matériel peut prendre en charge.
-dpms L'option -dpms désactive les fonctions de gestion de l'alimentation de l'affichage (DPMS).
+dpms L'option +dpms active les fonctions de gestion de l'alimentation de l'affichage (DPMS).
dpms flags...
L'option dpms permet de définir les paramètres de gestion de l'alimentation de l'affichage (DPMS). L'option peut prendre jusqu'à trois valeurs numériques, ou le drapeau force suivi d'un état DPMS. Le drapeau force force le serveur à passer immédiatement à l'état DPMS spécifié. L'état DPMS peut être l'un des états suivants : standby, suspend, off ou on. Lorsque des valeurs numériques sont fournies, elles définissent la période d'inactivité (en secondes) avant que les trois modes ne soient activés. La première valeur donnée correspond au mode standby, la deuxième au mode suspend et la troisième au mode off. Définir ces valeurs active implicitement les fonctions DPMS. Une valeur de zéro désactive un mode particulier.
fp= path,...
L'option fp= définit le chemin de la police avec les entrées données dans l'argument path. Les entrées sont interprétées par le serveur, et non par le client. Il s'agit généralement de noms de répertoires ou de noms de serveurs de polices, mais l'interprétation dépend du serveur.
fp default
L'argument default permet de réinitialiser le chemin de la police à la valeur par défaut du serveur.
fp rehash
L'argument rehash réinitialise le chemin de la police à sa valeur actuelle, ce qui amène le serveur à relire les bases de données de polices dans le chemin de la police actuel. Ceci n'est généralement utilisé que lorsque de nouvelles polices sont ajoutées à un répertoire de polices (après avoir exécuté mkfontdir pour recréer la base de données de polices).
-fp ou fp-
Les options -fp et fp- suppriment des éléments du chemin de la police actuel. Elles doivent être suivies d'une liste d'entrées séparées par des virgules.
+fp ou fp+
Les options +fp et fp+ ajoutent des éléments au début et à la fin du chemin de la police actuel, respectivement. Elles doivent être suivies d'une liste d'entrées séparées par des virgules.
led L'option led contrôle les LED du clavier. Ceci permet de contrôler l'activation ou la désactivation d'une ou de toutes les LED. Elle accepte un entier facultatif, un tiret (-) ou un drapeau « on/off ». Si aucun paramètre ou le drapeau « on » n'est donné, toutes les LED sont activées. Si un tiret ou le drapeau « off » est donné, toutes les LED sont désactivées. Si une valeur comprise entre 1 et 32 est donnée, cette LED sera activée ou désactivée en fonction de la présence d'un tiret. « xset led 3 » activerait la LED n° 3. « xset -led 3 » la désactiverait. Les valeurs de LED peuvent faire référence à des LED différentes sur différents matériels. Si le serveur X prend en charge l'extension XKEYBOARD (XKB), les LED peuvent être référencées par le nom de l'indicateur XKB en spécifiant le mot-clé `named` et le nom de l'indicateur. Par exemple, pour activer la LED de verrouillage Maj :
xset led named "Scroll Lock"
mouse L'option m contrôle les paramètres de la souris ; elle peut être abrégée en 'm'. Bien sûr, elle s'applique à la plupart des périphériques de pointage, et pas seulement aux souris. Les paramètres du périphérique de pointage sont « accélération » et « seuil ». L'accélération peut être spécifiée en tant qu'entier ou en tant que fraction simple. Le seuil est simplement un entier. Le paramètre est appliqué à tous les périphériques de pointage connectés. xinput(1) doit être utilisé si vous avez besoin de paramètres spécifiques à chaque périphérique.
Par défaut, le pointeur (la représentation à l'écran du périphérique de pointage) se déplace « accélération » fois plus vite lorsque le périphérique se déplace de plus de « seuil » mickeys (c'est-à-dire, des pixels potentiels) en 10 ms, y compris une petite plage de transition. De cette façon, le périphérique de pointage peut être utilisé pour un alignement précis lorsqu'il est déplacé lentement, mais il peut également être réglé pour traverser l'écran d'un simple mouvement de poignet. Un ou les deux paramètres de l'option m peuvent être omis, mais si un seul est donné, il sera interprété comme l'accélération. Si aucun paramètre ou le drapeau « default » n'est utilisé, les paramètres par défaut du système seront appliqués.
Si le paramètre « seuil » est fourni et vaut 0, le paramètre « accélération » sera utilisé dans l'exposant d'une formule plus naturelle et continue, offrant un contrôle précis pour les mouvements lents mais une grande portée pour les mouvements rapides, et une transition progressive pour les mouvements intermédiaires. La valeur d'« accélération » recommandée dans ce cas est de 3/2 à 3, mais cela n'est pas limité à cette plage.
Dans le serveur X.org X Server 1.6 et versions ultérieures, le comportement décrit jusqu'à présent est lié au profil par défaut. Il existe d'autres profils (c'est-à-dire des fonctions déterminant l'accélération du pointeur en fonction de la vitesse du périphérique) et des paramètres supplémentaires, de sorte que la description ci-dessus peut ne pas s'appliquer aux cas non par défaut. Dans le serveur X.org 1.7, ceux-ci sont disponibles sous forme de propriétés du périphérique d'entrée (voir xinput).
p L'option p contrôle les valeurs de couleur des pixels. Les paramètres sont le numéro d'entrée de la table de couleurs en décimal, et une spécification de couleur. Les couleurs d'arrière-plan de la racine peuvent être modifiées sur certains serveurs en modifiant les entrées pour BlackPixel et WhitePixel. Bien que celles-ci soient souvent 0 et 1, elles ne le sont pas nécessairement. De plus, un serveur peut choisir d'allouer ces couleurs en privé, auquel cas une erreur sera générée. L'entrée de la table de couleurs ne doit pas être une couleur en lecture seule, sinon une erreur se produira.
r L'option r contrôle la répétition automatique. L'appel avec « -r » ou « r off » désactivera la répétition automatique, tandis que « r » ou « r on » l'activera. En suivant l'option « -r » ou « r » avec un code de touche entier compris entre 0 et 255, la répétition automatique sera désactivée ou activée pour cette touche, mais uniquement si cela a du sens pour le code de touche particulier. Les codes de touche inférieurs à 8 ne sont généralement pas valides pour cette commande. Exemple : « xset -r 10 » désactivera la répétition automatique pour la touche « 1 » sur la rangée supérieure d'un clavier IBM PC.
Si le serveur prend en charge l'extension XFree86-Misc ou l'extension XKB, alors un paramètre « rate » est accepté et doit être suivi de zéro, un ou deux nombres. Le premier spécifie le délai avant le début de la répétition automatique et le second spécifie la vitesse de répétition. Dans le cas où le serveur prend en charge l'extension XKB, le délai est le nombre de millisecondes avant le début de la répétition automatique, et la vitesse est le nombre de répétitions par seconde. Si la vitesse ou le délai n'est pas spécifié, il sera défini sur la valeur par défaut.
s L'option s permet de définir les paramètres de l'économiseur d'écran. Cette option accepte jusqu'à deux paramètres numériques, un indicateur « blank/noblank », un indicateur « expose/noexpose », un indicateur « on/off », un indicateur « activate/reset », ou l'indicateur « default ». Si aucun paramètre n'est spécifié ou si l'indicateur « default » est utilisé, le système sera réglé sur ses caractéristiques d'économiseur d'écran par défaut. Les indicateurs « on/off » permettent simplement d'activer ou de désactiver les fonctions d'économiseur d'écran. L'indicateur « activate » force l'activation de l'économiseur d'écran, même si celui-ci a été désactivé. L'indicateur « reset » force la désactivation de l'économiseur d'écran s'il est actif. L'indicateur « blank » définit la préférence pour masquer la vidéo (si le matériel le permet) plutôt que d'afficher un motif d'arrière-plan, tandis que « noblank » définit la préférence pour afficher un motif plutôt que de masquer la vidéo. L'indicateur « expose » définit la préférence pour autoriser les expositions de fenêtres (le serveur peut librement supprimer le contenu des fenêtres), tandis que « noexpose » définit la préférence pour désactiver l'économiseur d'écran, sauf si le serveur peut régénérer les écrans sans provoquer d'événements d'exposition. La durée et la période pour la fonction d'économiseur d'écran déterminent combien de temps le serveur doit être inactif avant que l'économiseur d'écran ne s'active, et la période pour changer le motif d'arrière-plan afin d'éviter l'effet de brûlure d'écran. Les arguments sont spécifiés en secondes. Si un seul paramètre numérique est spécifié, il sera utilisé pour la durée.
q L'option q fournit des informations sur les paramètres actuels.
-version
L'option -version affiche la version du programme et se termine sans effectuer d'autres actions.
Ces paramètres seront réinitialisés aux valeurs par défaut lorsque vous vous déconnecterez.
Notez que toutes les implémentations X ne sont pas garanties de prendre en charge toutes ces options.
VOIR AUSSI
X(7), Xserver(1), xmodmap(1), xrdb(1), xsetroot(1), xinput(1)
AUTEUR
Bob Scheifler, Laboratoire d'informatique du MIT David Krikorian, Projet Athena du MIT (version X11) Prise en charge de XFree86-Misc ajoutée par David Dawes et Joe Moss Mises à jour de la page de manuel ajoutées par Mike A. Harris <_>