Provided by: debconf-i18n_1.5.26ubuntu3_all bug

НАЗВАНИЕ

       debconf-apt-progress - устанавливает пакеты используя debconf для
       показа индикатора выполнения

СИНТАКСИС

        debconf-apt-progress [--] команда [аргументы ...]
        debconf-apt-progress --config
        debconf-apt-progress --start
        debconf-apt-progress --from граница --to граница [--] команда [аргументы ...]
        debconf-apt-progress --stop

ОПИСАНИЕ

       debconf-apt-progress устанавливает пакеты, используя debconf с показом
       индикатора выполнения. Указанная  должна быть любой интерфейсной
       программой к apt, работающей в режиме командной строки; а именно, она
       должны уметь посылать информацию о ходе выполнения в файловый
       дескриптор, заданный параметром настройки "APT::Status-Fd", и должна
       держать открытыми файловые дескрипторы, назначенные в параметре
       настройки "APT::Keep-Fds" при вызове debconf (явно или неявно), так как
       эти файловые дескрипторы будут использоваться для работы с debconf.

       В передаваемых аргументах команды обычно должен указываться параметр -y
       (для apt-get или aptitude) или подобный ему, для того чтобы интерфейс к
       apt не предлагал вводить данные. debconf-apt-progress не может сделать
       это самостоятельно, так как нужный аргумент может различаться у разных
       интерфейсов apt.

       Параметры --start, --stop, --from и --to могут использоваться для
       создания многосегментного индикатора выполнения для разных стадий
       установки при условии, что запускающая сторона это debconf confmodule.
       Также, если требуется, запускающая сторона может самостоятельно
       взаимодействовать с индикатором выполнения через протокол debconf.

       При запуске debconf блокирует доступ к своей базе данных config, что к
       сожалению не даёт иметь один экземпляр debconf отображающий индикатор
       выполнения и другой, задающий вопросы из устанавливаемых пакетов. Если
       вы используете многосегментный индикатор, то для того чтобы обойти это
       ограничение требуется обрабатывать результат работы параметра --config
       перед запуском интерфейса debconf. Подробней смотрите в разделе ПРИМЕРЫ
       далее.

ПАРАМЕТРЫ

       --config
           Вывести переменные окружения, необходимые для запуска индикатора
           выполнения интерфейса.

       --start
           Запустить индикатор выполнения, по умолчанию отсчитывающий от 0 до
           100. Чтобы указать другие границы используйте --from и --to.

       --from 
           Если используется вместе со --start, то индикатор выполнения
           начинает отсчёт с , а не с 0.

           Иначе, при установке пакетов индикатор выполнения начинается со
           значения "границы". Должен использоваться с параметром --to.

       --to 
           Если используется вместе со --start, то индикатор выполнения
           заканчивает отсчёт по достижению , а не на 100.

           Иначе, при установке пакетов индикатор выполнения заканчивается на
           значении "границы". Должен использоваться с параметром --from.

       --stop
           Остановить запущенный индикатор выполнения.

       --no-progress
           Не запускать, останавливать или изменять индикатор выполнения.
           Сообщения о ходе выполнения от apt, события смены носителей и
           вопросы debconf всё равно будут проходить через debconf.

       --dlwaypoint 
           Задать, какой процент заполнения индикатора выполнения отвести на
           скачивание пакетов. Оставшаяся часть будет использована на показ
           установки пакетов. По умолчанию используется 15% на показ
           скачивания и оставшиеся 85% на установку.

       --logfile 
           Направить результат работы apt в указанный файл.

       --logstderr
           Послать нормальные результаты работы apt в поток ошибок stderr.
           Если вы не укажите --logfile или --logstderr, то нормальные
           результаты работы apt пропадут.

       --  Завершает параметры. Так как обычно нужно указать по крайней мере
           параметр -y для запускаемой команды, требуется использовать --,
           чтобы отделить эти параметры от параметров debconf-apt-progress.

ПРИМЕРЫ

       Установить рабочий стол GNOME и среду разработки для X window system с
       выводом индикатора выполнения:

        debconf-apt-progress -- aptitude -y install gnome x-window-system-dev

       Установить рабочие столы GNOME, KDE и XFCE с выводом индикатора
       выполнения, отдав по 45% индикатора выполнения GNOME и KDE, а
       оставшиеся 10% под XFCE:

        #! /bin/sh
        set -e
        case $1 in
          '')
            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

КОД ВОЗВРАТА

       Код, возвращаемый при возврате указанной команды, если пользователь не
       нажал клавишу отмены на индикаторе выполнения. Если кнопка отмены была
       нажата, то возвращается значение 30. Для избежания неоднозначности,
       если команда возвращает 30, то будет возвращаться значение 3.

АВТОРЫ

       Colin Watson <cjwatson@debian.org>

       Joey Hess <joeyh@debian.org>

                                  2009-03-24      DEBCONF-APT-PROGRESS.RU.1(1)