update-alternatives(1) dpkg suite update-alternatives(1)
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 following Debian package
maintainer scripts, postinst (configure) to install the alternative and
from prerm and postrm (remove) to remove the alternative. Note: in
most (if not all) cases no other maintainer script actions should call
update-alternatives, in particular neither of upgrade nor disappear, as
any other such action can lose the manual state of an alternative, or
make the alternative temporarily flip-flop, or completely switch when
several of them have the same priority.
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
Set the program path as alternative for name. This is equivalent
to --config but is non-interactive and thus scriptable.
--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
Specifies the alternatives directory, when this is to be different
from the default. Defaults to «/etc/alternatives».
--admindir katalog
Specifies the administrative directory, when this is to be
different from the default. Defaults to
«/var/lib/dpkg/alternatives»
--instdir directory
Specifies the installation directory where alternatives links will
be created (since version 1.20.1). Defaults to «».
--root directory
Specifies the root directory (since version 1.20.1). This also
sets the alternatives, installation and administrative directories
to match. Defaults to «».
--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.
--quiet
Do not generate any comments unless errors occur.
--verbose
Generate more comments about what is being done.
--debug
Generate even more comments, helpful for debugging, about what is
being done (since version 1.19.3).
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 (the Filesystem Hierarchy Standard).
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.21.1 2024-02-23 update-alternatives(1)
Generated by dwww version 1.14 on Wed Aug 27 14:01:20 CEST 2025.