Update-alternatives/Manpage

BEFEHLE

--install Link Name Pfad Priorität [--slave Link Name Pfad] … Fügt eine Gruppe von Alternativen zum System hinzu. Link ist der generische Name des Master-Links, Name ist der Name seines Symlinks im Alternativ-Verzeichnis und Pfad ist die Alternative, die für den Master-Link eingeführt wird. Die Argumente nach --slave sind der generische Name, Symlink-Name in dem Alternativ-Verzeichnis und der Alternativ-Pfad für den Slave-Link. Null oder mehrere --slave-Optionen, jede von drei Argumenten gefolgt, können spezifiziert werden. Beachten Sie, dass die Master-Alternative existieren muss, ansonsten schlägt der Aufruf fehl. Falls allerdings eine Slave-Alternative nicht existiert, wird der zugehörige Slave-Alternative-Link einfach nicht installiert (es wird noch eine Warnung ausgegeben). Falls eine echte Datei an einer Stelle installiert wird, an der ein Alternativ-Link installiert werden muss, wird diese beibehalten, solange --force nicht verwandt wird.

Falls der angegebene Alternativ-Name bereits in den Aufzeichnungen des Alternativ-Systems existiert, werden die angegebenen Informationen als neuer Satz von Alternativen für die Gruppe hinzugefügt. Andernfalls wird eine neue Gruppe, eingestellt im automatischen Modus, mit dieser Information hinzugefügt. Falls die Gruppe sich im automatischen Modus befindet und die Priorität der neu hinzugefügten Alternative höher ist als die jeder anderen installierten Alternative für diese Gruppe, werden die Symlinks aktualisiert, so dass sie auf die neu hinzugefügte Alternative zeigen.

--set Name Pfad Setzt das Programm Pfad als Alternative für Name. Dies ist äquivalent zu --config, ist aber nicht interaktiv und kann somit geskriptet werden.

--remove Name Pfad Entfernt eine Alternative und alle zugehörigen Slave-Links. Name ist ein Name im Alternativ-Verzeichnis, und Pfad ist ein absoluter Dateiname, zu dem Name gelinkt werden könnte. Falls Name tatsächlich nach Pfad gelinkt ist, dann wird Name aktualisiert, um auf eine andere geeignete Alternative zu zeigen (und die Gruppe wird wieder in den automatischen Modus versetzt) oder entfernt, falls keine solche Alternative übrig bleibt. Zugehörige Slave-Links werden entsprechend aktualisiert oder entfernt. Falls der Link derzeit nicht auf Pfad zeigt, werden keine Links geändert; nur die Information über die Alternative wird entfernt.

--remove-all Name Entfernt alle Alternativen und deren zugehörige Slave-Links. Name ist ein Name im Alternativ-Verzeichnis.

--all Ruft --config für alle Alternativen auf. In der Kombination mit --skip-auto kann dies nützlich sein, um alle Alternativen zu prüfen und zu konfigurieren, die sich nicht im automatischen Modus befinden. Defekte Alternativen werden auch angezeigt. Ein Aufruf von yes | update- alternatives --force --all ist daher eine einfache Art, um alle defekten Alternativen zu reparieren.

--auto Name Überführt die Linkgruppe hinter der Alternative mit Name Name in den automatischen Modus. Bei diesem Prozess werden der Master-Symlink und seine Slave-Links aktualisiert, um auf die installierte Alternative mit höchster Priorität zu zeigen.

--display Name Zeigt Informationen über die Linkgruppe an. Die angezeigten Informationen enthalten den Modus der Gruppe (automatisch oder manuell), die Master- und Slave-Links, auf welche Alternative der Master-Link derzeit zeigt, welche weiteren Alternativen zur Verfügung stehen (und ihre zugehörigen Slave-Alternativen), und die installierte Alternative mit der höchsten Priorität.

--get-selections Führt alle Master-Alternativ-Namen (die eine Linkgruppe steuern) mit ihrem Status auf (seit Version 1.15.0). Jede Zeile enthält bis zu 3 Felder (getrennt durch mindestens ein Leerzeichen). Im ersten Feld steht der Alternativ-Name, im zweiten der Status (entweder auto oder manual) und im letzten die derzeitige Wahl der Alternative (Achtung: Dies ist ein Dateiname, der Leerzeichen enthalten kann).

--set-selections Liest eine Konfiguration von Alternativen über die Standardeingabe im von "--get-selections" generierten Format und konfiguriert die Alternativen entsprechend neu (seit Version 1.15.0).

--query Name Zeigt alle Informationen über die Linkgruppe an, wie dies auch von --display erfolgt, allerdings in einem maschinenlesbaren Format (seit Version 1.15.0, siehe nachfolgenden Abschnitt ABFRAGE-FORMAT).

--list Name Zeigt alle Ziele der Linkgruppe an.

--config Name Zeigt die verfügbaren Alternativen für eine Linkgruppe an und erlaubt es dem Benutzer, interaktiv auszuwählen, welche zu benutzen ist. Die Linkgruppe wird aktualisiert.

--help Zeigt einen Hinweis zum Aufruf und beendet das Programm.

--version Gibt die Version aus und beendet das Programm.

OPTIONEN

--altdir Verzeichnis Spezifiziert das Alternativ-Verzeichnis, wenn sich dieses von der Standardeinstellung unterscheiden soll. Vorgabe ist "/etc/alternatives".

--admindir Verzeichnis Spezifiziert das administrative Verzeichnis, wenn sich dieses von der Standardeinstellung unterscheiden soll. Vorgabe ist "/var/lib/dpkg/alternatives", falls DPKG_ADMINDIR nicht gesetzt wurde.

--instdir Verzeichnis Spezifiziert das Installationsverzeichnis, in dem Alternatives-Links erstellt werden (seit Dpkg 1.20.1). Standardmäßig "/", falls DPKG_ROOT nicht gesetzt wurde.

--root Verzeichnis Spezifiziert das Wurzelverzeichnis (seit Version 1.201.). Dies setzt auch passend die Alternatives-, Installations- und administrativen Verzeichnisse. Standardmäßig "/", falls DPKG_ROOT nicht gesetzt wurde.

--log Datei Gibt die Protokolldatei an (seit Version 1.15.0), wenn diese sich von der Vorgabe (/var/log/alternatives.log) unterscheiden soll.

--force Erlaubt die Ersetzung oder Entfernung von echten Dateien, die sich an Stellen befinden, an denen ein Alternativ-Link installiert werden muss.

--skip-auto Überspringt die Konfigurationsabfrage für Alternativen, die korrekt im automatischen Modus konfiguriert sind. Diese Option ist nur mit --config oder --all relevant.

--quiet Erzeugt keine Kommentare, es sei denn, ein Fehler tritt auf.

--verbose Erzeugt mehr Kommentare darüber, was getan wird.

--debug Erzeugt mehr Kommentare darüber, hilfreich für die Fehlersuche, was getan wird (seit Version 1.19.3).

DATEIEN

/etc/alternatives/

Das standardmäßige Alternativ-Verzeichnis. Kann mittels der Option --altdir geändert werden.

/var/lib/dpkg/alternatives/

Das standardmäßige administrative Verzeichnis. Kann mittels der --admindir Option geändert werden.

ABFRAGE-FORMAT

Das Format von --query ist ein RFC822-artiges, flaches Format. Es besteht aus n+1 Blöcken, wobei n die Anzahl der in einer abgefragten Linkgruppe verfügbaren Alternativen ist.

Der erste Block enthält die folgenden Felder:

Name: Name Der alternative Name im Alternativ-Verzeichnis.
Link: Link Der generische Name der Alternative.
Slaves: Liste-von-Slaves Wenn diese Feld vorhanden ist, enthält die nächste Zeile alle Slave-Links, die dem Master-Link dieser Alternativen zugeordnet sind. Pro Zeile wird ein Slave aufgeführt. Jede Zeile enthält ein Leerzeichen, den generischen Namen des Slaves, ein weiteres Leerzeichen und den Pfad zu dem Slave-Link.
Status: Status Der Status der Alternative (auto oder manual).
Best: beste-Wahl Der Pfad der besten Alternative für diese Linkgruppe. Nicht vorhanden, falls keine Alternative verfügbar ist.
Value: derzeit-ausgewählte-Alternative Der Pfad der derzeit ausgewählten Alternative. Es akzeptiert auch den magischen Wert none, der verwandt wird, falls der Link nicht existiert.

Die anderen Blöcke beschreiben die verfügbaren Alternativen in der abgefragten Linkgruppe:

Alternative: Pfad-dieser-Alternativen Pfad zu der Alternative dieses Blocks.
Priority: Prioritätswert Wert der Priorität dieser Alternativen.
Slaves: Liste-von-Slaves Wenn dieses Feld vorhanden ist, enthält die nächste Zeile alle Slave-Alternativen, die dem Master-Link dieser Alternativen zugeordnet sind. Pro Zeile wird ein Slave aufgeführt. Jede Zeile enthält ein Leerzeichen, den generischen Namen des Slaves, ein weiteres Leerzeichen und den Pfad zu der Slave-Alternative.