.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH IMPORTCTL 1 "" "systemd 256.5" 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 [OPTIONEN…] {BEFEHL} [NAME…]
.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)
sowie auf Abbildern auf Dateisystem\-Ebene (Tarbälle)\&. 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
»inline«\-signierte Datei mit dem Namen des Abbildes und der Endung \&.sha256
oder mittels separaten Dateien SHA256SUMS und 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 »inline«\-Signatur in der Datei mit Endung \&.sha256 oder der
abgetrennten GPG\-Signaturdatei SHA256SUMS\&.gpg verifiziert\&. Der
öffentliche Schlüssel für diesen Verifikationsschritt muss unter
/usr/lib/systemd/import\-pubring\&.gpg oder /etc/systemd/import\-pubring\&.gpg
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 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 C\-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 C\-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
\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) 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) 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) 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« 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\-import.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
wahr und ansonsten falsch 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 wahr für
\fB\-\-class=machine\fP, ansonsten falsch\&.
.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 wahr, 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 wahr, 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 wahr, 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 wahr, 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
.RS 4
Zu verwendendes Textanzeigeprogramm, wenn \fB\-\-no\-pager\fP nicht angegeben ist;
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 der
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, dann wird
\fI$SYSTEMD_PAGER\fP (sowie \fI$PAGER\fP) ohne Rückmeldung 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
Akzeptiert einen logischen Wert\&. Wenn wahr, wird der »sichere« Modus des
Textanzeigeprogramms verwandt, falls falsch, wird dieser
deaktiviert\&. Falls \fI$SYSTEMD_PAGERSECURE\fP überhaupt nicht gesetzt ist,
dann wird der sichere Modus aktiviert, falls die effektive Kennung nicht
identisch zu dem Eigentümer der Anmeldesitzung ist, siehe \fBgeteuid\fP(2) und
\fBsd_pid_get_owner_uid\fP(3)\&. Im sicheren Modus wird \fBLESSSECURE=1\fP beim
Aufruf des Textanzeigeprogramms gesetzt und das Textanzeigeprogramm muss
Befehle deaktivieren, die neue Dateien öffnen oder erstellen oder die einen
neuen Unterprozess starten\&. Falls \fI$SYSTEMD_PAGERSECURE\fP überhaupt nicht
gesetzt ist, werden Textanzeigeprogramme, bei denen unbekannt ist, ob sie
einen sicheren Modus implementieren, nicht verwandt\&. (Derzeit
implementiert nur \fBless\fP(1) einen sicheren Modus\&.)
.sp
Hinweis: Wenn Befehle mit erhöhten Rechten ausgeführt werden, beispielsweise
mittels \fBsudo\fP(8) oder \fBpkexec\fP(1), muss Vorsicht walten gelassen werden,
um sicherzustellen, dass keine ungeplanten interaktiven Funktionalitäten
aktiviert werden\&. Der »sichere« Modus für das Textanzeigeprogramm kann wie
oben beschrieben automatisch aktiviert werden\&. Durch Setzen von
\fISYSTEMD_PAGERSECURE=0\fP oder durch Nichtenfernen dieser Einstellung aus der
ererbten Umgebung wird es dem Benutzer ermöglicht, beliebige Befehle
auszuführen\&. Beachten Sie, dass auch \fI$SYSTEMD_PAGERSECURE\fP gesetzt
werden muss, falls die Variablen \fI$SYSTEMD_PAGER\fP oder \fI$PAGER\fP
berücksichtigt werden sollen\&. Es kann sinnvoll sein, stattdessen das
Textanzeigeprogramm komplett mit \fB\-\-no\-pager\fP zu deaktivieren\&.
.RE
.PP
\fI$SYSTEMD_COLORS\fP
.RS 4
Akzeptiert ein logisches Argument\&. Wenn wahr, werden \fBsystemd\fP und
verwandte Hilfswerkzeuge Farben in ihrer Ausgabe verwenden, andernfalls wird
die Ausgabe einfarbig sein\&. Zusätzlich kann die Variable eine der
folgenden besonderen Werte annehmen: »16«, »256«, um die Verwendung von
Farbe auf die grundlegenden 16 bzw. 256 ANSI\-Farben zu beschränken\&. Dies
kann festgelegt werden, um die auf \fI$TERM\fP und der vorliegenden Verbindung
der Konsole basierende automatische Entscheidung außer Kraft zu setzen\&.
.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), \fBbzip2\fP(1)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
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 .