.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH IMPORTCTL 1 "" "systemd 260.2" importctl .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH BEZEICHNUNG importctl \- Plattenabbilder herunterladen, importieren oder exportieren .SH ÜBERSICHT .HP \w'\fBimportctl\fR\ 'u \fBimportctl\fP [\fIOPTIONEN\fP…] {\fIBEFEHL\fP} [\fINAME\fP…] .SH BESCHREIBUNG .PP \fBimportctl\fP kann zum herunterladen, importieren und exportieren von Plattenabbildern mittels \fBsystemd\-importd.service\fP(8) verwandt werden\&. .PP \fBimportctl\fP agiert sowohl auf Plattenabbildern auf Block\-Niveau (wie DDIs) auf Abbildern auf Dateisystem\-Ebene (Tarbälle) sowie auf OCI\-Abbildern\&. Es unterstützt Plattenabbilder aus einer der vier folgenden Klassen: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} VM\-Abbilder oder vollständige Betriebssystemabbilder, die mittels \fBsystemd\-vmspawn\fP(1) oder \fBsystemd\-nspawn\fP(1) ausgeführt und mittels \fBmachinectl\fP(1) verwaltet werden\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Portierbare Diensteabbilder, die angehängt und mittels \fBportablectl\fP(1) verwaltet werden\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Systemerweiterungs\- (Sysext\-)Abbilder, die mittels \fBsystemd\-sysext\fP(8) aktiviert werden\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Konfigurationserweiterungs\- (Confext\-)Abbilder, die mittels \fBsystemd\-confext\fP(8) aktiviert werden\&. .RE .PP Wenn Abbilder heruntergeladen oder importiert werden, werden sie in den folgenden Verzeichnissen abgelegt, abhängig von dem Parameter \fB\-\-class=\fP: .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br \fBTable\ \&1.\ \&Klassen und Verzeichnisse\fP .TS allbox tab(:); lB lB. T{ Klasse T}:T{ Verzeichnis T} .T& l l l l l l l l. T{ "machine" T}:T{ /var/lib/machines/ T} T{ "portable" T}:T{ /var/lib/portables/ T} T{ "sysext" T}:T{ /var/lib/extensions/ T} T{ "confext" T}:T{ /var/lib/confexts/ T} .TE .sp 1 .SH BEFEHLE .PP Die folgenden Befehle werden verstanden: .PP \fBpull\-tar\fP \fIURL\fP [\fINAME\fP] .RS 4 Lädt ein \&.tar\-Abbild von der angegebenen URL herunter und stellt sie unter dem angegebenen lokalen Namen im Abbildverzeichnis für die ausgewählte \fB\-\-class=\fP zur Verfügung\&. Die URL muss vom Typ »http://« oder »https://« sein und sich auf eine Archivdatei \&.tar, \&.tar\&.gz, \&.tar\&.xz oder \&.tar\&.bz2 beziehen\&. Falls der lokale Abbildname weggelassen wird, wird er automatisch aus der letzten Komponente der URL abgeleitet, wobei die Endung entfernt wird\&. .sp Das Abbild wird verifiziert, bevor es zur Verfügung gestellt wird, außer \fB\-\-verify=no\fP ist angegeben\&. Die Verifizierung erfolgt entweder über eine Datei mit dem Namen des Abbildes und der Endung \&.sha256 und abgetrennten Signatur \&.sha256\&.asc oder \&.sha256\&.gpg oder mittels getrennten Dateien SHA256SUMS und SHA256SUMS\&.asc oder SHA256SUMS\&.gpg\&. Die Signaturdateien müssen auf dem gleichen Web\-Server unter der gleichen URL wie die \&.tar\-Datei zur Verfügung gestellt werden\&. Mit \fB\-\-verify=checksum\fP wird nur die SHA256\-Prüfsumme der Datei verifiziert, basierend auf der Datei mit der Endung \&.sha256 oder der SHA256SUMS\-Datei\&. Mit \fB\-\-verify=signature\fP wird die SHA\-Prüfsummendatei zuerst mit der abgetrennten GPG\-Sigatur aus \&.sha256 oder SHA256SUMS verifiziert\&. Der öffentliche Schlüssel für diesen Verifikationsschritt muss unter /usr/lib/systemd/import\-pubring\&.pgp oder /etc/systemd/import\-pubring\&.pgp verfügbar sein\&. .sp Falls \fB\-keep\-download=yes\fP angegeben ist, wird das Abbild heruntergeladen und in einem schreibgeschützten Teildatenträger/Verzeichnis in dem Abbild\-Verzeichnis gespeichert, das nach der angegebenen URL und seinem HTTP\-ETag (siehe \m[blue]\fBHTTP ETag\fP\m[]\&\s-2\u[1]\d\s+2 für weitere Informationen) benannt ist\&. Dann wird ein schreibbarer Schnappschuss von diesem Teildatenträger genommen und nach dem angegebenen lokalen Namen benannt\&. Dieses Verhalten stellt sicher, dass die Erstellung mehrerer Instanzen der gleichen URL effizient erfolgt und kein mehrfaches Herunterladen notwendig ist\&. Um nur das schreibgeschützte Abbild zu erstellen und die Erstellung des schreibbaren Schnappschusses zu vermeiden, geben Sie »\-« als lokalen Namen an\&. .sp Beachten Sie, dass die Eingabe von Strg\-c während der Ausführung dieses Befehls das Herunterladen nicht abbricht\&. Verwenden Sie dafür das nachfolgend beschriebene \fBcancel\-transfer\fP\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fBpull\-raw\fP \fIURL\fP [\fINAME\fP] .RS 4 Lädt ein \&.raw\-Plattenabbild von der angegebenen URL herunter und stellt es unter dem angegebenen lokalen Namen im Abbildverzeichnis für die angegebe \fB\-\-class=\fP zur Verfügung\&. Die URL muss vom Typ »http://« oder »https://« sein\&. Das Abbild muss entweder ein Qcow2 oder ein rohes Plattenabbild sein, optional komprimiert als \&.gz, \&.xz oder \&.bz2\&. Falls der lokale Name weggelassen wird, wird er automatisch von der letzten Komponente der URL abgeleitet, wobei die Endung entfernt wird\&. .sp Abbildverifizierung ist für rohe und Tar\-Abbilder identisch (siehe oben)\&. .sp Falls das heruntergeladene Abbild im Format Qcow2 vorliegt, wird es in ein rohes Abbild konvertiert, bevor es zur Verfügung gestellt wird\&. .sp Falls \fB\-keep\-download=yes\fP angegeben wurde, wird das Abbild heruntergeladen und in einer schreibgeschützten Datei in dem Abbildverzeichnis gespeichert, das nach der angegebenen URL und ihrem HTTP\-ETag benannt ist\&. Eine schreibbare Kopie wird dann aus dieser Datei erstellt und nach dem angegebenen lokalen Namen benannt\&. Dieses Verhalten stellt sicher, dass die Erstellung mehrerer Instanzen der gleichen URL effizient erfolgt, da kein mehrfaches Herunterladen notwendig ist\&. Um nur das schreibgeschüzte Abbild zu erstellen und die Erstellung der schreibbaren Kopie zu vermeiden, geben Sie »\-« als lokalen Namen an\&. .sp Beachten Sie, dass die Eingabe von Strg\-c während der Ausführung dieses Befehls das Herunterladen nicht abbricht\&. Verwenden Sie dafür das nachfolgend beschriebene \fBcancel\-transfer\fP\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fBpull\-oci\fP \fIREF\fP [\fINAME\fP] .RS 4 Lädt das angegebene OCI\-Container\-Abbild herunter und stellt es unter dem angegebenen lokalen Namen im Abbildverzeichnis für die ausgewählte \fB\-\-class=\fP zur Verfügung\&. Das erste Argument muss eine OCI\-Container\-Referenz wie »library/nginx« sein\&. Falls der lokale Name weggelassen wird, wird er automatisch aus der letzten Komponente der URL abgeleitet, wobei die Endung entfernt wird\&. .sp Wenn Abbilder von diesem Typ heruntergeladen werden, erfolgt keine Abbildüberprüfung über die normale Authentifizierung des HTTPS\-Zertifikates hinaus. .sp Beachten Sie, dass die Eingabe von Strg\-c während der Ausführung dieses Befehls das Herunterladen nicht abbricht\&. Verwenden Sie dafür das nachfolgend beschriebene \fBcancel\-transfer\fP\&. .sp Hinzugefügt in Version 260\&. .RE .PP \fBimport\-tar\fP \fIDATEI\fP [\fINAME\fP], \fBimport\-raw\fP \fIDATEI\fP [\fINAME\fP] .RS 4 Importiert ein TAR\- oder RAW\-Abbild, und legt es unter dem angegebenen Namen in dem Abbildverzeichnis für die mittels \fB\-\-class=\fP gewählte Abbildklasse ab\&. Wird \fBimport\-tar\fP verwandt, sollte die als Datei angegebene Datei ein \fBtar\fP(1)\-Archiv sein, das möglicherweise mit \fBxz\fP(1), \fBgzip\fP(1), \fBzstd\fP(1) oder \fBbzip2\fP(1) komprimiert wurde\&. Es wird dann in seinen eigenen Teildatenträger/Unterverzeichnis entpackt\&. Wird \fBimport\-raw\fP verwandt, sollte die Datei ein Qcow2\- oder rohes Plattenabbild sein, das möglicherweise mit \fBxz\fP(1), \fBgzip\fP(1), \fBzstd\fP(1) oder \fBbzip2\fP(1) komprimiert wurde\&. Falls das zweite Argument (der sich ergebende Abbildname) nicht angegeben ist, wird er automatisch aus dem Dateinamen ermittelt\&. Falls der übergebene Dateiname »\-« ist, wird das Abbild aus der Standardeingabe gelesen; dann ist das zweite Argument verpflichtend\&. .sp Beim Import der Abbilder erfolgt keine kryptographische Validierung\&. .sp Ganz ähnlich wie beim Herunterladen von Abbildern, können laufende Importe mittels \fBlist\fP aufgeführt und mit \fBcancel\-transfer\fP abgebrochen werden\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fBimport\-fs\fP \fIVERZEICHNIS\fP [\fINAME\fP] .RS 4 Importiert ein in einem lokalen Verzeichnis gespeichertes Abbild in das Abbildverzeichnis für die mittels \fB\-\-class=\fP ausgewählte Abbildklasse und agiert ähnlich wie \fBimport\-tar\fP oder \fBimport\-raw\fP, allerdings ist das erste Argument das Quellverzeichnis\&. Falls unterstützt, wird dieser Befehl einen \fBbtrfs\fP(5)\-Schnappschuss oder Teildatenträger für das neue Abbild erstellen\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fBexport\-tar\fP \fINAME\fP [\fIDATEI\fP], \fBexport\-raw\fP \fINAME\fP [\fIDATEI\fP] .RS 4 Exportiert ein TAR\- oder RAW\-Abbild, und speichert es in der angegebenen Datei\&. Der erste Parameter sollte ein Abbildname sein\&. Der zweite Parameter sollte ein Dateipfad sein, in den das TAR\- oder RAW\-Abbild geschrieben wird\&. Falls der Pfad auf »\&.gz« endet, wird die Datei mit \fBgzip\fP(1) komprimiert, falls er auf »\&.xz« endet, mit \fBxz\fP(1), falls er auf »\&.zst« endet, mit \fBzstd\fP(1) und falls er auf »\&.bz2« endet, mit \fBbzip2\fP(1)\&. Falls der Pfad auf keine dieser Zeichenketten endet, verbleibt die Datei unkomprimiert\&. Falls das zweite Argument fehlt, wird das Abbild in die Standardausgabe geschrieben\&. Die Komprimierung kann auch explizit mit dem Schalter \fB\-\-format=\fP ausgewählt werden\&. Dies ist insbesondere nützlich, falls der zweite Parameter nicht angegeben wird\&. .sp Ganz ähnlich wie beim Herunterladen und Importieren von Abbildern, können laufende Exporte mittels \fBlist\fP aufgeführt und mit \fBcancel\-transfer\fP abgebrochen werden\&. .sp Beachten Sie, dass derzeit nur Verzeichnis\- und Teildatenträger\-Abbilder als TAR\-Abbilder exportiert werden können, und nur rohe Platten\-Abbilder als RAW\-Abbilder\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fBlist\-transfer\fP .RS 4 Zeigt eine Liste der laufenden Downloads, Importe und Exporte von Abbildern an\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fBcancel\-transfer\fP \fIKENNUNG\fP… .RS 4 Bricht einen Download, Import oder Export eines Abbilds mit der angegebenen Kennung ab\&. Um laufende Übertragungen und ihre Kennungen anzuzeigen, verwenden Sie \fBlist\fP\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fBlist\-images\fP .RS 4 Zeigt eine Liste von bereits heruntergeladenen/importierten Abbildern\&. .sp Hinzugefügt in Version 256\&. .RE .SH OPTIONEN .PP Die folgenden Optionen werden verstanden: .PP \fB\-\-read\-only\fP .RS 4 Bei der Verwendung mit \fBpull\-raw\fP, \fBpull\-tar\fP, \fBimport\-raw\fP, \fBimport\-tar\fP oder \fBimport\-fs\fP wird ein schreibgeschütztes Abbild erstellt\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-\-verify=\fP .RS 4 Gibt beim Herunterladen eines Abbilds an, ob das Abbild verifiziert werden soll, bevor es verfügbar gemacht wird\&. Akzeptiert entweder »no«, »checksum« oder »signature«\&. Falls »no«, erfolgt keine Verifizierung\&. Falls »checksum« angegebenen wird, wird der Download nach Abschluss der Übertragung auf Integrität geprüft, aber es wird keine Signatur verifiziert\&. Falls »signature« angegeben ist, wird die Prüfsumme verifiziert und die Signatur des Abbildes gegen einen lokalen Schlüsselbund vertrauenswürdiger Lieferanten geprüft\&. Es wird nachdrücklich empfohlen, diese Option auf »signature« zu setzen, falls der Server und das Protokoll dies unterstützen\&. Standardmäßig »signature«\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-\-force\fP .RS 4 Wenn beim Herunterladen eines Abbildes eine lokale Kopie mit dem angegebenen Namen bereits existiert, wird diese zuerst gelöscht und dann durch das frisch heruntergeladene Abbild ersetzt\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-\-format=\fP .RS 4 Bei der Verwendung mit den Befehlen \fBexport\-tar\fP oder \fBexport\-raw\fP legt dies das für die sich ergebende Datei zu verwendende Kompressionsformat fest\&. Akzeptiert entweder »uncompressed«, »xz«, »gzip«, »zst« oder »bzip2«\&. Standardmäßig wird das Format automatisch aus dem Namen des übergebenen Ausgabeabbildes bestimmt\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-q\fP, \fB\-\-quiet\fP .RS 4 Unterdrückt bei der Ausführung zusätzliche informative Ausgaben\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-H\fP, \fB\-\-host=\fP .RS 4 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 \fBmachinectl \-H \fP\fIRECHNER\fP aufgezählt werden\&. Setzen Sie IPv6\-Adressen in Klammern\&. .RE .PP \fB\-M\fP, \fB\-\-machine=\fP .RS 4 Verbindet zu einem in einem lokalen Container ausgeführten \fBsystemd\-importd.service\fP(8), um die angegebene Aktion innerhalb des Containers auszuführen\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-\-class=\fP, \fB\-m\fP, \fB\-P\fP, \fB\-S\fP, \fB\-C\fP .RS 4 Wählt die Abbildklasse für die heruntergeladenen Abbilder\&. Dies wählt hauptsächlich das Verzeichnis aus, in das heruntergeladen wird\&. Der Schalter \fB\-\-class=\fP akzeptiert »machine«, »portable«, »sysext« oder »confext« als Argument\&. Die kurzen Optionen \fB\-m\fP, \fB\-P\fP, \fB\-S\fP, \fB\-C\fP sind Abkürzungen für \fB\-\-class=machine\fP, \fB\-\-class=portable\fP, \fB\-\-class=sysext\fP, \fB\-\-class=confext\fP\&. .sp Beachten Sie, dass \fB\-\-keep\-download=\fP für \fB\-\-class=machine\fP standardmäßig true und ansonsten false ist, siehe unten\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-\-keep\-download=\fP, \fB\-N\fP .RS 4 Akzeptiert ein logisches Argument\&. Bei der Verwendung mit \fBpull\-raw\fP oder \fBpull\-tar\fP wird ausgewählt, ob direkt in den angegebenen lokalen Abbildnamen heruntergeladen werden soll oder ob zuerst in eine schreibgeschützte Kopie heruntergeladen wird, die erst nach Abschluss des Herunterladens beschreibbar gemacht werden soll\&. Standardmäßig true für \fB\-\-class=machine\fP, ansonsten false\&. .sp Der Schalter \fB\-N\fP ist eine Abkürzung für \fB\-\-keep\-download=no\fP\&. .sp Hinzugefügt in Version 256\&. .RE .PP \fB\-\-json=\fP\fIMODUS\fP .RS 4 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)\&. .RE .PP \fB\-j\fP .RS 4 Äquivalent zu \fB\-\-json=pretty\fP bei der Ausführung in einem Terminal, ansonsten \fB\-\-json=short\fP\&. .RE .PP \fB\-\-no\-pager\fP .RS 4 Leitet die Ausgabe nicht an ein Textanzeigeprogramm weiter\&. .RE .PP \fB\-\-no\-legend\fP .RS 4 Gibt die Legende nicht aus, d\&.h\&. die Spaltenköpfe und die Fußzeile mit Hinweisen\&. .RE .PP \fB\-\-no\-ask\-password\fP .RS 4 Befragt den Benutzer nicht für Authentifizierung für privilegierte Aktionen\&. .RE .PP \fB\-h\fP, \fB\-\-help\fP .RS 4 Zeigt einen kurzen Hilfetext an und beendet das Programm\&. .RE .PP \fB\-\-version\fP .RS 4 Zeigt eine kurze Versionszeichenkette an und beendet das Programm\&. .RE .SH BEISPIELE .PP \fBBeispiel\ \&1.\ \&Herunterladen eines Ubuntu\-TAR\-Abbildes und Öffnen einer Shell darin\fP .sp .if n \{\ .RS 4 .\} .nf # importctl pull\-tar \-mN https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-root\&.tar\&.xz # systemd\-nspawn \-M jammy\-server\-cloudimg\-amd64\-root .fi .if n \{\ .RE .\} .PP Dies lädt das angegebene \&.tar\-Abbild herunter, verifiziert es und verwendet dann \fBsystemd\-nspawn\fP(1) zum Öffnen einer Shell darin\&. .PP \fBBeispiel\ \&2.\ \&Herunterladen eines Ubuntu\-RAW\-Abbildes, setzen eines Root\-Passworts darin, es als einen Dienst starten\fP .sp .if n \{\ .RS 4 .\} .nf # importctl pull\-raw \-mN \e https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-disk\-kvm\&.img \e jammy # systemd\-firstboot \-\-image=/var/lib/machines/jammy\&.raw \-\-prompt\-root\-password \-\-force # machinectl start jammy # machinectl login jammy .fi .if n \{\ .RE .\} .PP Dies lädt das angegebene \&.raw\-Abbild herunter und stellt es unter dem lokalen Namen »jammy« zu Verfügung\&. Dann wird mittels \fBsystemd\-firstboot\fP(1) darin ein Passwort für root gesetzt\&. Danach wird die Maschine als Systemdienst gestartet\&. Mit dem letzten Befehl wird eine Anmeldeshell im Container angefordert\&. .PP \fBBeispiel\ \&3.\ \&Ein Container\-Abbild als Tar\-Datei exportieren\fP .sp .if n \{\ .RS 4 .\} .nf # importctl export\-tar \-m fedora myfedora\&.tar\&.xz .fi .if n \{\ .RE .\} .PP Exportiert den Container »fedora« als Xz\-komprimierte Tar\-Datei myfedora\&.tar\&.xz in das aktuelle Verzeichnis\&. .SH EXIT\-STATUS .PP Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich Null\&. .SH UMGEBUNGSVARIABLEN .PP \fI$SYSTEMD_LOG_LEVEL\fP .RS 4 Die maximale Protokollierstufe für ausgegebene Meldungen (Meldungen mit einer höheren Protokollierstufe, d\&.h\&. weniger wichtige, werden unterdrückt)\&. Akzeptiert eine Kommata\-getrennte Liste von Werten\&. Ein Wert kann einer der folgenden sein (in Reihenfolge absteigender Bedeutung): \fBemerg\fP, \fBalert\fP, \fBcrit\fP, \fBerr\fP, \fBwarning\fP, \fBnotice\fP, \fBinfo\fP, \fBdebug\fP oder eine Ganzzahl im Bereich 0…7\&. Siehe \fBsyslog\fP(3) für weitere Informationen\&. Jedem Wert kann optional eine Zeichenkette aus \fBconsole\fP, \fBsyslog\fP, \fBkmsg\fP oder \fBjournal\fP gefolgt von einem Doppelpunkt vorangestellt werden, um die maximale Protokollierstufe für dieses spezielle Protokollierziel zu setzen (d\&.h\&. \fBSYSTEMD_LOG_LEVEL=debug,console:info\fP legt fest, dass auf der Stufe »debug« protokolliert werden soll, außer beim Protokollieren auf die Konsole, die auf Stufe »info« erfolgen soll)\&. Beachten Sie, dass die globale maximale Protokollierstufe Priorität gegenüber jeder zielbezogenen maximalen Protokollierstufe hat\&. .RE .PP \fI$SYSTEMD_LOG_COLOR\fP .RS 4 Ein logischer Wert\&. Falls true, werden auf das TTY geschriebene Nachrichten gemäß ihrer Priorität eingefärbt\&. .sp Diese Einstellung ist nur nützlich, falls die Nachrichten direkt auf das Terminal geschrieben werden, da \fBjournalctl\fP(1) und andere Werkzeuge, die Protokolle anzeigen, selbständig Nachrichten gemäß ihrer Protokollierungsstufe einfärben\&. .RE .PP \fI$SYSTEMD_LOG_TIME\fP .RS 4 Ein logischer Wert\&. Falls true, wird den Protokollnachrichten der Konsole ein Zeitstempel vorangestellt\&. .sp Diese Einstellung ist nur nützlich, falls die Nachrichten direkt auf das Terminal oder in eine Datei geschrieben werden, da \fBjournalctl\fP(1) und andere Werkzeuge, die Protokolle anzeigen, selbständig Zeitstempel basierend auf ihren Metadaten den Nachrichten anhängen\&. .RE .PP \fI$SYSTEMD_LOG_LOCATION\fP .RS 4 Ein logischer Wert\&. Falls true, wird den Protokollnachrichten ein Dateiname und eine Zeilenummer in dem Quellcode, aus dem die Nachrichten stammen, vorangestellt\&. .sp Beachten Sie, dass der Protokollierort sowieso oft als Metadaten zu den Journal\-Einträgen angehängt ist\&. Die Aufnahme in den Nachrichtentext kann bei der Fehlersuche in Programmen dennoch praktisch sein\&. .RE .PP \fI$SYSTEMD_LOG_TID\fP .RS 4 Ein logischer Wert\&. Falls true, wird den Nachrichten die aktuelle numerische Thread\-Kennung (TID) vorangestellt\&. .sp Beachten Sie, dass diese Informationen sowieso als Metadaten an Journal\-Einträge angehängt wird\&. Die Aufnahme direkt im Nachrichtentext kann aber trotzdem bei der Fehlersuche in Programmen praktisch sein\&. .RE .PP \fI$SYSTEMD_LOG_TARGET\fP .RS 4 Das Ziel für Protokolliernachrichten\&. Entweder \fBconsole\fP (auf das angehängte TTY protokollieren), \fBconsole\-prefixed\fP (auf das angehängte TTY protokollieren, aber die Protokollierstufe und »Einrichtung« voranstellen, siehe \fBsyslog\fP(3)), \fBkmsg\fP (in den zirkulären Kernel\-Protokollpuffer protokollieren), \fBjournal\fP (in das Journal protokollieren), \fBjournal\-or\-kmsg\fP (in das Journal protokollieren, falls verfügbar, und andernfalls nach Kmsg), \fBauto\fP (das geeignete Protokollierziel automatisch ermitteln, die Vorgabe) oder \fBnull\fP (die Protokollierung deaktivieren)\&. .RE .PP \fI$SYSTEMD_LOG_RATELIMIT_KMSG\fP .RS 4 Ob Kmsg ratenlimitiert werden soll oder nicht\&. Akzeptiert einen logischen Wert\&. Standardmäßig »true«\&. Falls deaktiviert, wird Systemd die nach Kmsg geschriebenen Meldungen nicht ratenlimitieren\&. .RE .PP \fI$SYSTEMD_PAGER\fP, \fI$PAGER\fP .RS 4 Zu verwendendes Textanzeigeprogramm, wenn \fB\-\-no\-pager\fP nicht angegeben ist\&. Falls gesetzt, wird \fI$SYSTEMD_PAGER\fP verwandt, andernfalls \fI$PAGER\fP\&. setzt \fI$PAGER\fP außer Kraft\&. Falls weder \fI$SYSTEMD_PAGER\fP noch \fI$PAGER\fP gesetzt sind, wird eine Reihe wohlbekannter Implementierungen von Textanzeigeprogrammen der Reihe nach ausprobiert, einschließlich \fBless\fP(1) und \fBmore\fP(1), bis eines gefunden wird\&. Falls keine Implementierung eines Textanzeigeprogramms gefunden wird, wird keines aufgerufen\&. Setzen dieser Umgebungsvariablen auf die leere Zeichenkette oder den Wert »cat« ist äquivalent zur Übergabe von \fB\-\-no\-pager\fP\&. .sp Beachten Sie: Falls \fI$SYSTEMD_PAGERSECURE\fP nicht gesetzt ist, können \fI$SYSTEMD_PAGER\fP und \fI$PAGER\fP nur zum Deaktivieren des Seitenanzeigeprogramms (mit »cat« oder »«) verwandt werden und werden ansonsten ignoriert\&. .RE .PP \fI$SYSTEMD_LESS\fP .RS 4 Setzt die an \fBless\fP übergebenen Optionen (standardmäßig »FRSXMK«) außer Kraft\&. .sp Benutzer könnten insbesondere zwei Optionen ändern wollen: .PP \fBK\fP .RS 4 Diese Option weist das Textanzeigeprogramm an, sich sofort beim Druck von Strg\-C zu beenden\&. Um \fBless\fP die Handhabung von Strg\-C selbst zum Umschalten auf die Eingabeaufforderung zu erlauben, setzen Sie diese Option zurück\&. .sp Falls der Wert von \fI$SYSTEMD_LESS\fP kein »K« enthält und \fBless\fP das aufgerufene Textanzeigeprogramm ist, wird Strg+C durch das Programm ignoriert und muss durch das Textanzeigeprogramm selbst gehandhabt werden\&. .RE .PP \fBX\fP .RS 4 Diese Option weist das Textanzeigeprogramm an, keine Termcap\-Initialisierungs\- und \-Deinitalisierungszeichenketten an das Terminal zu senden\&. Dies ist standardmäßig gesetzt, damit die Darstellung von Befehlen selbst nach dem Beenden des Textanzeigeprogramms sichtbar bleibt\&. Allerdings stehen dadurch einige Funktionen des Textanzeigeprogramms nicht zur Verfügung; insbesondere ist das Scrollen in der Ausgabe mit der Maus nicht möglich\&. .RE .sp Beachten Sie, dass das Setzen der regulären Umgebungsvariablen \fI$LESS\fP keine Auswirkungen auf die Ausführung von \fBless\fP(1) durch \fBsystemd\fP(1)\-Werkzeuge hat\&. .sp Siehe \fBless\fP(1) für weitere Ausführungen\&. .RE .PP \fI$SYSTEMD_LESSCHARSET\fP .RS 4 Setzt den an \fBless\fP zu übergebenden Zeichensatz (standardmäßig »utf\-8«, falls das aufrufende Terminal als UTF\-8\-kompatibel erkannt wurde) außer Kraft\&. .sp Beachten Sie, dass das Setzen der regulären Umgebungsvariablen \fI$LESSCHARSET\fP keine Auswirkungen auf die Ausführungen von \fBless\fP(1) durch \fBsystemd\fP(1)\-Werkzeuge hat\&. .RE .PP \fI$SYSTEMD_PAGERSECURE\fP .RS 4 Typische Seitenanzeigeprogramme wie \fBless\fP(1) unterstützen nebem dem seitenweisen Anzeigen (d\&.h\&. dem Durchlaufen der Ausgabe) das Öffnen von oder Schreiben in andere Dateien und die Ausführung von beliebigen Shell\-Befehlen\&. Werden Befehle mit erhöhten Berechtigungen, beispielsweise unter \fBsudo\fP(8) oder \fBpkexec\fP(1), aufgerufen, wird das Seitenanzeigeprogramm zur Sicherheitsgrenze\&. Es muss darauf geachtet werden, dass nur Programme mit streng begrenzter Funktionalität als Seitenanzeigeprogramm verwandt werden und unerwünschte interaktive Funktionalitäten wie das Öffnen oder Erstellen von neuen Dateien oder das Starten von Subprozessen nicht erlaubt sind\&. Der »Sichere Modus« für das Seitenanzeigeprogramm kann wie nachfolgend beschrieben aktiviert werden, \fIfalls das Seitenanzeigeprogramm dies unterstützt\fP (die meisten Seitenanzeigeprogramme sind nicht so geschrieben, dass sie dies berücksichtigen)\&. Es wird empfohlen, den »Sicheren Modus« explizit zu aktivieren oder das Seitenanzeigeprogramm komplett mittels \fB\-\-no\-pager\fP oder \fIPAGER=cat\fP zu deaktivieren, wenn nicht vertrauenswürdigen Benutzern die Ausführung von Programmen mit erhöhten Privilegien erlaubt wird\&. .sp Diese Option akzeptiert ein logisches Argument\&. Ist es auf »true« gesetzt, wird der »Sichere Modus« des Seitenanzeigeprogramms aktiviert\&. Im »Sicheren Modus« wird \fBLESSSECURE=1\fP beim Aufruf des Seitenanzeigeprogramms gesetzt\&. Dies weist das Seiteanzeigeprogramm an, Befehle zum Öffnen oder Erstellen von neuen Dateien sowie das Starten von Subprozessen zu deaktivieren\&. Derzeit ist nur von \fBless\fP(1) bekannt, dass es diese Variable versteht und den »Sicheren Modus« implementiert\&. .sp Ist diese Variable auf »false« gesetzt, unterliegt das Seitenanzeigeprogramm keinen Beschränkungen\&. Setzen auf \fISYSTEMD_PAGERSECURE=0\fP oder das Beibehalten der Variable von der geerbten Umgebung könnte den Benutzern die Ausführung beliebiger Befehle erlauben\&. .sp Ist \fI$SYSTEMD_PAGERSECURE\fP nicht gesetzt, versuchen die Systemd\-Werkzeuge automatisch herauszufinden, ob der »Sicheren Modus« aktiviert werden soll und ob das Seitenanzeigeprogramm dies unterstützt\&. Der »Sichere Modus« wird aktiviert, falls die effektive UID nicht mit der UID des Eigentümers der Anmeldesitzung übereinstimmt, siehe \fBgeteuid\fP(2) und \fBsd_pid_get_owner_uid\fP(3), oder wenn die Ausführung unter Werkzeugen wie \fBsudo\fP(8) oder ähnlichem erfolgt (\fI$SUDO_UID\fP ist gesetzt \&\s-2\u[2]\d\s+2)\&. In diesen Fällen wird \fISYSTEMD_PAGERSECURE=1\fP gesetzt und Seitenanzeigeprogramme, von denen nicht bekannt ist, dass sie den »Sicheren Modus« unterstützen, werden überhaupt nicht verwandt\&. Beachten Sie, dass diese automatische Erkennung nur die typischsten Mechanismen zur Erlangung von Privilegien abdeckt und dem Komfort dient\&. Es wird empfohlen, explizit \fI$SYSTEMD_PAGERSECURE\fP zu setzen oder das Seitenanzeigeprogramm zu deaktivieren\&. .sp Beachten Sie, dass auch \fI$SYSTEMD_PAGERSECURE\fP gesetzt sein muss, damit die Variablen \fI$SYSTEMD_PAGER\fP oder \fI$PAGER\fP (außer zum Deaktivieren des Seitenanzeigeprogramms) berücksichtigt werden\&. .RE .PP \fI$SYSTEMD_COLORS\fP .RS 4 Akzeptiert ein logisches Argument oder einen besonderen Wert\&. Standardmäßig (nicht gesetzt) werden \fBsystemd\fP und zugehörige Hilfswerkzeuge in ihrer Ausgabe Farben verwenden, falls dies möglich ist\&. Falls \fI$COLORTERM\fP auf »truecolor« oder »24bit« gesetzt ist, werden 24\-bit\-Farben aktiviert, ansonsten 256 Farben, außer wenn \fI$NO_COLOR\fP gesetzt ist oder \fI$TERM\fP anzeigt, dass Farben deaktiviert sind\&. .PP \fBtrue\fP .RS 4 Identisch zu nicht gesetzt, außer dass \fI$NO_COLOR\fP ignoriert wird\&. .RE .PP \fBfalse\fP .RS 4 Die Ausgabe erfolgt monochrom\&. .RE .PP »16«, »256«, »24bit« .RS 4 Verwendet immer die 16, 256 bzw. 24\-bit\-ANSI\-Basisfarben\&. .RE .PP »auto\-16«, »auto\-256«, »auto\-24bit« .RS 4 Verwendet die angegebene Menge an Farben, abhängig von \fI$TERM\fP und womit die Konsole verbunden ist\&. .RE .RE .PP \fI$SYSTEMD_URLIFY\fP .RS 4 Dies muss ein logischer Wert sein\&. Er steuert, ob anklickbare Links für Terminal\-Emulatoren, die dies unterstützen, erstellt werden sollen\&. Dies kann angegeben werden, um die Entscheidung, die \fBsystemd\fP basierend auf \fI$TERM\fP und anderen Bedingungen trifft, außer Kraft zu setzen\&. .RE .SH "SIEHE AUCH" .PP \fBsystemd\fP(1), \fBsystemd\-importd.service\fP(8), \fBsystemd\-nspawn\fP(1), \fBsystemd\-vmspawn\fP(1), \fBmachinectl\fP(1), \fBportablectl\fP(1), \fBsystemd\-sysext\fP(8), \fBsystemd\-confext\fP(8), \fBtar\fP(1), \fBxz\fP(1), \fBgzip\fP(1), \fBzstd\fP(1), \fBbzip2\fP(1) .SH ANMERKUNGEN .IP " 1." 4 HTTP ETag .RS 4 \%https://de.wikipedia.org/wiki/HTTP_ETag .RE .IP " 2." 4 Es wird für andere Werkzeuge empfohlen, \fI$SUDO_UID\fP geeignet zu setzen und zu überprüfen und es als allgemeine Schnittstelle zu behandeln. .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .