APT-LISTCHANGES(1) Debian APT-LISTCHANGES(1)
NAME
apt-listchanges - zeigt neue Changelog-Einträge von
Debian-Paketarchiven.
ÜBERSICHT
apt-listchanges [[Optionen...]] {[--apt] | [Paket.deb...]}
BESCHREIBUNG
apt-listchanges ist ein Werkzeug, das zeigt, was in einer neuen Version
eines Debian-Pakets verglichen mit der derzeit auf dem System
installierten Version geändert wurde.
Es tut dies, indem es die relevanten Einträge aus den beiden Dateien
NEWS.Debian und changelog[.Debian] extrahiert. Sie sind normalerweise
in den Debian-Paketarchiven in /usr/share/doc/Paket zu finden.
Bitte beachten Sie, dass in der Standardinstallation, falls
apt-listchanges während Upgrades als APT-Erweiterung ausgeführt wird,
es nur NEWS.Debian-Einträge anzeigt. Dies kann mit der Option --which
geändert werden.
Falls Changelog-Einträge angezeigt werden und das Paket keine
changelog[.Debian]-Datei enthält, ruft apt-listchanges den Befehl
apt-get changelog auf, um das Changelog aus dem Netzwerk
herunterzuladen. Dieses Verhalten kann mit der Option --no-network
deaktiviert werden.
Mit einer angegebenen Zusammenstellung von Dateinamen als Argument
(oder von APT mittels --apt gelesen) wird Apt-listchanges die Dateien
(unter der Annahme, dass es sich um Debian-Paketarchive handelt) nach
den maßgeblichen Changelog-Einträgen durchsuchen und sie alle in einer
nach Quellpaketen gruppierten Zusammenstellung anzeigen. Die Gruppen
werden nach der maximalen Dringlichkeit und dann nach dem Paketnamen
sortiert. Änderungen innerhalb jeder Paketgruppe werden in der
Reihenfolge ihres Erscheinens in den Changelog-Dateien angezeigt, d.h.
beginnend mit dem Neusten bis zum Ältesten. Die Option --reverse kann
zum Ändern dieser Reihenfolge benutzt werden.
OPTIONEN
apt-listchanges stellt die folgenden Optionen zur Steuerung seines
Verhaltens bereit. Die meisten davon haben Entsprechungen in der
Konfigurationsdatei, Einzelheiten finden Sie unter
»KONFIGURATIONSDATEI« weiter unten.
--apt
liest Dateinamen von einer besonders formatierten (von APT
bereitgestellten) Pipeline, anstatt aus Befehlszeilenargumenten und
berücksichtigt bestimmte APT-spezifische Optionen in der
Konfigurationsdatei. Diese Pipeline muss im »Version 2«-Format in
der APT-Konfiguration angegeben werden.
-v, --verbose
zeigt zusätzliche (üblicherweise unerwünschte) Informationen. Es
wird zum Beispiel eine Nachricht ausgegeben, wenn ein Paket
derselben oder einer älteren Version installiert werden soll oder
wenn ein Paket neu installiert werden soll.
-f, --frontend
wählt aus, welche Oberfläche für die Ausgabe von Informationen an
den Benutzer verwendet werden soll. Zu den aktuellen Oberflächen
gehören:
pager
benutzt den Befehl sensible-pager(1), um die Ausgabe
anzuzeigen. Der Befehl verwendet die Umgebungsvariable PAGER
zur Auswahl ihres Lieblingsseitenanzeigeprogramms. Die Option
»pager« kann in der Konfigurationsdatei angegeben werden, um
ein spezielles Seitenanzeigeprogramm auszuwählen, der mit
Apt-listchanges benutzt wird.
browser
zeigt mit dem Befehl sensible-browser(1) ein Changelog im
HTML-Format mit Querverweisen für Fehler und E-Mail-Adressen,
der Ihren Lieblings-Browser anhand der Umgebungsvariable
BROWSER auswählt. Die Option »browser« kann in der
Konfigurationsdatei angegeben werden, um einen speziellen
Browser auszuwählen, der mit Apt-listchanges benutzt wird.
xterm-pager
verwendet Ihr bevorzugtes Seitenanzeigeprogramm, um die Ausgabe
anzuzeigen, tut dies jedoch in einem Xterm (mittels der
Alternative »x-terminal-emulator«) im Hintergrund. Dies
ermöglicht Ihnen, falls Sie dies wollen, mit dem Upgrade
fortzufahren und das Durchstöbern der Changelogs fortzusetzen.
Sie können die Verwendung des Terminal-Emulators mit der
Konfigurationsoption »xterm« außer Kraft setzen.
xterm-browser
die logische Kombination von Xterm-Pager und Browser. Nur
geeignet für Textmodus-Browser.
text
gibt ohne Pausen auf die Standardausgabe aus.
syslog
gibt die Ausgabe in das Systemprotokoll aus. Es wird empfohlen,
die Option »titled« zu deaktivieren.
log
hängt die Ausgabe an eine Protokolldatei an, mit einem
optionalen Filterprozess. Es wird empfohlen, die Option
»titled« zu deaktivieren.
mail
sendet eine E-Mail an die mit --email-address angegebene
Adresse und zeigt keine Changelogs an.
gtk
öffnet ein GTK-Fenster zum Anzeigen der Changelogs. Erfordert,
dass »phyton3-gi« installiert ist.
none
tut nichts. Kann benutzt werden, um zu verhindern, dass
Apt-listchanges ausgeführt wird, wenn automatische Ausführung
von APT eingerichtet ist.
Bitte beachten Sie, dass Apt-listchanges versuchen wird, zu einem
nicht privilegierten Benutzer zu wechseln, bevor die Befehle in den
Oberflächen »browser«, »xterm-browser« und »xterm-pager« geöffnet
werden. Dies wird derzeit jedoch nicht für die Oberfläche »pager«
getan. Siehe auch »UMGEBUNGSVARIABLEN« unten.
--email-address=Adresse
Zusätzlich zur Anzeige wird eine Kopie der Changelog-Daten an die
angegebene Adresse geschickt. Um die Changelog-Einträge nur per
E-Mail zu versenden, benutzen Sie diese Option mit der speziellen
Oberfläche »mail«.
--email-format={text|html}
Falls das Versenden von E-Mail-Kopien aktiviert ist (siehe
--email-address oben), wählt diese Option aus, ob die E-Mail als
gute alte Klartextdaten oder als HTML-Daten mit anklickbaren
Verweisen, die möglicherweise für Leute mit grafischen
E-Mail-Clients geeigneter sind, gesendet werden soll.
-c, --confirm
Sobald Changelogs angezeigt wurden, wird der Anwender gefragt, ob
er fortfahren möchte oder nicht. Falls er sich entscheidet, nicht
fortzufahren, wird ein Rückgabewert ungleich null zurückgegeben und
APT wird abgebrochen.
-a, --show-all
versucht, statt Changelog-Einträgen, die neuer als die derzeit
installierte Version des Pakets sind, einfach alle
Changelog-Einträge für alle Pakete anzuzeigen. Dies ist nützlich,
um das ganze Changelog eines .debs anzuzeigen, bevor es entpackt
wird.
-n, --no-network
In seltenen Fällen, wenn ein Binärpaket (oder genauer: keines der
Binärpakete, die aus demselben Quellpaket gebaut wurden, die
zusammen als Gruppe verarbeitet werden) keine Changelog-Datei
enthält, führt apt-listchanges standardmäßig apt-get changelog aus,
um die Changelogs von den Netzwerkservern herunterzuladen. Sie
werden üblicherweise von der Distribution Ihres Betriebssystems
bereitgestellt. Diese Option wird dieses Verhalten deaktivieren,
was zum Beispiel für Systeme hinter einer Firewall nützlich sein
kann.
--save-seen=Datei
Diese Option wird Apt-listchanges veranlassen, die letzte Version
eines Pakets zu verfolgen, für das Changelogs angezeigt wurden, um
zu vermeiden, dass dieselben Changelogs bei einem zukünftigen
Aufruf erneut angezeigt werden. Die Datenbank wird in der genannten
Datei gespeichert. Geben Sie »none« an, um diese Funktionalität zu
deaktivieren.
--dump-seen
zeigt den Inhalt der Datenbank mit dem Gesehenen auf der
Standardausgabe als Liste. In den Zeilen stehen durch Leerzeichen
getrennt Quellpaketnamen und die zuletzt gesehene Version. Diese
Option benötigt den Pfad zur Datenbank mit dem Gesehenen: Bitte
geben Sie ihn mittels der Option --save-seen an oder übergeben Sie
die Option --profile=apt, damit er aus der Konfigurationsdatei
gelesen wird.
--since=Version
Diese Option wird Apt-listchanges veranlassen, die Einträge
anzuzeigen, die neuer als die angegebene Version sind. Das einzige
andere Argument, das Sie mit dieser Option übergeben können, ist
der Pfad zu einer .deb-Datei.
--latest=N
Diese Option wird Apt-listchanges veranlassen, nur die letzten N
Einträge anzuzeigen. Das einzige andere Argument, das Sie mit
dieser Option übergeben können, ist der Pfad zu einer .deb-Datei.
--which={news|changelogs|both}
Diese Option wählt aus, ob Neuigkeiten (von NEWS.Debian und
anderen), Changelogs (von changelog.Debian und anderen) oder beides
angezeigt werden soll. Standardmäßig werden nur Neuigkeiten
angezeigt.
--help
zeigt Syntaxinformationen.
-h, --headers
Diese Optionen werden Apt-listchanges veranlassen, eine Kopfzeile
vor jedem Paket-Changelog einzufügen, der den Namen des Pakets und
die Namen der Binärpakete anzeigt, von denen ein Upgrade
durchgeführt wird (falls es mehr als eines gibt oder der Name sich
von dem des Quellpakets unterscheidet).
--debug
zeigt einige Informationen zur Fehlersuche.
--profile=Name
wählt ein Optionsprofil aus. Name entspricht einem Abschnitt in
/etc/apt/listchanges.conf. Voreinstellung beim Aufruf von APT ist
»apt«, ansonsten »cmdline«.
--log=Datei
wählt die Datei aus, die von dem Protokollierungsprogramm angehängt
werden soll. Die Vorgabe ist /var/log/apt/listchanges.log. Die
Filter-Befehl-Option kann zur Veränderung der Ausgabe, bevor diese
an die Protokolldatei angehängt wird, verwandt werden. Bitte
stellten Sie sicher, dass eine Protokollrotation für diese Datei
einrichten.
--filter=Befehl
wählt den Befehl aus, der zum Filtern der Ausgabe verwandt werden
soll, bevor dieser durch das Protokollierungsprogramm an die
Protokolldatei gehängt wird. Stdin wird die Ausgabe von
apt-listchanges empfangen und Stdout wird an die Protokolldatei
angehängt werden. Trennen Sie Argumente durch Leerzeichen und
schließen Sie Argumente mit Leerzeichen in englische
Anführungszeichen ein. Der Befehl wird nur dann mittels der Shell
ausgeführt, wenn die Shell Teil des Befehlsnamens ist: sh -c 'date
; cat'
--reverse
zeigt die Changelog-Einträge in umgekehrter Reihenfolge.
--ignore-apt-assume, --ignore-debian-frontend
deaktiviert, dass eine nicht interaktive Oberfläche in einigen im
Abschnitt »AUTOMATISCHES AUßERKRAFTSETZEN VON OBERFLÄCHEN«
beschriebenen Fällen, erzwungen wird.
--titled, --untitled
aktiviert oder deaktiviert den Titel am Anfang der Ausgabe.
--select-frontend
wählt die Oberfläche interaktiv aus. Diese Option dient
hauptsächlich Testzwecken, bitte verwenden Sie sie nicht.
AUTOMATISCHES AUßERKRAFTSETZEN VON OBERFLÄCHEN
Für eine bessere Eingliederung in bestehende Paketverwaltungswerkzeuge
versucht apt-listchanges festzustellen, ob Paket-Upgrades auf eine
nicht interaktive Art durchgeführt wurden und ändert seine Oberfläche
automatisch zu »text«, wenn irgendeine der nachfolgenden Bedingungen
erfüllt ist:
• Die Standardausgabe ist nicht mit einem Terminal verbunden.
• Die Option --quiet (-q) wurde an apt-get(8) (oder aptitude(8))
übergeben. Beachten Sie jedoch, dass Apt-listchanges die Oberfläche
in »mail« ändert, wenn die Option mehrfach übergeben wurde.
• Die Option --assume-yes (-y) wurde an apt-get(8) übergeben.
• Die Umgebungsvariable DEBIAN_FRONTEND ist auf »noninteractive« und
APT_LISTCHANGES_FRONTED nicht gesetzt.
Aus Gründen der Rückwärtskompatibilität können die beiden letzten
Prüfungen oberhalb entweder mit den Konfigurationsdateieinträgen
»ignore_apt_assume=true« oder »ignore_debian_frontend=true« deaktiviert
werden (siehe »KONFIGURATIONSDATEI« weiter unten) oder mittels der
Befehlszeilenoptionen: --ignore-apt-assume oder
--ignore-debian-frontend.
Bitte beachten Sie, dass die Oberfläche »mail« bereits nichtinteraktiv
ist, weswegen sie nie zur Oberfläche »text« umgeschaltet wird.
Zusätzlich überschreibt apt-listchanges X11-basierte Oberflächen
(»gtk«, »xterm-pager«, »xterm-browser«) mit »pager« (oder »browser« im
Fall von »xterm-browser«), wenn die Umgebungsvariable DISPLAY nicht
gesetzt ist.
Bitte beachten Sie, dass diese stillen Oberflächen nicht folgenden
Außerkraftsetzungen unterliegen: syslog log
KONFIGURATIONSDATEI
apt-listchanges liest seine Konfiguration aus
/etc/apt/listchanges.conf. Die Datei besteht aus Abschnitten mit in
quadratische Klammern eingeschlossenen Namen. Jeder Abschnitt sollte
Zeilen im Format Schlüssel=Wert enthalten. Zeilen, die mit dem Zeichen
»#« beginnen, werden als Kommentar angesehen und ignoriert. Dateien mit
Namen Name.conf in dem Verzeichnis /etc/apt/listchanges.conf.d werden
auch auf die gleiche Art gelesen und setzen Werte, die in der
Hauptkonfigurationsdatei gesetzt sind, außer Kraft.
Abschnitt ist ein Profilname, der als Parameter für die Option
--profile benutzt werden kann.
Die Konfiguration des Abschnitts »apt« kann durch debconf(7) verwaltet
werden. Dort können auch die meisten Einstellungen miitels des Befehls
dpkg-reconfigure apt-listchanges geändert werden.
Schlüssel ist ein Name einer Befehlszeilenoption (außer für --apt,
--profile und --help) bei der die führenden Bindestriche entfernt und
die verbleibenden Bindestriche in Unterstriche umgewandelt werden, zum
Beispiel: »email_format« oder »save_seen«.
Wert steht für den Wert der entsprechenden Option. Für
Befehlszeilenoptionen, die kein Argument entgegennehmen, wie »confirm«
oder »headers«, sollte der Wert entweder zum Aktivieren auf »1«, »yes«,
»true« und »on« oder zum Deaktivieren auf »0«, »no«, »false« und »off«
gesetzt werden.
Zusätzlich kann Schlüssel eines der folgenden Schlüsselwörter sein:
»browser«, »pager« oder »xterm«. Der Wert eines derartigen
Konfigurationseintrags sollte der Name eines zugehörigen Befehls,
eventuell von seinen Argumenten gefolgt, sein zum Beispiel: »pager=less
-R«.
Beispiel 1. Beispielkonfigurationsdatei
[cmdline]
frontend=pager
[apt]
frontend=xterm-pager
email_address=root
confirm=1
[custom]
frontend=browser
browser=mozilla
Obige Konfigurationsdatei gibt an, dass die Standardoberfläche im
Befehlzeilenmodus »pager« sein soll. Im APT-Modus ist die
Xterm-Pager-Oberfläche voreingestellt, eine Kopie der Changelogs sollte
(falls vorhanden) per E-Mail an Root geschickt werden und
Apt-listchanges sollte um Bestätigung ersuchen. Falls Apt-listchanges
mit --profile=custom aufgerufen wird, soll die Browser-Oberfläche
benutzt und Mozilla aufgerufen werden.
UMGEBUNG
APT_LISTCHANGES_FRONTEND
Oberfläche, die benutzt werden soll
APT_LISTCHANGES_USER, SUDO_USER, USERNAME
Der Wert der ersten der obigen Variablen wird als Name des
Benutzers verwendet, zu dem gewechselt wird, wenn Befehle
ausgeführt werden, die durch die Oberflächen »browser«,
»xterm-browser« und »xterm-pager« hervorgebracht wurden, falls
apt-listchanges durch einen privilegierten Benutzer gestartet
wurde.
DEBIAN_FRONTEND
Falls es auf »noninteractive« gesetzt ist, kann es erzwingen, dass
apt-listchanges eine nicht interaktive Oberfläche benutzt.
Einzelheiten finden Sie im Abschnitt »AUTOMATISCHES
AUßERKRAFTSETZEN VON OBERFLÄCHEN«.
BROWSER
wird von der Browser-Oberfläche benutzt, sollte auf einen Befehl
gesetzt sein, der eine Datei erwartet: URL für eine HTML-Datei, die
angezeigt werden soll.
PAGER
von der Seitenanzeigeprogrammoberfläche (Pager) benutzt
APT_HOOK_INFO_FD
Dateideskriptor, um Paketnamen im Modus --apt daraus einzulesen.
(Es wird erwartet, dass APT diese Variable auf eine korrekte
Dateideskriptornummer setzt.)
DATEIEN
/etc/apt/listchanges.conf
Konfigurationsdatei
/etc/apt/listchanges.conf.d/*.conf
Dateien, zum Außerkraftsetzen von Konfigurationsdatei
/etc/apt/apt.conf.d/20listchanges
Datei, die zum Registrieren von Apt-listchanges im APT-System
benutzt wird
/var/lib/apt/listchanges.db
Datenbank, die für Save-seen benutzt wird
AUTOR
Apt-listchanges wurde von Matt Zimmerman <mdz@debian.org> geschrieben.
Der derzeitige Betreuer ist Robert Luberda <robert@debian.org>.
SIEHE AUCH
sensible-pager(1), sensible-browser(1), apt-get(8), aptitude(8)
ÜBERSETZUNG
Chris Leick <c.leick@vollbio.de>
apt-listchanges 2017-07-08 APT-LISTCHANGES(1)
Generated by dwww version 1.15 on Sat Jun 29 01:45:05 CEST 2024.