HOSTNAMECTL(1) hostnamectl HOSTNAMECTL(1) NOM hostnamectl - Controler le nom d'hote du systeme SYNOPSIS hostnamectl [OPTIONS...] {COMMANDE} DESCRIPTION hostnamectl peut etre utilise pour rechercher et changer le nom d'hote du systeme et les reglages connexes. systemd-hostnamed.service(8) et cet outil distinguent trois noms d'hote differents : le nom d'hote << agreable >> de haut niveau qui peut inclure toutes sortes de caracteres speciaux (par exemple, << Portable de Lennart >>), le nom d'hote << statique >> qui est le nom d'hote configure par l'utilisateur (par exemple, << portable-lennart >>) et le nom d'hote transitoire qui est une valeur de secours recue de la configuration du reseau (par exemple, << noeud12345678 >>). Si un nom d'hote statique est defini a une valeur valable, le nom transitoire n'est pas utilise. Notez que le nom d'hote agreable a de petites restrictions sur les caracteres et la longueur a utiliser, alors que les noms d'hote statique et transitoire sont limites aux caracteres habituellement acceptes par les noms de domaine d'Internet et a 64 caracteres au maximum (cette derniere restriction etant une limite de Linux). Utilisez systemd-firstboot(1) pour initialiser le nom d'hote du systeme pour les images de systeme montees (mais pas amorcees). COMMANDES Les commandes suivantes sont acceptees : status Afficher le nom d'hote du systeme et les informations connexes. C'est la commande par defaut si aucune n'est specifiee. Ajoute dans la version 195. hostname [NOM] Si aucun argument n'est donne, afficher le nom d'hote du systeme. Si un argument optionnel NOM est fourni, alors la commande change le nom d'hote du systeme en NOM. Par defaut, cette commande va modifier les noms d'hote agreable, statique et transitoire de la meme facon ; neanmoins, si une ou plus d'options --static, --transient ou --pretty sont utilisees, seuls les noms d'hote selectionnes seront changes. Si le nom d'hote agreable est defini, ainsi que les noms d'hote transitoire et statique, le nom d'hote specifie sera simplifie selon le jeu de caracteres utilise avant que les derniers soient mis a jour. Cela est effectue en supprimant les caracteres speciaux et les espaces. Cela assure que les noms d'hote agreable et statique sont toujours relativement proches tout en suivant les regles valables pour le nom specifique. La simplification du nom d'hote n'est pas effectuee si seuls les noms d'hote transitoire et/ou statique sont definis, et le nom d'hote agreable reste inchange. Les noms d'hote transitoire et statique doivent etre soit une seule etiquette DNS (une chaine composee de caracteres ASCII en minuscule de 7 bits sans espace ni point, limitee au format autorise pour les etiquettes de nom de domaine DNS), ou une sequence de telles etiquettes separees par des points pour former un nom de domaine pleinement qualifie valable. Le nom d'hote doit etre de 64 caracteres au maximum, ce qui est une limitation de Linux (DNS autorise des noms plus longs). Ajoute dans la version 249. icon-name [NOM] Si aucun argument n'est donne, afficher le nom d'icone du systeme. Si un argument optionnel NOM est fourni, la commande change le nom d'icone en NOM. Le nom d'icone est utilise par quelques applications graphiques pour visualiser cet hote. Le nom d'icone doit se conformer a la Icon Naming Specification[1]. Ajoute dans la version 249. chassis [TYPE] Si aucun argument n'est donne, afficher le type du chassis. Si un argument optionnel TYPE est fourni, la commande change le type du chassis en TYPE. Le type du chassis est utilise par quelques applications graphiques pour visualiser l'hote ou changer l'interaction avec l'utilisateur. Actuellement, les types de chassis suivants sont definis : << desktop >>, << laptop >>, << convertible >>, << server >>, << tablet >>, << handset >>, << watch >>, << embedded >>, ainsi que les types de chassis speciaux << vm >> et << container >> pour les systemes virtualises qui n'ont pas de chassis physique proche. Ajoute dans la version 249. deployment [ENVIRONNEMENT] Si aucun argument n'est donne, afficher l'environnement de deploiement. Si un argument optionnel ENVIRONNEMENT est fourni, la commande change l'environnement de deploiement en ENVIRONNEMENT. L'argument ENVIRONNEMENT doit etre un mot unique sans aucun caractere de controle. Il est suggere d'utiliser l'un des suivants : << development >>, << integration >>, << staging >>, << production >>. Ajoute dans la version 249. location [EMPLACEMENT] Si aucun argument n'est fourni, afficher la chaine d'emplacement du systeme. Si un argument optionnel EMPLACEMENT est fourni, la commande change la chaine d'emplacement du systeme en EMPLACEMENT. L'argument EMPLACEMENT doit etre convivial, une chaine de forme libre decrivant l'emplacement physique du systeme s'il est connu et applicable. Cette chaine peut etre aussi generique que << Berlin, Allemagne >> ou aussi specifique que << Rack de gauche, 2eme etagere >>. Ajoute dans la version 249. OPTIONS Les options suivantes sont comprises : --static, --transient, --pretty Si status est invoque (ou qu'aucune commande explicite n'est donnee) et que l'un de ces commutateurs est indique, hostnamectl n'affichera que le nom d'hote selectionne. Lorsque utilise avec hostname, seul les noms d'hote selectionnes seront mis a jour. Lorsque plus d'un de ces commutateurs sont specifies, tous les noms d'hote indiques sont mis a jour. Ajoute dans la version 195. -H, --host= Effectuer l'operation a distance. Indiquer un nom d'hote, ou un nom d'utilisateur et un nom d'hote separes par un << @ >>, auquel se connecter. Le nom d'hote peut, de facon optionnelle, etre suffixe par un port sur lequel ssh ecoute, separe par un << : >>, puis le nom d'un conteneur, separe par un << / >>, ce qui connecte alors directement a un conteneur donne sur l'hote specifie. SSH sera utilise pour dialoguer avec l'instance du gestionnaire de la machine distante. Les noms de conteneur peuvent etre enumeres avec machinectl -H HOTE. Mettre les adresses IPv6 entre crochets. -M, --machine= Effectuer l'operation dans un conteneur local. Preciser le nom d'un conteneur auquel se connecter, optionnellement prefixe par le nom d'utilisateur sous lequel se connecter et un caractere de separation << @ >>. Si la chaine speciale << .host >> est utilisee a la place du nom du conteneur, une connexion au systeme local se produit (ce qui est utile pour se connecter au bus utilisateur d'un utilisateur particulier : << --user --machine=lennart@.host >>). Si la syntaxe << @ >> n'est pas utilisee, la connexion est realisee en tant que superutilisateur. Si la syntaxe << @ >> est utilisee, le cote gauche ou le cote droit peuvent etre omis (mais pas les deux a la fois), auquel cas le nom de l'utilisateur local et << .host >> sont implicites. --no-ask-password Ne pas demander a l'utilisateur de s'authentifier pour les operations requerant des privileges. -h, --help Afficher un aide-memoire succinct et quitter. --version Afficher une information de version courte et quitter. --json=MODE Afficher la sortie formatee en JSON. Le mode attendu est << short >> (pour la sortie la plus concise possible sans redondance d'espace ou de saut de ligne), << pretty >> (pour une plus jolie version de la meme chose avec indentation et sauts de ligne) ou << off >> (pour desactiver la sortie JSON, comportement par defaut). -j Equivalent a --json=pretty lorsque lance sur un terminal et a --json=short autrement. CODE DE RETOUR En cas de succes, 0 est renvoye, autrement, un code d'echec different de zero est renvoye. VOIR AUSSI systemd(1), hostname(1), hostname(5), machine-info(5), systemctl(1), systemd-hostnamed.service(8), systemd-firstboot(1) NOTES 1. Specification pour les noms d'icone https://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html TRADUCTION La traduction francaise de cette page de manuel a ete creee par bubu Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . systemd 257.3 HOSTNAMECTL(1)