.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "DEBCONF-APT-PROGRESS 1"
.TH DEBCONF-APT-PROGRESS 1 "2008-07-02" "debconf/1.5.22" "Debian"
.SH "NAME"
debconf\-apt\-progress \- installiere Pakete unter Benutzung von Debconf, um
einen Fortschrittsbalken anzuzeigen
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
.Vb 5
\& debconf\-apt\-progress [\-\-] command [args ...]
\& debconf\-apt\-progress \-\-config
\& debconf\-apt\-progress \-\-start
\& debconf\-apt\-progress \-\-from waypoint \-\-to waypoint [\-\-] command [args ...]
\& debconf\-apt\-progress \-\-stop
.Ve
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
\&\fBdebconf-apt-progress\fR installiert Pakete unter Benutzung von Debconf, um
einen Fortschrittsbalken anzuzeigen. Der angegebene \fIBefehl\fR sollte
irgendein APT-FrontEnd der Befehlszeile sein; insbesondere muss es
Fortschrittsinformationen auf den durch die Konfigurationsoption
\&\f(CW\*(C`APT::Status\-Fd\*(C'\fR gewählten Datei-Deskriptor schicken, und es muss die von
der Konfigurationsoption \f(CW\*(C`APT::Keep\-Fds\*(C'\fR genannten Datei-Deskriptoren offen
halten, wenn es Debconf (direkt oder indirekt) aufruft, weil diese
Datei-Deskriptoren für das Debconf-Durchleitungs-Protokoll genutzt werden.
.PP
Die Argumente für den angegebenen Befehl sollten generell \fB\-y\fR (bei
\&\fBapt-get\fR oder \fBaptitude\fR) oder ähnliches enthalten, um zu vermeiden,
dass das APT-FrontEnd nach Eingabe fragt.  \fBdebconf-apt-progress\fR kann dies
nicht von sich aus machen, weil sich das entsprechende Argument von FrontEnd
zu FrontEnd unterscheiden mag.
.PP
Die Optionen \fB\-\-start\fR, \fB\-\-stop\fR, \fB\-\-from\fR und \fB\-\-to\fR können benutzt
werden, um einen Fortschrittsbalken mit mehreren Abschnitten für
verschiedene Phasen der Installation zu erzeugen, vorausgesetzt, der
Aufrufer ist ein Debconf\-Confmodul. Der Aufrufer kann auch mit dem
Fortschrittsbalken selbst unter Benutzung des Debconf-Protokolls
interagieren, falls es dies wünscht.
.PP
Debconf sperrt seine Konfigurationsdatenbank, wenn es startet, was es
unglücklicherweise unbequem macht, eine Instanz von Debconf den
Fortschrittsbalken anzeigen und eine andere Fragen der installierten Pakete
durchleiten zu lassen.  Falls Sie einen mehr-segmentigen Fortschrittsbalken
benutzen, müssen Sie die Ausgabe der Option \fB\-\-config\fR auswerten, bevor
Sie das Debconf-FrontEnd starten, um dies zu umgehen.  Siehe unten \*(L"\s-1BEISPIELE\s0\*(R" in den Abschnitt \s-1BEISPIELE\s0.
.SH "OPTIONEN"
.IX Header "OPTIONEN"
.IP "\fB\-\-config\fR" 4
.IX Item "--config"
Gebe die nötigen Umgebungsvariablen, um ein FrontEnd mit einem
Fortschrittsbalken zu starten, aus.
.IP "\fB\-\-start\fR" 4
.IX Item "--start"
Starte einen Fortschrittsbalken, der standardmäßig von 0 bis 100
läuft. Man benutze \fB\-\-from\fR und \fB\-\-to\fR, um andere Eckpunkte zu benutzen.
.IP "\fB\-\-from\fR \fIWegpunkt\fR" 4
.IX Item "--from Wegpunkt"
Falls mit \fB\-\-start\fR benutzt, lasse den Fortschrittsbalken bei \fIWegpunkt\fR
statt bei 0 beginnen.
.Sp
Ansonsten, installiere Pakete, deren Fortschrittsbalken an diesem
»Wegpunkt« beginnt. Muss mit \fB\-\-to\fR benutzt werden.
.IP "\fB\-\-to\fR \fIWegpunkt\fR" 4
.IX Item "--to Wegpunkt"
Falls mit \fB\-\-start\fR benutzt, lassen den Fortschrittsbalken bei \fIWegpunkt\fR
statt bei 100 enden.
.Sp
Ansonsten, installiere Pakete, deren Fortschrittsbalken an diesem
»Wegpunkt« endet. Muss mit \fB\-\-from\fR benutzt werden.
.IP "\fB\-\-stop\fR" 4
.IX Item "--stop"
Halte einen laufenden Fortschrittsbalken an.
.IP "\fB\-\-no\-progress\fR" 4
.IX Item "--no-progress"
Vermeide Starten, Enden oder Fortschreiten des
Fortschrittsbalkens. Fortschrittsmeldungen von \s-1APT\s0, Medienwechselereignisse
und Debconf-Fragen werden weiterhin an Debconf weitergeleitet.
.IP "\fB\-\-dlwaypoint\fR \fIProzentsatz\fR" 4
.IX Item "--dlwaypoint Prozentsatz"
Gebe an, wieviel Prozent des Fortschrittsbalkens für das Herunterladen von
Paketen benutzt wird. Der Rest wird für das Installieren der Pakete
verwendet. Standardmäßig werden 15% für das Herunterladen und die
verbleibenden 85% für das Installieren verwendet.
.IP "\fB\-\-logfile\fR \fIDatei\fR" 4
.IX Item "--logfile Datei"
Sende die normale Ausgabe von \s-1APT\s0 in die angegebene Datei.
.IP "\fB\-\-logstderr\fR" 4
.IX Item "--logstderr"
Sende die normale Ausgabe von \s-1APT\s0 auf die Standardfehlerausgabe.  Falls Sie
weder \fB\-\-logfile\fR noch \fB\-\-logstderr\fR angeben, wird die normale Ausgabe von
\&\s-1APT\s0 verworfen.
.IP "\fB\-\-\fR" 4
.IX Item "--"
Beende Optionen. Da Sie normalerweise zumindest das Argument \fB\-y\fR an den
auszuführenden Befehl übergeben müssen, werden Sie für gewöhnlich \fB\-\-\fR
benötigen, um zu vermeiden, dass diese \fB\-y\fR als Option an
\&\fBdebconf-apt-progress\fR selbst interpretiert wird.
.SH "BEISPIELE"
.IX Header "BEISPIELE"
Installiere den GNOME-Desktop und eine X11\-Entwicklungsumgebung innerhalb
eines Fortschrittsbalkens:
.Sp
.Vb 1
\& debconf\-apt\-progress \-\- aptitude \-y install gnome x\-window\-system\-dev
.Ve
.Sp
Installiere die Desktops \s-1GNOME\s0, \s-1KDE\s0 und \s-1XFCE\s0 innerhalb eines einzigen
Fortschrittsbalkens, von dem je 45% für \s-1GNOME\s0 und \s-1KDE\s0 und die verbleibenden
10% für \s-1XFCE\s0 benutzt werden:
.Sp
.Vb 16
\& #! /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
.Ve
.SH "RÜCKGABEWERT"
.IX Header "RÜCKGABEWERT"
Der Rückgabewert des angegebenen Befehls wird zurückgeben, außer der
Benutzer drückt den Abbruchknopf des Fortschrittsbalkens. Falls der
Abbruchknopf gedrückt wurde, wird ein Wert von 30 zurückgeben. Um
Mehrdeutigkeit zu vermeiden, wird ein Wert von 3 zurückgegeben, falls der
Befehl 30 zurückgab.
.SH "AUTOREN"
.IX Header "AUTOREN"
Colin Watson <cjwatson@debian.org>
.Sp
Joey Hess <joeyh@debian.org>