LOCALECTL(1)

NOM
localectl – Contrôler les paramètres régionaux du système et la configuration du clavier

SYNOPSIS

localectl [OPTIONS...] {COMMANDE}

DESCRIPTION

localectl peut être utilisé pour interroger et changer les paramètres régionaux du système et les réglages de la configuration du clavier. Cette commande communique avec systemd-localed(8) pour modifier des fichiers tels que /etc/locale.conf et /etc/vconsole.conf.

Les paramètres régionaux du système contrôlent la langue des services du système et de l'interface utilisateur avant que l'utilisateur ne se connecte, comme le gestionnaire d'affichage et les paramètres par défaut des utilisateurs après la connexion.

Les réglages du clavier contrôlent la configuration du clavier utilisée sur la console texte et l'interface utilisateur graphique avant la connexion de l'utilisateur, comme le gestionnaire d'affichage et les paramètres par défaut pour les utilisateurs après la connexion.

Notez que les changements induits par l'usage de cet outil nécessitent la reconstruction de l'initrd pour prendre effet lors du début de l'amorçage du système. L'initrd n'est pas reconstruite automatiquement par localectl, cette tâche doit être effectuée manuellement, généralement en réinstallant le paquet du noyau de la distribution.

Notez que vous pouvez utiliser systemd-firstboot(1) pour initialiser les paramètres régionaux du système pour les images système montées (mais non amorcées).

COMMANDES

Les commandes suivantes sont acceptées :

status
    Afficher les réglages actuels du clavier et des paramètres régionaux du système. Si aucune commande n'est indiquée, il s'agit de la commande par défaut.

    Ajouté dans la version 195.

set-locale LOCALE, set-locale VARIABLE=LOCALE...
    Définir les paramètres régionaux du système. Cette commande accepte un paramètre régional tel que « fr_FR.UTF-8 » ou une ou plusieurs affectations de paramètres régionaux tels que « LANG=de_DE.utf8 », « LC_MESSAGES=en_GB.utf8 », etc. Si un paramètre régional sans nom de variable est fourni, « LANG= » sera défini. Consultez locale(7) pour les détails sur les réglages disponibles et leurs significations. Utiliser list-locales pour obtenir une liste des paramètres régionaux disponibles (voir ci-dessous).

    Ajouté dans la version 195.

list-locales
    Lister les paramètres régionaux utiles pour la configuration avec set-locale.

    Ajouté dans la version 195.

set-keymap MAP [TOGGLEMAP]
    Définir le mappage du clavier du système pour la console et X11. Accepte un nom de mappage (tel que « de » ou « fr »), et si possible un second pour définir un mappage du clavier alternatif. À moins que --no-convert ne soit passé, le réglage sélectionné est aussi appliqué comme défaut pour le mappage du clavier de X11, après l'avoir converti au plus proche mappage du clavier de X11 correspondant. Utiliser list-keymaps pour obtenir une liste des mappages de clavier disponibles (voir ci-dessous).

    Ajouté dans la version 195.

list-keymaps
    Lister les mappages de clavier disponibles pour la console, utile pour la configuration avec set-keymap.

    Ajouté dans la version 195.

set-x11-keymap LAYOUT [MODÈLE [VARIANTE [OPTIONS]]]
    Définir le mappage par défaut du clavier pour X11 et la console virtuelle. Accepte un nom de mappage clavier (tel que « de » ou « fr »), et si possible un modèle, une variante et des options, consultez kbd(4) pour plus de détails. À moins que --no-convert ne soit passé, le réglage sélectionné est aussi appliqué au mappage du clavier de la console du système, après l'avoir converti au mappage le plus proche du clavier de la console correspondant.

    Ajouté dans la version 195.

list-x11-keymap-models, list-x11-keymap-layouts, list-x11-keymap-variants [LAYOUT], list-x11-keymap-options
    Lister les modèles, les dispositions, les variantes et les options de clavier X11, utile pour la configuration avec set-keymap. La commande list-x11-keymaps-variants accepte en option un paramètre de disposition pour limiter la sortie aux variantes disponibles pour la disposition spécifiée.

    Ajouté dans la version 201.

OPTIONS

Les options suivantes sont comprises :

-l, --full
    Ne pas réduire la taille de la sortie.

    Ajouté dans la version 257.

--no-convert
    Si set-keymap ou set-x11-keymap est invoqué et si cette option est passée, la configuration du clavier ne sera pas convertie de la console à X11 ou de X11 à la console, respectivement.

    Ajouté dans la version 195.

-H, --host=
    Effectuer l'opération à distance. Indiquer un nom d'hôte, ou un nom d'utilisateur et un nom d'hôte séparés par un « @ », auquel se connecter. Le nom d'hôte peut, de façon optionnelle, être suffixé par un port sur lequel ssh écoute, séparé par un « : », puis le nom d'un conteneur, séparé par un « / », ce qui connecte alors directement à un conteneur donné sur l'hôte spécifié. SSH sera utilisé pour dialoguer avec l’instance du gestionnaire de la machine distante. Les noms de conteneur peuvent être énumérés avec machinectl -H HÔTE. Mettre les adresses IPv6 entre crochets.

-M, --machine=
    Effectuer l'opération dans un conteneur local. Préciser le nom d'un conteneur auquel se connecter, optionnellement préfixé par le nom d'utilisateur sous lequel se connecter et un caractère de séparation « @ ». Si la chaîne spéciale « .host » est utilisée à la place du nom du conteneur, une connexion au système local est effectuée (ce qui est utile pour se connecter au bus utilisateur d'un utilisateur particulier : « --user --machine=lennart@.host »). Si la syntaxe « @ » n'est pas utilisée, la connexion est réalisée en tant que superutilisateur. Si la syntaxe « @ » est utilisée, le côté gauche ou le côté droit peuvent être omis (mais pas les deux à la fois), auquel cas le nom de l'utilisateur local et « .host » sont implicites.

--no-ask-password
    Ne pas demander à l'utilisateur de s'authentifier pour les opérations requérant des privilèges.

-h, --help
    Afficher un aide-mémoire succinct et quitter.

--version
    Afficher une information de version courte et quitter.

--no-pager
    Ne pas rediriger (pipe) la sortie vers un afficheur (pager).

CODE DE RETOUR

En cas de succès, 0 est renvoyé, autrement, un code d'échec différent de zéro est renvoyé.

ENVIRONNEMENT

$SYSTEMD_LOG_LEVEL
    Le niveau maximal de journalisation de messages émis (messages avec un niveau de journalisation supérieur, c'est-à-dire les moins importants seront supprimés). Cette variable prend une liste de valeurs séparées par des virgules. Une valeur peut être (par ordre d'importance décroissante) emerg, alert, crit, err, warning, notice, info, debug ou un entier dans l’intervalle 0...7. Consultez syslog(3) pour davantage d'informations. Chaque valeur peut être optionnellement préfixée avec console, syslog, kmsg ou journal suivi d'un deux-points (:) pour définir le niveau de journalisation maximal pour la cible spécifique de journal (par exemple SYSTEMD_LOG_LEVEL=debug,console:info indique de journaliser au niveau debug excepté pour la journalisation vers la console qui doit s'effectuer au niveau info). Notez que le niveau maximal de journalisation globale est prioritaire sur tout niveau maximal de journalisation par cible.

$SYSTEMD_LOG_COLOR
    Un booléen. Si la valeur est vrai, les messages écrits sur le terminal seront colorés selon la priorité.

    Ce réglage est utile uniquement quand les messages sont écrits directement dans un terminal ou un fichier parce que journalctl(1) et d'autres outils qui affichent des journaux coloreront par eux-mêmes les messages selon le niveau de journalisation.

$SYSTEMD_LOG_TIME
    Un booléen. Si la valeur est vrai, les messages du journal de la console seront préfixés d'un horodatage.

    Ce réglage est utile uniquement quand les messages sont écrits directement dans un terminal ou un fichier parce que journalctl(1) et d'autres outils qui affichent des journaux attacheront par eux-mêmes un horodatage selon les métadonnées de l'entrée.

$SYSTEMD_LOG_LOCATION
    Un booléen. Si la valeur est vrai, les messages seront préfixés par un nom de fichier et du numéro de ligne du code source d'où vient le message.

    Notez que l'emplacement du journal est souvent attaché comme métadonnée aux entrées du journal de toute façon. L'inclure directement dans le texte du message peut néanmoins être opportun lors du débogage de programmes.

$SYSTEMD_LOG_TID
    Un booléen. Si la valeur est vrai, les messages seront préfixés par l'identifiant numérique du thread actuel (TID).

    Notez que cette information est attachée comme métadonnée aux entrées du journal de toute façon. L'inclure directement dans le texte du message peut néanmoins être opportun lors du débogage de programmes.

$SYSTEMD_LOG_TARGET
    Destination pour journaliser les messages. Une des destinations parmi console (journaliser dans le terminal attaché), console-prefixed (journaliser dans le terminal attaché, mais avec des préfixes qui codent le niveau et le « service » de journalisation, consultez syslog(3)), kmsg (journaliser dans le tampon de journalisation circulaire du noyau), journal (journaliser dans le journal), journal-or-kmsg (journaliser dans le journal s'il est disponible et sinon dans kmsg), auto (déterminer automatiquement la cible appropriée de journalisation, c'est la destination par défaut), null (désactive la sortie de journalisation).

$SYSTEMD_LOG_RATELIMIT_KMSG
    Que ce soit pour le taux de requête kmsg ou pas. Prend un booléen. Par défaut « true ». Si désactivé, systemd ne limitera pas le taux des messages écrits à kmsg.

$SYSTEMD_PAGER, $PAGER
    Afficheur à utiliser lorsque --no-pager n'est pas précisé. $SYSTEMD_PAGER est utilisé s'il est défini ; autrement, $PAGERest utilisé. Si ni $SYSTEMD_PAGER, ni $PAGER n'ont de valeur, un ensemble d’afficheurs bien connus sont essayés à tour de rôle, incluant less(1) et more(1), jusqu'à ce qu'il y en ait un qui soit trouvé. Si aucun afficheur n'est trouvé, aucun afficheur n'est appelé. Définir ces variables d'environnement à une chaîne vide ou à « cat » est équivalent à l'utilisation de --no-pager.

    Remarque : si $SYSTEMD_PAGERSECURE n'est pas défini, $SYSTEMD_PAGER et $PAGER ne peuvent être utilisés que pour désactiver l'afficheur (avec « cat » ou « "" ») et autrement seront ignorés.

$SYSTEMD_LESS
    Outrepasser les options passées à less (par défaut « FRSXMK »).

    Les utilisateurs voudront peut-être changer deux options en particulier :

    K
        Cette option ordonne à l’afficheur de quitter immédiatement lorsque Ctrl+C est entré. Pour permettre à less de gérer Ctrl+C lui-même le retour à l'invite de commande de l’afficheur, ne pas fournir cette option.

        Si la valeur de $SYSTEMD_LESS n'inclut pas « K » et si l’afficheur appelé est less, Ctrl+C sera ignoré par l'exécutable et doit être géré par l’afficheur.

    X
        Cette option ordonne à l’afficheur de ne pas envoyer les chaînes d'initialisation et de désinitialisation de termcap au terminal. C'est le choix par défaut afin de permettre aux sorties des commandes de rester visibles dans le terminal même après que l’afficheur soit fermé. Toutefois, cela empêche quelques fonctionnalités de l’afficheur de fonctionner, en particulier, il n'est pas possible de faire défiler les sorties affichées avec la souris.

    Notez que le réglage de la variable d'environnement $LESS normale n'a aucun effet sur les invocations de less par les outils de systemd.

    Voir less(1) pour plus de détails.

$SYSTEMD_LESSCHARSET
    Outrepasser le jeu de caractères passé à less (par défaut « utf-8 », si le terminal invoqué est compatible avec l'UTF-8).

    Notez que le réglage de la variable d'environnement $LESSCHARSET normale n'a aucun effet sur les invocations de less par les outils de systemd.

$SYSTEMD_PAGERSECURE
    Les commandes d'afficheur courantes comme less(1), en plus de « l'affichage », c'est-à-dire le défilement de la sortie, prennent en charge l'ouverture et l'écriture d'autres fichiers et l'exécution de commandes d'interpréteur arbitraires. Quand les commandes sont invoquées avec des privilèges élevés, par exemple sous sudo(8) ou pkexec(1), l'afficheur devient une limite de sécurité. Il convient de veiller à ce que seuls des programmes avec des fonctionnalités strictement limitées soient utilisés comme afficheurs et que les fonctionnalités comme l'ouverture ou la création de nouveaux fichiers ou le démarrage de sous-processus ne soient pas autorisées. Un « mode sécurisé » pour l'afficher peut être activé comme décrit ci-dessous, si l'afficheur le prend en charge (la plupart des afficheurs ne sont pas écrits de façon à prendre cela en considération). Il est recommandé soit d'activer explicitement le « mode sécurisé » soit de désactiver complètement l'afficheur en utilisant --no-pager ou PAGER=cat lorsque des utilisateurs non fiables sont autorisés à exécuter des commandes avec des privilèges élevés.

    Cette option prend un argument booléen. Lorsqu'elle est définie à vrai, le « mode sécurisé » de l'afficheur est activé. En « mode sécurisé », LESSSECURE=1 est défini lors de l'invocation de l'afficheur, ce qui lui indique de désactiver les commandes qui ouvrent ou créent des fichiers, ou qui démarrent un nouveau sous-processus. Actuellement, seul less(5) est connu pour comprendre cette variable et implémenter le « mode sécurisé ».

    Quand l'option est définie à faux, aucune limitation n'est imposée à l'afficheur. Définir SYSTEMD_PAGERSECURE=0 ou ne pas le supprimer de l'environnement hérité peut permettre à l'utilisateur d'invoquer des commandes arbitraires.

    Quand $SYSTEMD_PAGERSECURE n'est pas défini, les outils de systemd tentent de déterminer automatiquement si le « mode sécurisé » doit être activé et si l'afficheur le prend en charge. Le « mode sécurisé » est activé si l'UID effectif est différent de celui du propriétaire de la session de connexion (voir geteuid(2)) et sd_pid_get_owner_uid(3)) ou lors de l'exécution sous sudo(8) ou des outils similaires ($SUDO_UID est défini à [1]). Dans ces cas, SYSTEMD_PAGERSECURE=1 sera défini et les afficheurs qui ne sont pas connus pour implémenter le « mode sécurisé » ne seront pas du tout utilisés. Notez que cette détection automatique ne couvre que les mécanismes les plus courants d'élévation des privilèges et qu'elle est conçue pour faciliter la tâche. Il est recommandé de définir explicitement $SYSTEMD_PAGERSECURE ou de désactiver l'afficheur.

    Notez que si les variables $SYSTEMD_PAGER ou $PAGER doivent être respectées, sauf pour désactiver l'afficheur, $SYSTEMD_PAGERSECURE doit aussi être défini.

$SYSTEMD_COLORS
    Takes a boolean argument, or a special value. By default (unset), systemd and related utilities will use colors in their output if possible. If $COLORTERM is set to "truecolor" or "24bit", 24-bit colors will be enabled, 256 colors otherwise, unless $NO_COLOR or $TERM indicates colors are disabled.

    true
        Same as unset, except that $NO_COLOR is ignored.

    false
        The output will be monochrome.

    "16", "256", "24bit"
        Always use the base 16 ANSI colors, 256 colors, or 24 bit color, respectively.

    "auto-16", "auto-256", "auto-24bit"
        Use the given quantity of colours, subject to $TERM, and what the console is connected to.

$SYSTEMD_URLIFY
    La valeur doit être un booléen. Contrôle si les liens cliquables doivent être générés dans la sortie pour des émulateurs de terminaux le prenant en charge. Cela peut être indiqué pour passer outre la décision faite par systemd basée sur $TERM et d'autres conditions.

VOIR AUSSI

systemd(1), locale(7), locale.conf(5), vconsole.conf(5), loadkeys(1), kbd(4), The XKB Configuration Guide[2], systemctl(1), systemd-localed.service(8), systemd-firstboot(1)

NOTES

1.  Il est recommandé pour les autres outils de définir et vérifier $SUDO_UID comme il convient, en le considérant comme une interface courante.

2.  Le guide de configuration d’XKB
    http://www.x.org/releases/current/doc/xorg-docs/input/XKB-Config.html

TRADUCTION
La traduction française de cette page de manuel a été créée par bubu <bubub@no-log.org>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.