.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SYSTEMD\-SYSUPDATE 8 "" "systemd 255" systemd\-sysupdate
.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
systemd\-sysupdate, systemd\-sysupdate.service, systemd\-sysupdate.timer,
systemd\-sysupdate\-reboot.service, systemd\-sysupdate\-reboot.timer \- Das
Betriebssystem oder andere Ressourcen automatisch aktualisieren
.SH ÜBERSICHT
.HP \w'\fBsystemd\-sysupdate\fR\ 'u
\fBsystemd\-sysupdate\fP [OPTIONEN…]
.PP
systemd\-sysupdate\&.service
.SH BESCHREIBUNG
.PP
\fBsystemd\-sysupdate\fP aktualisiert atomar das Betriebssystem,
Container\-Abbilder, portable Diensteabbilder oder andere Quellen, basierend
auf den in \fBsysupdate.d\fP(5) beschriebenen
Übertragungskonfigurationsdateien\&.
.PP
Dieses Werkzeug implementiert datei\-, verzeichnis\- oder partitionsbasierte
Aktualisierungsschemata, unterstützt mehrere parallel installierte Versionen
bestimmter Ressourcen in einer A/B\- (oder sogar A/B/C\-, A/B/C/DE\- …)
Art\&. A/B\-Aktualisierung bedeutet, dass bei der aktuellen Verwendung einer
Ressource die nächste an einen komplett anderen Ort heruntergeladen,
entpackt und vorbereitet werden kann, unabhängig von der ersten und \(en
sobald abgeschlossen \(en diese aktiviert werden kann\&. Dabei werden die
Rollen vertauscht, so dass die Neue die verwandte Ressource wird und die
bisher eingesetzte diejenige wird, die bei der nächsten Aktualisierung
ersetzt werden wird und so weiter\&. Die zu aktualisierenden Ressourcen
werden in Übertragungsdateien definiert, eine für jede zu aktualisierende
Ressource\&. Ressourcen, die mit diesem Werkzeug aktualisiert werden können,
sind beispielsweise eine Wurzeldateisystempartition, eine zugehörige
Verity\-Partition sowie ein Kernelabbild\&. Die Kombination dieser drei kann
als komplette Betriebssystemaktualisierung betrachtet werden\&.
.PP
Das Werkzeug aktualisiert Partitionen, Dateien oder Verzeichnisbäume immer
als Ganzes und agiert mit mindestens zwei Versionen jeder Ressource: der
\fIaktuellen\fP Version sowie der \fInächsten\fP Version: diejenige, auf die
aktualisiert wird und die anfänglich unvollständig ist, während die
heruntergeladenen Daten geschrieben werden; sowie optional weiteren
Versionen\&. Sobald das Herunterladen einer neueren Version abgeschlossen
ist, wird diese die aktuelle Version und gibt die Version, die bisher als
aktuelle Version betrachtet wurde, zum Löschen/Ersetzen/Aktualisieren
frei\&.
.PP
Beim Installieren neuer Versionen wird dieses Werkzeug die neue Version
herunterladen, entkomprimieren und entpacken und direkt in das Ziel
schreiben\&. Dies erfolgt auf eine robuste Art, so dass ein unvollständiges
Herunterladen beim nächsten Aufruf erkannt wird und die Reste beseitigt
werden, bevor ein neuer Versuch eingeleitet wird\&.
.PP
Beachten Sie, dass beim Schreiben von Aktualisierungen in eine Partition
diese bereits existieren muss, da \fBsystemd\-sysupdate\fP nicht automatisch
Partitionen erstellen wird\&. Verwenden Sie Werkzeuge wie
\fBsystemd\-repart\fP(8), um automatisch zusätzliche Partitionen beim
Systemstart für die Verwendung mit \fBsystemd\-sysupdate\fP zu erstellen\&.
.PP
Dieses Werkzeug kann sowohl auf dem laufenden Betriebssystem verwandt
werden, um das Betriebssystem »im Betriebszustand« aus sich selbst zu
aktualisieren und bei »nicht aktiven« Plattenabbildern, um diese von
außerhalb, basierend auf der Übertragung von Dateien, die in diese Abbilder
eingebettet sind, zu aktualisieren\&. Für Letzteres siehe die nachfolgende
Beschreibung von \fB\-\-image=\fP\&. Letzteres ist insbesondere für die
Aktualisierung von Container\-Abbildern oder portierbaren Diensteabildern
interessant\&.
.PP
Der Systemdienst systemd\-sysupdate\&.service wird das Betriebssystem
automatisch basierend auf den installierten Übertragungsdateien
aktualisieren\&. Er wird regelmäßig über systemd\-sysupdate\&.timer
ausgelöst\&. systemd\-sysupdate\-reboot\&.service wird das System automatisch
nach der Installation einer neuen Version neu starten\&. Der Systemneustart
wird mittels systemd\-sysupdate\-reboot\&.timer ausgelöst\&. Die zwei Dienste
sind voneinander getrennt, da es typischerweise ratsam ist, Aktualisierungen
regelmäßig während des Betriebs herunterzuladen, aber Neustarts bis zu einem
geeigneten Zeitpunkt zu verzögern (d\&.h\&. typischerweise nachts)\&. Die
zwei Dienste\-/Timer\-Unit\-Gruppen können separat aktiviert werden\&.
.PP
Für Details über Übertragungsdateien und Beispiele siehe
\fBsysupdate.d\fP(5)\&.
.SH BEFEHL
.PP
Die folgenden Befehle werden verstanden:
.PP
\fBlist\fP [\fIVERSION\fP]
.RS 4
Beim Aufruf ohne Argumente werden die herunterladbaren und installierbaren
Versionen aufgezählt und eine zusammenfassende Tabelle mit den erkannten
Versionen und ihren Eigenschaften dargestellt\&. Dazu gehört, ob es neuere
Kandidatenversionen gibt, auf die aktualisiert werden kann\&. Falls ein
Versionsargument angegeben ist, werden Details über die bestimmte Version
angezeigt, einschließlich der einzelnen Dateien, die übertragen werden
müssen, um die neue Version zu erlangen\&.
.sp
Falls kein Befehl explizit angegeben ist, wird dieser Befehl impliziert\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fBcheck\-new\fP
.RS 4
Prüft, ob eine neue Version verfügbar ist\&. Dies zählt intern die
herunterladbaren und installierten Versionen auf und liefert einen
Exit\-Status von 0, falls es eine neue Version gibt, auf die aktualisiert
werden kann, und ansonsten einen von Null verschiedenen Wert\&. Falls es
eine neue Version gibt, auf die aktualisiert werden kann, dann wird deren
Versionskennzeichnung auf die Standardausgabe geschrieben\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fBupdate\fP [\fIVERSION\fP]
.RS 4
Installiert (aktualisiert auf) die angegebene Version oder die neuste
Version, falls keine Version angegeben ist\&. Falls die Version bereits
installiert ist oder es keine neuere Version gibt, erfolgt keine Aktion\&.
.sp
Falls eine neue zu installierende/darauf zu aktualisierende Version gefunden
wird, werden alte Versionen gelöscht, bis mindestens eine neue Version
installiert werden kann\&. Dies wird mittels \fIInstanceMax=\fP in
\fBsysupdate.d\fP(5) oder über die verfügbaren Partitionsplätze vom richtigen
Typ konfiguriert\&. Diese implizite Aktion kann auch explizit über den
nachfolgend beschriebenen Befehl \fBvacuum\fP aufgerufen werden\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fBvacuum\fP
.RS 4
Löscht alte installierte Versionen, bis die mittels \fIInstanceMax=\fP in
\fBsysupdate.d\fP(5) konfigurierten Beschränkungen wieder eingehalten
werden\&. Normalerweise sollte es nicht notwendig sein, diesen Befehl
explizit aufzurufen, da er implizit aufgerufen wird, wenn eine neue
Aktualisierung eingeleitet wird\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fBpending\fP
.RS 4
Prüft, ob eine neuere Version des Betriebssystems als die aktuell laufende
installiert ist\&. Liefert Null zurück, falls dem so ist und ansonsten einen
anderen Wert\&. Dies vergleicht die Versionskennzeichnung der neusten
installierten Version mit der Version des Betriebssystemabbildes, wie es vom
Feld \fIIMAGE_VERSION=\fP in /etc/os\-release berichtet wird\&. Falls erstere
neuerer als letztere ist, wurde anscheinend eine Aktualisierung
abgeschlossen, aber noch nicht aktiviert (d\.h\&. kein Systemneustart hinein
durchgeführt)\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fBreboot\fP
.RS 4
Ähnlich wie der Befehl \fBpending\fP, startet aber das System sofort neu, falls
eine neuere Version des Betriebssystems installiert wurde, als aktuell
läuft\&. Diese Aktion kann implizit zusammen mit dem Befehl \fBupdate\fP
erfolgen, nach einer abgeschlossenen Aktualisierung mittels des Schalters
\fB\-\-reboot\fP, siehe unten\&. Dieser Befehl wird keine Aktion durchführen (und
Erfolg zurückliefern), falls keine Aktualisierung installiert wurde und
daher das System nicht neugestartet wurde\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fBcomponents\fP
.RS 4
Führt zu aktualisierende Komponenten auf\&. Dies zählt die Verzeichnisse
/etc/sysupdate\&.*\&.d/, /run/sysupdate\&.*\&.d/ und
/usr/lib/sysupdate\&.*\&.d/ auf, die Übertragungsdateien enthalten\&. Dieser
Befehl ist zum Auflisten möglicher Parameter für \fB\-\-component=\fP nützlich
(siehe unten)\&.
.sp
Hinzugefügt in Version 251\&.
.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 OPTIONEN
.PP
Die folgenden Optionen werden verstanden:
.PP
\fB\-\-component=\fP, \fB\-C\fP
.RS 4
Wählt die zu aktualisierenden Komponenten aus\&. Akzeptiert einen
Komponentennamen als Argument\&. Damit wird die Suchlogik für
Übertragungsdateien leicht verändert\&. Falls der Schalter nicht verwandt
wird, werden die Übertragungsdateien aus /etc/sysupdate\&.d/*\&.conf,
/run/sysupdate\&.d/*\&.conf und /usr/lib/sysupdate\&.d/*\&.conf
geladen\&. Falls dieser Schalter verwandt wird, wird der angegebene
Komponentenname verwandt, um die Verzeichnisse, in denen gesucht wird, auf
/etc/sysupdate\&.\fIKomponente\fP\&.d/*\&.conf,
/run/sysupdate\&.\fIKomponente\fP\&.d/*\&.conf und
/usr/lib/sysupdate\&.\fIKomponente\fP\&.d/*\&.conf zu ändern\&. Dabei wird die
Zeichenkette \fIKomponente\fP durch den angegebenen Komponentennamen ersetzt\&.
.sp
Verwenden Sie den Befehl \fBcomponents\fP, um alle zu aktualisierenden
Komponenten aufzulisten\&. Dies zählt die Verzeichnisse auf, die auf diese
Bennenungsregel passen\&.
.sp
Komponenten können verwandt werden, um getrennte Gruppen von
Übertragungsdateien für verschiedene Komponenten des Betriebssystems zu
definieren, die getrennt aktualisiert werden sollen\&. Verwenden Sie dieses
Konzept nicht für Ressourcen, die immer zusammen auf synchrone Art
aktualisiert werden sollen\&. Für diese Fälle definieren Sie einfach mehrere
Übertragungsdateien innerhalb des gleichen sysupdate\&.d/\-Verzeichnisses\&.
.sp
Diese Option kann nicht mit \fB\-\-definitions=\fP kombiniert werden\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fB\-\-definitions=\fP
.RS 4
Ein Pfad zu einem Verzeichnis\&. Falls angegeben, werden die
Übertragungsdateien *\&.conf aus diesem Verzeichnis statt aus
/usr/lib/sysupdate\&.d/*\&.conf, /etc/sysupdate\&.d/*\&.conf und
/run/sysupdate\&.d/*\&.conf gelesen\&.
.sp
Diese Option kann nicht mit \fB\-\-component=\fP kombiniert werden\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fB\-\-root=\fP
.RS 4
Akzeptiert einen Pfad zu einem für das Suchen nach Dateien
sysupdate\&.d/*\&.conf als Wurzeldateisystem zu verwendenden Verzeichnis\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fB\-\-image=\fP
.RS 4
Akzeptiert einen Pfad zu einer Abbilddatei oder zu einem einzuhängenden
Gerät, das ähnlich wie \fB\-\-root=\fP verwandt werden soll, siehe oben\&. Falls
dies verwandt wird und Partitionsressourcen aktualisiert werden, dann
erfolgt dies innerhalb des angegebenen Plattenabbildes\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fB\-\-image\-policy=\fP\fIRichtlinie\fP
.RS 4
Akzeptiert gemäß \fBsystemd.image\-policy\fP(7) eine
Abbildrichtlinienzeichenkette als Argument\&. Die Richtlinie wird bei
Aktionen auf dem mittels \fB\-\-image=\fP angegebenen Plattenabbild durchgesetzt,
siehe oben\&. Falls nicht angegeben ist die Vorgabe die Richtlinie »*«,
d\&.h\&. alle erkannten Dateisysteme im Abbild werden verwandt\&.
.RE
.PP
\fB\-\-instances\-max=\fP, \fB\-m\fP
.RS 4
Akzeptiert eine dezimale Ganzzahl größer oder gleich 2\&. Steuert, wie viele
Versionen jederzeit behalten werden sollen\&. Diese Option kann auch
innerhalb von Übertragungsdateien über die Einstellung \fIInstancesMax=\fP
konfiguriert werden, siehe \fBsysupdate.d\fP(5) für Details\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fB\-\-sync=\fP
.RS 4
Akzeptiert ein logisches Argument, standardmäßig ja\&. Dies kann zur
Festlegung verwandt werden, ob die frisch aktualisierten Ressourcenversionen
bei Bedarf auf Platte synchronisiert werden sollen (d\&.h\&. nachdem das
Herunterladen vollständig ist, bevor es abgeschlossen wurde und dann nach
dem Abschluss)\&. Das sollte nicht ausgeschaltet werden, außer um die
Laufzeitleistung in Testumgebungen zu verbessern\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fB\-\-verify=\fP
.RS 4
Akzeptiert ein logisches Argument, standardmäßig ja\&. Steuert, ob
heruntergeladene Inhalte kryptographisch überprüft werden sollen\&. Das
sollte nicht ausgeschaltet werden, außer in Testumgebungen\&.
.sp
Hinzugefügt in Version 251\&.
.RE
.PP
\fB\-\-reboot\fP
.RS 4
Startet das System direkt im Anschluss neu, wenn es in Kombination mit dem
Befehl \fBupdate\fP verwandt wird und eine neue Version installiert wurde\&.
.sp
Hinzugefügt in Version 251\&.
.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\-\-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 standardmäßig aktivierte JSON\-Ausgabe
auszuschalten)\&.
.RE
.SH EXIT\-STATUS
.PP
Bei Erfolg wird 0 zurückgegeben, anderenfalls ein Fehlercode ungleich
Null\&.
.SH "SIEHE AUCH"
.PP
\fBsystemd\fP(1), \fBsysupdate.d\fP(5), \fBsystemd\-repart\fP(8)
.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 .