.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DEBCONF-APT-PROGRESS.RU.1 1"
.TH DEBCONF-APT-PROGRESS.RU.1 1 "2019-02-26" "" "Debconf"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "НАЗВАНИЕ"
.IX Header "НАЗВАНИЕ"
debconf-apt-progress \- устанавливает пакеты используя debconf для показа
индикатора выполнения
.SH "СИНТАКСИС"
.IX Header "СИНТАКСИС"
.Vb 5
\& debconf\-apt\-progress [\-\-] команда [аргументы ...]
\& debconf\-apt\-progress \-\-config
\& debconf\-apt\-progress \-\-start
\& debconf\-apt\-progress \-\-from граница \-\-to граница [\-\-] команда [аргументы ...]
\& debconf\-apt\-progress \-\-stop
.Ve
.SH "ОПИСАНИЕ"
.IX Header "ОПИСАНИЕ"
\&\fBdebconf-apt-progress\fR устанавливает пакеты, используя debconf с показом
индикатора выполнения. Указанная \fIкоманда\fR должна быть любой интерфейсной
программой к apt, работающей в режиме командной строки; а именно, она должны
уметь посылать информацию о ходе выполнения в файловый дескриптор, заданный
параметром настройки \f(CW\*(C`APT::Status\-Fd\*(C'\fR, и должна держать открытыми файловые
дескрипторы, назначенные в параметре настройки \f(CW\*(C`APT::Keep\-Fds\*(C'\fR при вызове
debconf (явно или неявно), так как эти файловые дескрипторы будут
использоваться для работы с debconf.
.PP
В передаваемых аргументах команды обычно должен указываться параметр \fB\-y\fR
(для \fBapt-get\fR или \fBaptitude\fR) или подобный ему, для того чтобы интерфейс
к apt не предлагал вводить данные. \fBdebconf-apt-progress\fR не может сделать
это самостоятельно, так как нужный аргумент может различаться у разных
интерфейсов apt.
.PP
Параметры \fB\-\-start\fR, \fB\-\-stop\fR, \fB\-\-from\fR и \fB\-\-to\fR могут использоваться
для создания многосегментного индикатора выполнения для разных стадий
установки при условии, что запускающая сторона это debconf
confmodule. Также, если требуется, запускающая сторона может самостоятельно
взаимодействовать с индикатором выполнения через протокол debconf.
.PP
При запуске debconf блокирует доступ к своей базе данных config, что к
сожалению не даёт иметь один экземпляр debconf отображающий индикатор
выполнения и другой, задающий вопросы из устанавливаемых пакетов. Если вы
используете многосегментный индикатор, то для того чтобы обойти это
ограничение требуется обрабатывать результат работы параметра \fB\-\-config\fR
перед запуском интерфейса debconf. Подробней смотрите в разделе ПРИМЕРЫ
далее.
.SH "ПАРАМЕТРЫ"
.IX Header "ПАРАМЕТРЫ"
.IP "\fB\-\-config\fR" 4
.IX Item "--config"
Вывести переменные окружения, необходимые для запуска индикатора выполнения
интерфейса.
.IP "\fB\-\-start\fR" 4
.IX Item "--start"
Запустить индикатор выполнения, по умолчанию отсчитывающий от 0 до
100. Чтобы указать другие границы используйте \fB\-\-from\fR и \fB\-\-to\fR.
.IP "\fB\-\-from\fR \fIграница\fR" 4
.IX Item "--from граница"
Если используется вместе со \fB\-\-start\fR, то индикатор выполнения начинает
отсчёт с \fIграницы\fR, а не с 0.
.Sp
Иначе, при установке пакетов индикатор выполнения начинается со значения
«границы». Должен использоваться с параметром \fB\-\-to\fR.
.IP "\fB\-\-to\fR \fIграница\fR" 4
.IX Item "--to граница"
Если используется вместе со \fB\-\-start\fR, то индикатор выполнения заканчивает
отсчёт по достижению \fIграницы\fR, а не на 100.
.Sp
Иначе, при установке пакетов индикатор выполнения заканчивается на значении
«границы». Должен использоваться с параметром \fB\-\-from\fR.
.IP "\fB\-\-stop\fR" 4
.IX Item "--stop"
Остановить запущенный индикатор выполнения.
.IP "\fB\-\-no\-progress\fR" 4
.IX Item "--no-progress"
Не запускать, останавливать или изменять индикатор выполнения. Сообщения о
ходе выполнения от apt, события смены носителей и вопросы debconf всё равно
будут проходить через debconf.
.IP "\fB\-\-dlwaypoint\fR \fIпроцент\fR" 4
.IX Item "--dlwaypoint процент"
Задать, какой процент заполнения индикатора выполнения отвести на скачивание
пакетов. Оставшаяся часть будет использована на показ установки пакетов. По
умолчанию используется 15% на показ скачивания и оставшиеся 85% на
установку.
.IP "\fB\-\-logfile\fR \fIфайл\fR" 4
.IX Item "--logfile файл"
Направить результат работы apt в указанный файл.
.IP "\fB\-\-logstderr\fR" 4
.IX Item "--logstderr"
Послать нормальные результаты работы apt в поток ошибок stderr. Если вы не
укажите \fB\-\-logfile\fR или \fB\-\-logstderr\fR, то нормальные результаты работы apt
пропадут.
.IP "\fB\-\-\fR" 4
.IX Item "--"
Завершает параметры. Так как обычно нужно указать по крайней мере параметр
\&\fB\-y\fR для запускаемой команды, требуется использовать \fB\-\-\fR, чтобы отделить
эти параметры от параметров \fBdebconf-apt-progress\fR.
.SH "ПРИМЕРЫ"
.IX Header "ПРИМЕРЫ"
Установить рабочий стол \s-1GNOME\s0 и среду разработки для X window system с
выводом индикатора выполнения:
.PP
.Vb 1
\& debconf\-apt\-progress \-\- aptitude \-y install gnome x\-window\-system\-dev
.Ve
.PP
Установить рабочие столы \s-1GNOME, KDE\s0 и \s-1XFCE\s0 с выводом индикатора выполнения,
отдав по 45% индикатора выполнения \s-1GNOME\s0 и \s-1KDE,\s0 а оставшиеся 10% под \s-1XFCE:\s0
.PP
.Vb 10
\& #! /bin/sh
\& set \-e
\& case $1 in
\&   \*(Aq\*(Aq)
\&     eval "$(debconf\-apt\-progress \-\-config)"
\&     "$0" debconf
\&     ;;
\&   debconf)
\&     . /usr/share/debconf/confmodule
\&     debconf\-apt\-progress \-\-start
\&     debconf\-apt\-progress \-\-from 0 \-\-to 45 \-\- apt\-get \-y install gnome
\&     debconf\-apt\-progress \-\-from 45 \-\-to 90 \-\- apt\-get \-y install kde
\&     debconf\-apt\-progress \-\-from 90 \-\-to 100 \-\- apt\-get \-y install xfce4
\&     debconf\-apt\-progress \-\-stop
\&     ;;
\& esac
.Ve
.SH "КОД ВОЗВРАТА"
.IX Header "КОД ВОЗВРАТА"
Код, возвращаемый при возврате указанной команды, если пользователь не нажал
клавишу отмены на индикаторе выполнения. Если кнопка отмены была нажата, то
возвращается значение 30. Для избежания неоднозначности, если команда
возвращает 30, то будет возвращаться значение 3.
.SH "АВТОРЫ"
.IX Header "АВТОРЫ"
Colin Watson <cjwatson@debian.org>
.PP
Joey Hess <joeyh@debian.org>