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

Hinzugefügt in Version 195.

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.

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.

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.

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.

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.

Falls kein Argument angegeben ist, werden die derzeit konfigurierten Maschinenmerkmale in einer Doppelpunkt-getrennten Liste ausgegeben. Falls eine oder mehrere Argumente MARKIERUNG bereitgestellt werden, dann ersetzt der Befehl die konfigurierten Markierungen durch die angegebenen. Jedes Argument kann selbst wieder eine Doppelpunkt-getrennte Liste von Markierungen sein, so dass die Markierungen entweder als mehrere Argumente angegeben werden können oder als einzelnes, durch Doppelpunkt-getrenntes Argument oder als Kombination von beiden. Doppelte Markierungen werden entfernt und die enstehende Liste wird vor dem Speichern sortiert. Um alle Markierungen zu entfernen, rufen Sie den Befehl mit der leeren Zeichenkette als einziges Argument auf.

Alternativ kann jedem Argument »+« oder »-« vorangestellt werden, um die konfigurierten Markierungen inkrementell zu aktualisieren, anstatt sie zu ersetzen: ein Argument, dem »+« vorangestellt ist, fügt alle seiner (Doppelpunkt-getrennten) Markierungen zu der Liste hinzu, bei vorangestelltem »-« werden sie entfernt. Beispielsweise fügt hostnamectl tags +foo:bar -quux:ooo die Markierungen »foo« und »bar« hinzu und entfernt »quux« und »ooo«. Das vorangestellte Zeichen gilt für das gesamte Argument, d.h. für jede darin aufgeführe Markierung. Agumente mit und ohne Präfix können in einem einzelnen Aufruf nicht kombiniert werden.

Maschinenmarkierungen sind kurze Kennzeichnungen, die zur Klassifizierung und Gruppierung aus Verwaltungssicht verwandt werden können, beispielsweise um die Rolle einer Maschine in einem Einsatzszenario, die Zugehörigkeit zu einer Flotte oder Organisationseinheit oder jedes andere, Administratoren-definierte Attribut zu kennzeichnen. Jede individuelle Markierung muss 1…255 Zeichen lang sein und darf nur aus alphanumerischen ASCII-Zeichen, »-«, ».« und »=« bestehen. Eine Markierung kann optional mit einem Wert in der Form »Schlüssel=Wert« parametrisiert werden. In diesem Fall darf dem Schlüssel nicht mehr als ein unterschiedlicher Wert zugewiesen werden. Die Markierungen werden im Feld TAGS= von /etc/machine-info gespeichert; lesen Sie machine-info(5) zu Details. Sie können auch mit den Einstellungen ConditionMachineTag=/AssertMachineTag= verglichen werden, siehe systemd.unit(5).

Hinzugefügt in Version 261.

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

Diese Auswahl gilt für JSON-Ausgabe nicht: mit --json= gibt status immer das vollständige Statusobjekt aus.

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.

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.

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.

Befragt den Benutzer nicht für Authentifizierung für privilegierte Aktionen.

Zeigt einen kurzen Hilfetext an und beendet das Programm.

Zeigt eine kurze Versionszeichenkette an und beendet das Programm.

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).

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