Provided by: dpkg_1.19.0.5ubuntu2.4_amd64 
NAZWA
update-alternatives - zarządzanie dowiązaniami symbolicznymi określającymi domyślne polecenia
SKŁADNIA
update-alternatives [opcja...] polecenie
OPIS
update-alternatives tworzy, usuwa, wyświetla informacje o dowiązaniach symbolicznych składających się na
system alternatyw Debiana oraz nimi zarządza.
Kilka programów mających tę samą lub podobną funkcjonalność może zostać zainstalowanych w systemie w tym
samym czasie. Na przykład w wielu systemach jest zainstalowanych jednocześnie kilka edytorów tekstu.
Stanowi to ułatwienie dla użytkowników takiego systemu, z których każdy może uruchomić inny edytor, jeśli
ma na to ochotę. Z drugiej strony jest to jednak utrudnienie dla programów chcących podjąć właściwą
decyzję, który edytor uruchomić, jeżeli użytkownik nie określił swoich preferencji co do edytora.
Celem systemu alternatyw Debiana jest rozwiązanie tego problemu. Ogólna nazwa w systemie plików jest
współdzielona przez wszystkie pliki dostarczające zmieniającą się funkcjonalność. System alternatyw oraz
administrator systemu określają, do którego obecnego pliku prowadzi ta ogólna nazwa. Na przykład, jeżeli
zainstalowano zarówno edytor ed(1) jak i nvi(1), to system alternatyw spowoduje, że nazwa ogólna
/usr/bin/editor będzie się odnosić do /usr/bin/nvi. Administrator systemu może zmienić to ustawienie na
/usr/bin/ed, a system alternatyw tego nie zmieni, chyba że administrator każe mu tak zrobić.
Nazwa ogólna nie jest bezpośrednim dowiązaniem symbolicznym do wybranej alternatywy, ale jest dowiązaniem
do pliku w katalogu alternatyw, które z kolei jest dowiązaniem do właściwego pliku. Jest tak zrobione
dlatego, żeby zmiany wprowadzane przez administratora systemu były ograniczone do katalogu /etc: standard
FHS wymienia powody, aby tak zrobić.
When each package providing a file with a particular functionality is installed, changed or removed,
update-alternatives is called to update information about that file in the alternatives system.
update-alternatives is usually called from the postinst (configure) or prerm (remove and deconfigure)
scripts in Debian packages.
Często użyteczne jest, aby pewna liczba alternatyw była zsynchronizowana, tak żeby była zmieniana jako
grupa. Na przykład jeżeli jest zainstalowane kilka wersji edytora vi(1), to strona podręcznika
/usr/share/man/man1/vi.1 powinna odpowiadać wersji programu zainstalowanego jako /usr/bin/vi.
update-alternatives obsługuje to przy pomocy dowiązań głównych i podrzędnych - zmiana dowiązania głównego
powoduje zmianę skojarzonych dowiązań podrzędnych. Dowiązanie główne i skojarzone z nim dowiązania
podrzędne tworzą grupę dowiązań.
Każda grupa dowiązań jest zawsze w jednym z dwóch trybów: automatycznym lub ręcznym. W trybie
automatycznym podczas instalacji lub usuwania pakietu system alternatyw automatycznie zdecyduje, czy i
jak aktualizować dowiązania. W trybie ręcznym system alternatyw nie będzie zmieniał dowiązań i zostawi
wszystkie decyzje administratorowi systemu.
Grupa dowiązań jest trybie automatycznym, kiedy jest po raz pierwszy wprowadzana do systemu. Jeżeli
administrator systemu wprowadzi zmiany do automatycznych ustawień, będą one wzięte pod uwagę podczas
następnego uruchomienia update-alternatives na takiej zmienionej grupie dowiązań, a grupa ta
automatycznie przejdzie w tryb ręczny.
Z każdą alternatywą skojarzony jest priorytet. Jeżeli grupa dowiązań jest w trybie automatycznym, to
wybraną alternatywą będzie ta, która ma najwyższy priorytet.
When using the --config option, update-alternatives will list all of the choices for the link group of
which given name is the master alternative name. The current choice is marked with a ‘*’. You will then
be prompted for your choice regarding this link group. Depending on the choice made, the link group
might no longer be in auto mode. You will need to use the --auto option in order to return to the
automatic mode (or you can rerun --config and select the entry marked as automatic).
Aby skonfigurować nieinteraktywnie, można użyć opcji --set (patrz niżej).
Różne pakiety dostarczające tych samych plików powinny współpracować ze sobą w tym zakresie. Oznacza to,
że używanie programu update-alternatives jest obowiązkowe dla wszystkich takich pakietów - nie jest
możliwe nadpisanie pewnych plików w pakiecie, który nie używa mechanizmu update-alternatives.
TERMINOLOGIA
Ponieważ operacje programu update-alternatives są dość złożone, poniżej podane są terminy, które pomogą
je zrozumieć.
nazwa ogólna (lub dowiązanie alternatywy)
Nazwa, taka jak /usr/bin/editor, która odnosi się przez system alternatyw do jednego z kilku
plików o podobnej funkcjonalności.
nazwa alternatywy
Nazwa dowiązania symbolicznego w katalogu alternatyw.
alternatywa (lub ścieżka alternatywy)
Nazwa określonego pliku w systemie plików, który w systemie alternatyw może być dostępny przez
nazwę ogólną.
katalog alternatyw
Katalog zawierający dowiązania symboliczne, domyślnie /etc/alternatives.
katalog administracyjny
Katalog zawierający informacje o stanie update-alternatives, domyślnie /var/lib/dpkg/alternatives.
grupa dowiązań
Zbiór powiązanych dowiązań symbolicznych, zarządzany jako grupa.
dowiązanie główne
Dowiązanie alternatywy w grupie dowiązań, które określa sposób konfigurowania innych dowiązań z
tej grupy.
dowiązanie podrzędne
Dowiązanie alternatywy w grupie dowiązań, które jest kontrolowane przez ustawienie głównego
dowiązania.
tryb automatyczny
Kiedy grupa dowiązań jest w trybie automatycznym, system alternatyw zapewni, że dowiązania z tej
grupy wskazują na alternatywę o najwyższym priorytecie.
tryb ręczny
Kiedy grupa dowiązań jest w trybie ręcznym, system alternatyw nic nie zmieni w ustawieniach
wprowadzonych przez administratora systemu.
POLECENIA
--install dowiązanie nazwa ścieżka priorytet [--slave dowiązanie nazwa ścieżka]...
Dodaje grupę alternatyw do systemu. dowiązanie jest ogólną nazwą głównego dowiązania, nazwa jest
nazwą dowiązania symbolicznego w katalogu alternatyw, a ścieżka jest wprowadzaną alternatywą dla
głównego dowiązania. Argumentami opcji --slave są nazwa ogólna, nazwa dowiązania symbolicznego w
katalogu alternatyw i ścieżka alternatywy dla dowiązania podrzędnego. Można podać zero lub więcej
opcji --slave, po każdej muszą następować jej trzy argumenty. Należy zauważyć, że główna
alternatywa musi istnieć, inaczej wywołanie się nie powiedzie. Jednak jeśli nie będzie istnieć
podrzędna alternatywa, odpowiednie dowiązanie podrzędne po prostu nie zostanie zainstalowane (ale
nadal będzie wyświetlane ostrzeżenie). Jeśli w miejscu gdzie powinno być zainstalowane dowiązanie
alternatywy istnieje rzeczywisty plik, jest on zachowywany, chyba że użyta jest opcja --force.
Jeżeli określona nazwa alternatywy już istnieje w systemie alternatyw, to podana informacja będzie
dodana jako nowy zbiór alternatyw dla tej grupy. W przeciwnym wypadku zostanie utworzona nowa
grupa, ustawiona w tryb automatyczny. Jeżeli grupa jest w trybie automatycznym, a priorytet nowo
dodawanych alternatyw jest większy od priorytetu każdej z innych zainstalowanych alternatyw w tej
grupie, to dowiązania symboliczne będą zaktualizowane tak, żeby prowadziły do nowo dodanych
alternatyw.
--set nazwa ścieżka
Ustawia program ścieżka jako alternatywę dla nazwy. Jest to nieinteraktywny, a więc możliwy do
użycia w skryptach, odpowiednik opcji --config.
--remove nazwa ścieżka
Usuwa alternatywę i wszystkie dowiązania podrzędne z nią skojarzone. nazwa jest nazwą w katalogu
alternatyw, ścieżka jest absolutną nazwą pliku, do której nazwa mogłaby być dowiązaniem. Jeżeli
nazwa rzeczywiście jest dowiązaniem do ścieżki, to nazwa zostanie zaktualizowana, tak żeby
wskazywała na inną odpowiednią alternatywę (zaś grupa jest ustawiana ponownie w tryb
automatyczny), albo zostanie usunięta jeżeli nie pozostanie ani jedna alternatywa. Skojarzone
dowiązania podrzędne zostaną odpowiednio zaktualizowane lub usunięte. Jeżeli dowiązanie nie
prowadzi obecnie do ścieżki, to żadne dowiązania nie będą aktualizowane; zostanie tylko usunięta
informacja o alternatywie.
--remove-all nazwa
Usuwa wszystkie dowiązania alternatyw i wszystkie skojarzone z nimi dowiązania podrzędne. nazwa
jest nazwą w katalogu alternatyw.
--all Wywołuje --config dla wszystkich alternatyw. Można to użytecznie połączyć z --skip-auto aby
przejrzeć i skonfigurować wszystkie alternatywy, które nie są skonfigurowane w tryb automatyczny.
Wyświetlane są również nieaktualne alternatywy. Dlatego prostym sposobem naprawienia uszkodzonych
alternatyw jest wywołanie yes ” | update-alternatives --force --all.
--auto nazwa
Przełącza grupę dowiązań dla alternatywy w tryb automatyczny. Podczas tego procesu, główne
dowiązanie wraz z jego dowiązaniami podrzędnymi będą zaktualizowane tak, aby wskazywać na
alternatywę o najwyższym priorytecie.
--display nazwa
Display information about the link group. Information displayed includes the group's mode (auto
or manual), the master and slave links, which alternative the master link currently points to,
what other alternatives are available (and their corresponding slave alternatives), and the
highest priority alternative currently installed.
--get-selections
List all master alternative names (those controlling a link group) and their status (since
version 1.15.0). Each line contains up to 3 fields (separated by one or more spaces). The first
field is the alternative name, the second one is the status (either auto or manual), and the last
one contains the current choice in the alternative (beware: it's a filename and thus might contain
spaces).
--set-selections
Read configuration of alternatives on standard input in the format generated by --get-selections
and reconfigure them accordingly (since version 1.15.0).
--query nazwa
Display information about the link group like --display does, but in a machine parseable way
(since version 1.15.0, see section QUERY FORMAT below).
--list nazwa
Wyświetla wszystkie cele w grupie dowiązań.
--config nazwa
Wyświetla dostępne alternatywy w grupie dowiązań i pozwala użytkownikowi interaktywnie wybrać,
której należy użyć. Grupa dowiązań zostanie odpowiednio zaktualizowana.
--help Wyświetla informację o użytkowaniu i kończy działanie.
--version
Wyświetla informację o wersji i pomyślnie kończy działanie.
OPCJE
--altdir katalog
Określa katalog alternatyw, jeżeli ma być inny niż domyślny.
--admindir katalog
Określa katalog administracyjny, jeżeli ma być inny niż domyślny.
--log plik
Specifies the log file (since version 1.15.0), when this is to be different from the default
(/var/log/alternatives.log).
--force
Allow replacing or dropping any real file that is installed where an alternative link has to be
installed or removed.
--skip-auto
Pomija pytania o konfigurację alternatyw, które są właściwie skonfigurowane w trybie
automatycznym. Ta opcja ma znaczenie tylko przy --config lub --all.
--verbose
Generate more comments about what is being done.
--quiet
Nie wyświetla żadnych komentarzy, chyba że wystąpi błąd.
KOD WYJŚCIA
0 Akcja zakończyła się powodzeniem.
2 Wystąpiły problemy podczas przetwarzania linii poleceń lub wykonywania akcji.
ŚRODOWISKO
DPKG_ADMINDIR
Jeśli ustawione oraz nie podano opcji --admindir, to będzie użyte jako bazowy katalog
administracyjny.
PLIKI
/etc/alternatives/
Domyślny katalog alternatyw. Można go zmienić opcją -altdir.
/var/lib/dpkg/alternatives/
Domyślny katalog administracyjny. Można go zmienić opcją -admindir.
FORMAT ZAPYTANIA
The --query format is using an RFC822-like flat format. It's made of n + 1 blocks where n is the number
of alternatives available in the queried link group. The first block contains the following fields:
Name: nazwa
Nazwa alternatywy w katalogu alternatyw.
Link: dowiązanie
Nazwa ogólna alternatywy.
Slaves: lista-alternatyw-podrzędnych
Gdy to pole jest obecne, następne wiersze zawierają wszystkie podrzędne dowiązania związane z
głównym dowiązaniem alternatywy. W każdym wierszu podana jest jedna podrzędna alternatywa. Każdy
wiersz zawiera jedną spację, ogólną nazwę alternatywy podrzędnej, kolejną spację i w końcu ścieżkę
do dowiązania podrzędnego.
Status: status
Status alternatywy (auto lub manual).
Best: najlepszy wybór
Ścieżka najlepszej alternatywy dla tej grupy dowiązań. Nie jest wyświetlana, jeśli nie ma
dostępnych żadnych alternatyw.
Value: aktualnie wybrana alternatywa
Ścieżka aktualnie wybranej alternatywy. Może również przyjmować specjalną wartość none - jest ona
używana jeśli dowiązanie nie istnieje.
Inne bloki opisują dostępne alternatywy w grupie dowiązań, do której odnosi się zapytanie:
Alternative: ścieżka-alternatywy
Ścieżka do alternatywy opisywanej w tym bloku.
Priority: wartość-priorytetu
Wartość priorytetu alternatywy.
Slaves: lista-alternatyw-podrzędnych
When this field is present, the next lines hold all slave alternatives associated to the master
link of the alternative. There is one slave per line. Each line contains one space, the generic
name of the slave alternative, another space, and the path to the slave alternative.
Example
$ update-alternatives --query editor
Name: editor
Link: /usr/bin/editor
Slaves:
editor.1.gz /usr/share/man/man1/editor.1.gz
editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz
editor.it.1.gz /usr/share/man/it/man1/editor.1.gz
editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz
editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz
Status: auto
Best: /usr/bin/vim.basic
Value: /usr/bin/vim.basic
Alternative: /bin/ed
Priority: -100
Slaves:
editor.1.gz /usr/share/man/man1/ed.1.gz
Alternative: /usr/bin/vim.basic
Priority: 50
Slaves:
editor.1.gz /usr/share/man/man1/vim.1.gz
editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz
editor.it.1.gz /usr/share/man/it/man1/vim.1.gz
editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz
editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz
DIAGNOSTYKA
Po podaniu --verbose, update-alternatives wypisuje nieustannie informacje o podejmowanych działaniach na
swoim standardowym wyjściu. Jeżeli wystąpi błąd, update-alternatives wyświetla komunikaty błędów na
standardowym wyjściu błędów i kończy działanie z kodem wyjścia 2. Wypisywana diagnostyka powinna wszystko
wyjaśniać, jeżeli tak nie jest, proszę zgłosić to jako błąd.
PRZYKŁADY
Istnieje klika pakietów, które dostarczają edytora tekstu kompatybilnego z edytorem vi, na przykład nvi i
vim. To, który pakiet będzie używany, kontrolowane jest przez grupę dowiązań vi, zawierającą dowiązania
do samego programu i odpowiadających mu stron podręcznika.
Aby wyświetlić listę dostępnych pakietów, które dostarczają vi oraz jego bieżące ustawienie, należy użyć
akcji --display:
update-alternatives --display vi
Aby wybrać określoną implementację edytora vi, należy użyć tego polecenia jako użytkownik root i wybrać
liczbę z listy:
update-alternatives --config vi
Aby przywrócić automatyczne wybieranie implementacji programu vi, należy jako użytkownik root wykonać:
update-alternatives --auto vi
ZOBACZ TAKŻE
ln(1), FHS - standard hierarchii systemu plików.
TŁUMACZE
Piotr Roszatycki <dexter@debian.org>, 1999
Bartosz Feński <fenio@debian.org>, 2004-2005
Robert Luberda <robert@debian.org>, 2006-2008
Wiktor Wandachowicz <siryes@gmail.com>, 2008
Michał Kułach <michal.kulach@gmail.com>, 2012
1.19.0.5 2022-05-25 update-alternatives(1)