[devel] [Fwd: Re: man update-alternatives]

[Dmitry V. Levin]

On Thu, Feb 22, 2001 at 01:07:46PM +0300, Aleksey Novodvorsky wrote:
> Господа, ознакомьтесь, пжста!

Отлично.
Я внес небольшие коррективы, можно (и нужно) поместить в пакеты
man-pages-ru-*.

> -------- Original Message --------
> Subject: Re: man update-alternatives
> Date: Thu, 22 Feb 2001 11:55:13 +0000
> From: Aleksandr Blohin <sass на uustoll.ee>
> To: Aleksey Novodvorsky <aen на logic.ru>
> 
> Готовый man.
> 
> --
> Best regards
> AB
> --
> 				... In nomine Altli, et Ctrli, et Spititus Deli, Reset!


Regards,
	Dmitry

+-------------------------------------------------------------------------+
Dmitry V. Levin     mailto://ldv@fandra.org
Software Engineer   PGP pubkey http://www.fandra.org/users/ldv/pgpkeys.html
IPLabs Linux Team   http://linux.iplabs.ru
Fandra Project      http://www.fandra.org
+-------------------------------------------------------------------------+
UNIX is user friendly. It's just very selective about who its friends are.
----------- следующая часть -----------
.\" update-alternatives.8
.\" This man page is copyright 1997 Charles Briscoe-Smith
.\" This is free documentation; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published
.\" by the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.  There is NO WARRANTY.
.TH UPDATE-ALTERNATIVES 8 "22 February 2001" "ALT Linux Team" "Linux-Mandrake RE"

.SH НАЗВАНИЕ
Подсистема
.B update-alternatives
обслуживает символические ссылки, определяющие команды, файлы и каталоги,
используемые по-умолчанию.

.SH СИНТАКСИС
.B update-alternatives
.RI [опции]
.B --install
.I link name path priority
.RB [ --slave
.I link name
.IR path] ...
.PP
.B update-alternatives 
.RI [опции] 
.B --remove
.I name path
.PP
.B update-alternatives
.RI [опции]
.B --auto
.I name
.PP
.B update-alternatives
.RI [опции]
.B --display
.I name
.PP
.B update-alternatives
.RI [опции]
.B --config
.I name

.PP
.SH ОПИСАНИЕ
.B update-alternatives
создает, удаляет, обслуживает и отображает информацию
о символических ссылках, входящих в подсистему альтернатив для Linux-Mandrake RE.
.PP
Это позволяет нескольким программам, установленным в системе одновременно,
выполнять одинаковые или похожие функции. Например, во многих системах
одновременно установлено несколько текстовых редакторов. Это дает
возможность всем пользователям системы, при желании, пользоваться
различными редакторами, но создает при этом сложности для системы
при вызове программы редактирования, если пользователь не определил
своих предпочтений.
.PP
Предназначение подсистемы альтернатив заключается в решении этих задач.
Универсальное имя в файловой системе разделено между всеми файлами,
предоставляющими взаимозаменяемые функциональные возможности. Система
альтернатив и системный администратор вместе определяют, к какому файлу
в системе происходит обращение при помощи универсального имени. Например,
если в системе одновременно установлены текстовые редакторы 
.BR ed(1)
и
.BR vim(1)
, то подсистема альтернатив обратится к универсальному имени
.I /usr/bin/editor
для вызова
.I /usr/bin/vim
по-умолчанию. Системный администратор может изменить параметры так, что вместо этого будет произведен вызов
.I /usr/bin/ed
, и подсистема альтернатив не изменит эти установки до тех пор,
пока об этом не последует явный запрос.
.PP
Универсальное имя - это не прямая символическая ссылка к выбранной альтернативе.
Вместо этого создается символическая ссылка в
.I каталоге
.IR альтернатив
, которая, в свою очередь, ссылается на конкретный файл. Это сделано
для того, чтобы изменения, сделанные системным администратором, ограничивались
только каталогом
.I /etc
: FHS дает основания считать это хорошей идеей.
.PP
Если пакет, предоставляющий файл со специфическими функциями, установлен,
изменен или удален, вызывается
.BR update-alternatives
для обновления информации об этом файле, содержащемся в подсистеме альтернатив. Вызов
.BR update-alternatives
обычно происходит посредством вызова
.B post-install
или
.B pre-install
скрипта, содержащегося в пакете RPM.
.PP
Зачастую бывает полезно синхронизировать изменение нескольких альтернатив,
образующих группу; например, если в системе установлено несколько
версий редактора
.BR vi(1)
, то man-страница
.I /usr/share/man/man1/vi.1
должна соответствовать альтернативе, определяемой
.IR /usr/bin/vi
Подсистема
.B update-alternatives
управляет этим посредством
.I главных (master)
и
.I подчиненных (slave)
ссылок; если изменяется главная ссылка, подчиненные ссылки тоже изменяются.
Главная ссылка и ассоциированные с ней подчиненные образуют
.I группу
.IR ссылок.
.PP
Каждая группа ссылок в любой момент времени может находиться в одном
из двух режимов: автоматическом или не автоматическом. Если группа
находится в автоматическом режиме, при установке, обновлении и удалении пакетов
подсистема альтернатив сама решает, какие из ссылок требуется обновить
и как. В не автоматическом режиме подсистема альтернатив не делает изменений ссылок,
оставляя их на усмотрение системного администратора.
.PP
Каждая группа ссылок при первой установке в систему находится в автоматическом
режиме. Если системный администратор вносит изменения в автоматические
установки системы, то
.B update-alternatives
при очередном запуске обнаружит изменении группы ссылок и автоматически перейдет в не автоматический режим. 
.PP
Каждая альтернатива имеет ассоциированный с ней
.I приоритет
- когда группа ссылок находится в автоматическом режиме, то альтернативами, указанными
членами группы, будут те, которые имеют наивысший приоритет.
.PP
При использовании опции
.I --config
.B update-alternatives
перечислит весь
список вариантов в группе ссылок, соответствующий
.I главной
ссылке. Вам будет предложено определить, какой из вариантов вы желаете использовать.
Если вы однажды сделаете изменения, то группа ссылок больше не будет
работать в
.I автоматическом
режиме. Для возврата к автоматическому режиму
вам необходимо использовать опцию
.I --auto

.PP
.SH ТЕРМИНОЛОГИЯ
Так как
.B update-alternatives
представляет из себя довольно сложный механизм,
то некоторые термины помогут объяснить его действие:
.TP
универсальное имя
Имя, например, 
.IR /usr/bin/editor
, которое обращается посредством подсистемы альтернатив
к одному из нескольких файлов со схожими функциями.
.TP
символическая ссылка
Без каких-либо дополнительных определений это означает ссылку в каталог
альтернатив - каталог, который может корректировать системный администратор.
.TP
альтернатива
Имя конкретного файла в файловой системе, который может быть доступен через
универсальное имя, используя подсистему альтернатив.
.TP
каталог альтернатив
Каталог, по умолчанию это
.IR /etc/alternatives
, содержащий символические ссылки.
.TP
административный каталог
Каталог, по умолчанию это
.IR /var/lib/rpm/alternatives
, содержащий информацию о состоянии подсистемы
.BR update-alternatives
.TP
группа ссылок
Набор взаимосвязанных ссылок, подлежащих синхронной модификации.
.TP
главная ссылка
Ссылка в группе ссылок, определяющая конфигурацию остальных ссылок
в группе.
.TP
подчиненная ссылка
Ссылка в группе ссылок, контролируемая значением главной ссылки.
.TP
автоматический режим
Когда группа ссылок находится в автоматическом режиме, подсистема альтернатив
следит, что бы ссылка в группе указывала на альтернативу, имеющую
наивысший приоритет в группе.
.TP
не автоматический режим
Кагда группа ссылок находится в не автоматическом режиме, подсистема альтернатив
не делает никаких изменений в установках системного администратора.

.PP
.SH ОПЦИИ
При вызове
.B update-alternatives
должно быть определено ровно одно действие, которое должно быть выполнено.
Любое число параметров может быть указано в комбинации с любым действием.
.SS ПАРАМЕТРЫ
.TP
.B --verbose
Выводит подробности о действиях
.B update-alternatives.
.TP
.B --quiet
Не выводит на экран никаких сообщений о работе, кроме сообщений об
ошибках.
.TP
.B --test
Не предпринимать реальных действий, только показать, что будет сделано.
Эта функция еще не реализована.
.TP
.B --help
Вывести информацию об использовании (и показать версию
.B update-alternatives
).
.TP
.B --version
Показать версию
.B update-alternatives
(и отобразить информацию об использовании).
.TP
\fB--altdir\fR \fIкаталог\fR
Определяет каталог альтернатив, отличный от используемого по умолчанию.
.TP
\fB--admindir\fR \fIкаталог\fR
Определяет административный каталог, отличный от используемого по умолчанию.
.SS ДЕЙСТВИЯ
.TP
\fB--install\fR \fIlink gen path pri\fR [\fB--slave\fR \fIslink sgen spath\fR] ...
Добавляет группу альтернатив в систему.
.I gen
- универсальное имя для главной ссылки,
.I link
- имя этой ссылки,
.I path
- альтернатива для главной ссылки.
.IR sgen
,
.I slink
и
.I spat
это универсальное имя, ссылка и альтернатива для подчиненной ссылки.
Может быть определено до трех действий
.B --slave
, каждое из которых может иметь до трех аргументов.
.IP
Если указанная главная ссылка уже присутствует в подсистеме альтернатив,
то информация будет добавлена как новый набор альтернатив
для группы. В противном случае будет добавлена новая группа, установленная
в автоматический режим работы. Если группа находится в автоматическом
режиме и вновь добавленные альтернативы имеют более высокий приоритет,
чем уже существующие в этой группе, то символические ссылки будут
обновлены с учетом новых альтернатив.
.TP
\fB--remove\fR \fIname path\fR
Удаляет альтернативы и все ассоциированные с ними подчиненные ссылки.
.I name
- это имя в каталоге альтернатив, а
.I path
- это абсолютное имя
файла, на которое ссылается
.I name
. Если name действительно ссылается
на
.IR path
, то
.I name
будет обновлено, для указания на ближайшую альтернативу,
или удалено, в случае, если больше не осталось альтернатив. Ассоциированные
подчиненные ссылки будут, соответственно, обновлены или удалены.
Если ссылка указывает не на
.IR path ,
то ссылка не будет изменена; будет удалена только информация об альтернативе.
.TP
\fB--auto\fR \fIlink\fR
Переключает главную ссылку
.I link в автоматический режим. При этом как сама ссылка, так и все ее подчиненные ссылки
будут обновлены тиким образом, что будут указывать на альтернативы с наивысшим приоритетом.
.TP
\fB--display\fR \fIlink\fR
Отображает информацию о группе ссылок, где
.IR link
является главной ссылкой.
Отображаемая информация содержит режим группы (автоматический или
не автоматический), на какую альтернативу в настоящий момент указывает
ссылка, какие другие альтернативы доступны (и их соответствующие подчиненные
альтернативы), а так же альтернативу, имеющую наивысший приоритет из всех
установленных в подсистеме альтернатив.

.PP
.SH ФАЙЛЫ
.TP
.I /etc/alternatives/
Каталог альтернатив по умолчанию. Может быть изменен при помощи опции 
.B --altdir
.TP
.I /var/lib/rpm/alternatives/
Административный каталог по умолчанию. Может быть изменен при помощи опции
.B --admindir

.PP
.SH КОДЫ ВОЗВРАТА
.IP 0
Требуемое действие было успешно выполнено.
.IP 2
Возникли проблемы в синтаксисе командной строки или при выполнении
действия.

.PP
.SH ДИАГНОСТИКА
.B update-alternatives
, если не было обнаружено ошибок, не сообщает о
своих действиях в стандартный вывод. Если же
.B update-alternatives
сталкивается
с проблемой, то он выводит сообщение об ошибке и прекращает свою работу
с кодом выхода 2. Эта диагностика должна быть очевидна; если вы находите,
что это не так, пожалуйста, сообщите об этом как об ошибке.

.PP
.SH ОШИБКИ
Если вы обнаружите ошибку, пожалуйста, сообщите об этом в систему слежения
за ошибками Linux-Mandrake RE, или, если это невозможно, отправьте
сообщение авторам электронной почтой.
.PP
Если вы найдете любое расхождение между работой
.B update-alternatives
и настоящим руководством, то это ошибка реализации либо документации и перевода;
пожалуйста, сообщите об этом.

.PP
.SH АВТОРЫ
Подсистема
.B update-alternatives
основана на Debian update-alternatives.
.nf
Ian Jackson - автор Debian update-alternatives.
Charles Briscoe-Smith - автор этой документации.
Aleksandr Blohin <sass на uustoll.ee> - перевод на русский язык.
Dmitry V. Levin <ldv на fandra.org> - адаптация для Linux-Mandrake RE.
.fi

.PP
.SH АВТОРСКИЕ ПРАВА
Это свободное программное обеспечение;
см. GNU General Public License версии 2 или позже в части, касающейся
авторского права. Поставляется БЕЗ предоставления каких либо гарантий.

.PP
.SH СМ. ТАКЖЕ
.BR ln(1)
, FHS - the Filesystem Hierarchy Standard.
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 232 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/devel/attachments/20010222/1fb98e50/attachment-0001.bin>