table of contents
- trixie 4.27.0-1
- trixie-backports 4.32.4-1~bpo13+1
- testing 4.32.4-1
- unstable 4.32.4-1
| HOSTNAMECTL(1) | hostnamectl | HOSTNAMECTL(1) |
NOM¶
hostnamectl – Contrôler le nom d'hôte du système
SYNOPSIS¶
hostnamectl [OPTIONS...] {COMMANDE}
DESCRIPTION¶
hostnamectl peut être utilisé pour rechercher et changer le nom d'hôte du système et les réglages connexes.
systemd-hostnamed.service(8) et cet outil distinguent trois noms d'hôte différents : le nom d'hôte « agréable » de haut niveau qui peut inclure toutes sortes de caractères spéciaux (par exemple, « Portable de Lennart »), le nom d'hôte « statique » qui est le nom d'hôte configuré par l’utilisateur (par exemple, « portable-lennart ») et le nom d'hôte transitoire qui est une valeur de secours reçue de la configuration du réseau (par exemple, « nœud12345678 »). Si un nom d'hôte statique est défini à une valeur valable, le nom transitoire n'est pas utilisé.
Notez que le nom d'hôte agréable a de petites restrictions sur les caractères et la longueur à utiliser, alors que les noms d'hôte statique et transitoire sont limités aux caractères habituellement acceptés par les noms de domaine d’Internet et à 64 caractères au maximum (cette dernière restriction étant une limite de Linux).
Utilisez systemd-firstboot(1) pour initialiser le nom d'hôte du système pour les images de système montées (mais pas amorcées).
COMMANDES¶
Les commandes suivantes sont acceptées :
status
Ajouté dans la version 195.
hostname [NOM]
Les noms d'hôte transitoire et statique doivent être soit une seule étiquette DNS (une chaîne composée de caractères ASCII en minuscule de 7 bits sans espace ni point, limitée au format autorisé pour les étiquettes de nom de domaine DNS), ou une séquence de telles étiquettes séparées par des points pour former un nom de domaine pleinement qualifié valable. Le nom d'hôte doit être de 64 caractères au maximum, ce qui est une limitation de Linux (DNS autorise des noms plus longs).
Si le point d'interrogation « ? » apparaît dans le nom de l'hôte, il est automatiquement remplacé par un caractère hexadécimal dérivé de machine-id(5) lorsqu'il est appliqué, à partir d'un hachage de chiffrement sécurisé et déterministe. Par exemple : « foobar-????-???? » deviendra automatiquement « foobar-92a9-061c\[u00A0]» ou équivalent, selon l'ID de la machine locale.
Ajouté dans la version 249.
icon-name [NOM]
Ajouté dans la version 249.
chassis [TYPE]
Ajouté dans la version 249.
deployment [ENVIRONNEMENT]
Ajouté dans la version 249.
location [EMPLACEMENT]
Ajouté dans la version 249.
tags [TAG...]
Alternatively, each argument may be prefixed with "+" or "-" to incrementally update the configured tags rather than replacing them: an argument prefixed with "+" adds all of its (colon-separated) tags to the list, one prefixed with "-" removes them. For example, hostnamectl tags +foo:bar -quux:ooo adds the tags "foo" and "bar" and removes "quux" and "ooo". The prefix applies to the whole argument, i.e. to every tag listed within it. Prefixed and unprefixed arguments may not be combined in a single invocation.
Machine tags are short labels that may be used to classify and group machines for management purposes, for example to identify the role a machine plays in a deployment, the fleet or organizational unit it belongs to, or any other administrator-defined attribute. Each individual tag must be 1...255 characters long and consist only of ASCII alphanumeric characters, "-", "." and "=". A tag may optionally be parameterized with a value, in the form "key=value", in which case the same key may not be assigned more than one distinct value. The tags are stored in the TAGS= field of /etc/machine-info; see machine-info(5) for details. They may also be matched against with the ConditionMachineTag=/AssertMachineTag= unit settings, see systemd.unit(5).
Ajouté dans la version 261.
OPTIONS¶
Les options suivantes sont comprises :
--static, --transient, --pretty
This selection does not apply to JSON output: with --json=, status always prints the full status object.
Lorsque utilisé avec hostname, seul les noms d'hôte sélectionnés seront mis à jour. Lorsque plus d'un de ces commutateurs sont spécifiés, tous les noms d'hôte indiqués sont mis à jour.
Ajouté dans la version 195.
-H, --host=
-M, --machine=
--no-ask-password
-h, --help
--version
--json=MODE
-j
CODE DE RETOUR¶
En cas de succès, 0 est renvoyé, autrement, un code d'échec différent de zéro est renvoyé.
VOIR AUSSI¶
systemd(1), hostname(1), hostname(5), machine-info(5), systemctl(1), systemd-hostnamed.service(8), systemd-firstboot(1)
NOTES¶
- 1.
- Spécification pour les noms d'icône
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 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.
| systemd 262.1 |