HOSTNAMECTL(1)

BEZEICHNUNG
hostnamectl - Steuert den Rechnernamen des Systems

ÜBERSICHT

hostnamectl [OPTIONEN…] {BEFEHL}

BESCHREIBUNG

hostnamectl kann zur Abfrage und Änderung des Rechnernamens des Systems und zugehöriger Einstellungen verwandt werden.

systemd-hostnamed.service(8) und dieses Werkzeug unterscheiden drei verschiedene Rechnernamen: den hochrangigen »schönen« Rechnernamen, der alle Arten von besonderen Zeichen enthalten darf (z.B. »Lennarts Laptop«), den »statischen« Rechnernamen, der der benutzerkonfigurierte Rechnername ist (z.B. »lennarts-laptop«) und den flüchtigen Rechnernamen, der ein aus der Netzwerkkonfiguration empfangener Rückfallwert ist (z.B. »node12345678«). Falls ein statischer Rechnername auf einen gültigen Wert gesetzt wird, dann wird der flüchtige Rechnername nicht verwandt.

Beachten Sie, dass der schöne Rechnername wenige Einschränkungen bezüglich der verwandten Zeichen und Länge hat, während der statische und der flüchtige Rechnername auf die normalerweise in Internet-Domain-Namen verwandten Zeichen und eine maximalen Länge von 64 Zeichen (Letzteres ist eine Linux-Beschränkung) beschränkt ist.

Verwenden Sie systemd-firstboot(1), um den Systemrechnernamen für eingehängte (aber nicht gestartete) Systemabbilder zu initialisieren.

BEFEHLE

Die folgenden Befehle werden verstanden:

status
    Zeigt den Systemrechnernamen und zugehörige Informationen. Falls kein Befehl angegeben ist, ist dies die implizite Vorgabe.

    Hinzugefügt in Version 195.

hostname [NAME]
    Falls kein Argument angegeben ist, wird der Rechnername ausgegeben. Falls ein optionales Argument NAME bereitgestellt wird, dann ändert der Befehl den Rechnernamen des Systems auf NAME. Standardmäßig wird dies den schönen, den statischen und den flüchtigen Rechnernamen gleichermaßen ändern, wird allerdings einer oder mehrere aus --static, --transient, --pretty verwandt, werden nur die ausgewählten Rechnernamen verwandt. Falls der schöne Rechnername gesetzt wird, und auch der statische und flüchtige, wird der angegebene Rechnername im Hinblick auf den verwandten Zeichensatz vereinfacht, bevor letztere aktualisiert werden. Dies erfolgt durch Entfernung von Sonder- und Leerzeichen. Dies stellt sicher, dass der schöne und der statische Rechnernamen stets eng miteinander verbunden sind und gleichzeitig den Gültigkeitsregeln des bestimmten Namens gefolgt wird. Diese Vereinfachung der Rechnernamenzeichenkette erfolgt nicht, falls nur der flüchtige und/oder statische Rechnername gesetzt werden und der schöne Rechnername unverändert bleibt.

    Der statische und flüchtige Rechnername muss jeweils ein freistehender DNS-Wert (eine Zeichenkette, die aus 7-Bit-ASCII-Zeichen in Kleinschreibung ohne Leerzeichen und Punkte besteht und auf das für DNS-Domainnamen-Kennzeichner erlaubte Format beschränkt ist) oder eine Abfolge von solchen Werten, getrennt durch einzelne Punkte, die einen gültigen DNS-FQDN bilden, sein. Der Rechnername darf maximal 64 Zeichen lang sein, da dies die Linux-Begrenzung ist (DNS erlaubt längere Namen).

    Falls das Fragezeichen »?« in dem Rechnernamen auftaucht, wird es automatisch durch ein hexadezimales Zeichen ersetzt, das bei der Anwendung aus machine-id(5) sicher und deterministisch durch kryptographisches Hashing abgeleitet wird. Beispiel: »foobar-????-????« wird automatisch zu »foobar-92a9-061c« oder ähnlich expandiert, abhängig von der lokalen Maschinenkennung.

    Hinzugefügt in Version 249.

icon-name [NAME]
    Falls kein Argument angegeben ist, wird der Icon-Name des Systems ausgegeben. Falls ein optionales Argument NAME bereitgestellt wird, dann ändert der Befehl den Icon-Name auf NAME. Der Icon-Name wird von einigen graphischen Anwendungen zur Visualisierung des Rechners verwandt. Der Icon-Name sollte der Icon-Namensspezifikation[1] folgen.

    Hinzugefügt in Version 249.

chassis [TYP]
    Falls kein Argument angegeben ist, wird die Bauform ausgegeben. Falls ein optionales Argument Typ bereitgestellt wird, dann ändert der Befehl die Bauform auf TYP. Die Bauform wird von einigen graphischen Anwendungen zur Visualisierung des Rechners oder zur Veränderung der Benutzerinteraktion verwandt. Derzeit sind die folgenden Bauformen definiert: »desktop«, »laptop«, »convertible«, »server«, »tablet«, »handset«, »watch«, »embedded«, sowie die besonderen Bauformen »vm« und »container« für virtualisierte Systeme, die keiner physisches Bauform direkt zugeordnet werden können.

    Hinzugefügt in Version 249.

deployment [UMGEBUNG]
    Falls kein Argument angegeben ist, wird die Einsatzumgebungsbeschreibung ausgegeben. Falls ein optionales Argument UMGEBUNG bereitgestellt wird, dann ändert der Befehl die Einsatzumgebungsbeschreibung auf UMGEBUNG. Das Argument UMGEBUNG muss ein einzelnes Wort ohne Steuerzeichen sein. Es wird eines der Folgenden empfohlen: »development«, »integration«, »staging«, »production«.

    Hinzugefügt in Version 249.

location [STANDORT]
    Falls kein Argument angegeben ist, wird die Standortzeichenkette des Systems ausgegeben. Falls ein optionales Argument STANDORT bereitgestellt wird, dann ändert der Befehl die Standortzeichenkette für das System auf STANDORT. Das Argument STANDORT sollte eine menschenlesbare, formlose Zeichenkette sein, die den physischen Standort des Systems beschreibt, falls dieser bekannt und zutreffend ist. Das kann so generisch wie »Berlin, Deutschland« oder so spezifisch wie »Linkes Regal, 2. Ebene« sein.

    Hinzugefügt in Version 249.

OPTIONEN

Die folgenden Optionen werden verstanden:

--static, --transient, --pretty
    Falls status aufgerufen wird (oder kein expliziter Befehl angegeben wird) und einer dieser Schalter angegeben ist, wird hostnamectl einfach diesen ausgewählten Rechnernamen ausgeben.

    Wird er mit hostname verwandt, werden nur die ausgewählten Rechnernamen aktualisiert. Wird mehr als einer dieser Schalter angegeben, werden alle angegebenen Rechnernamen aktualisiert.

    Hinzugefügt in Version 195.

-H, --host=
    Führt die Aktion aus der Ferne aus. Geben Sie den Rechnernamen oder einen Benutzernamen und Rechnernamen (getrennt durch »@«) an, zu dem verbunden werden soll. Dem Rechnernamen darf optional ein Port, auf dem SSH auf Anfragen wartet, getrennt durch »:« und dann ein Container-Name, abgetrennt durch »/«, folgen, womit direkt zu einem bestimmten Container auf dem angegebenen Rechner verbunden wird. Dies verwendet SSH, um mit der Maschinen-Verwalterinstanz auf dem Rechner in der Ferne zu kommunizieren. Container-Namen dürfen mit machinectl -H RECHNER aufgezählt werden. Setzen Sie IPv6-Adressen in Klammern.

-M, --machine=
    Führt die Aktion in einem lokalen Container aus. Geben Sie den Namen des Containers an, zu dem verbunden werden soll. Optional kann diesem ein Benutzername, abgetrennt durch ein »@«-Zeichen, als der verbunden werden soll, vorangestellt werden. Falls die besondere Zeichenkette ».host« anstelle des Container-Names verwandt wird, wird eine Verbindung zu dem lokalen System aufgebaut (das ist nützlich, um sich zu dem Benutzerbus eines bestimmten Benutzers zu verbinden: »--user --machine=lennart@.host«. Falls die »@«-Syntax nicht verwandt wird, wird die Verbindung als Benutzer »root« vorgenommen. Falls die »@«-Syntax verwandt wird, kann entweder die linke oder die rechte Seite fortgelassen werden (aber nicht beide). In diesem Fall wird der lokale Benutzername und ».host« angenommen.

--no-ask-password
    Befragt den Benutzer nicht für Authentifizierung für privilegierte Aktionen.

-h, --help
    Zeigt einen kurzen Hilfetext an und beendet das Programm.

--version
    Zeigt eine kurze Versionszeichenkette an und beendet das Programm.

--json=MODUS
    Zeigt die Ausgabe als JSON formatiert. Erwartet entweder »short« (für die kürzest mögliche Ausgabe ohne unnötigen Leerraum oder Zeilenumbrüche), »pretty« (für eine schönere Version der gleichen Ausgabe, mit Einzügen und Zeilenumbrüchen) oder »off« (um die JSON-Ausgabe auszuschalten, was die Vorgabe ist).

-j
    Äquivalent zu --json=pretty bei der Ausführung in einem Terminal, ansonsten --json=short.

EXIT-STATUS

Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich Null.

SIEHE AUCH

systemd(1), hostname(1), hostname(5), machine-info(5), systemctl(1), systemd-hostnamed.service(8), systemd-firstboot(1)

ANMERKUNGEN

1.  Icon-Benennungsspezifikation
    https://specifications.freedesktop.org/icon-naming/latest

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.