You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Michael Vogt 960d4d245d * revert patch from patch-59, causes all sorts of trouble 17 years ago
apt-inst Sync with Andre Luis Lopes and Otavio branches 18 years ago
apt-pkg * revert patch from patch-59, causes all sorts of trouble 17 years ago
buildlib Sync with Andre Luis Lopes and Otavio branches 18 years ago
cmdline apt-cdrom.cc:fix some missing gettext() calls (closes: #334539); doc/apt-cache.8.xml: fix typo (closes: #334714) 17 years ago
debian * revert patch from patch-59, causes all sorts of trouble 17 years ago
doc * fix a incorrect example 17 years ago
dselect Bring consistency to the use of capitals in programs messages 18 years ago
ftparchive * fix a crash in apt-ftparchive 17 years ago
methods * merged from apt--cdrom-fallback--0 17 years ago
po Basque translation completed 17 years ago
share Merge with Matt 18 years ago
test Merge with Matt 17 years ago
.cvsignore Ignore autom4te.cache and debian/copyright. 18 years ago
AUTHORS Fix spelling 18 years ago
COMPILING * Point to Build-Depends in COMPILING (Closes: #233669) 18 years ago
COPYING QT1 license exception 18 years ago
COPYING.GPL QT1 license exception 18 years ago
Makefile gettext stuff 18 years ago
README.arch * README.arch updates, comment in apt-pkg/algorithm.h added, apt-pkg/cacheiterators.h order in initlist changed to remove warning 17 years ago
README.make JoeyH's dpkg::preconfig not working. 18 years ago
README.progress-reporting * include a human readable string for the MediaChange status-fd message as well 17 years ago
configure.in * fix a incorrect example 17 years ago

README.progress-reporting

Install-progress reporting 
--------------------------

If the apt options: "APT::Status-Fd" is set, apt will send status
reports to that fd. The status information is seperated with a ':',
there are the following status conditions:

status = {"pmstatus", "dlstatus", "conffile-prompt", "error", "media-change" }

The reason for using a fd instead of a OpProgress class is that many
apt frontend fork a (vte) terminal for the actual installation.

The reason to do the mapping and l10n of the dpkg states to human
readable (and translatable) strings is that this way the translation
needs to be done only once for all frontends.


pmstatus
--------
Status of the package manager (dpkg). This is send when packages
are installed/removed.
pmstatus:pkgname:TotalPercentage:action-description

PkgName = the name of the package
TotalPercentage = the total progress between [0..100]
description = a i18ned human readable decription of the current action


Example:
# ./apt-get install -o APT::Status-Fd=2 3dchess >/dev/null
pmstatus:3dchess:20:Preparing 3dchess
pmstatus:3dchess:40:Unpacking 3dchess
pmstatus:3dchess:60:Preparing to configure 3dchess
pmstatus:3dchess:80:Configuring 3dchess
pmstatus:3dchess:100:Installed 3dchess

pmerror
-------
pmerror:deb:TotalPercentage:error string

Example:
pmerror: /var/cache/apt/archives/krecipes_0.8.1-0ubuntu1_i386.deb : 75% : trying to overwrite `/usr/share/doc/kde/HTML/en/krecipes/krectip.png', which is also in package krecipes-data


pmconffile
----------
pmconffile:conffile:percent:'current-conffile' 'new-conffile' useredited distedited


media-change
------------
media-change:medium:drive:human-readable string

example:
media-change: Ubuntu 5.10 _Breezy Badger_ - Alpha i386 (20050830):/cdrom/:Please insert the disc labeled: 'Ubuntu 5.10 _Breezy Badger_ - Alpha i386 (20050830)' in the drive '/cdrom/' and press enter.


dlstatus
--------
dlstatus:AlreadDownloaded:TotalPercentage:action-description

AlreadyDownloaded = the number of already downloaded packages
TotalPercentage = the total progress between [0..100]
description = a i18ned human readable decription of the current action

Example:
dlstatus:1:9.05654:Downloading file 1 of 3 (4m40s remaining)
dlstatus:1:9.46357:Downloading file 1 of 3 (4m39s remaining)
dlstatus:1:9.61022:Downloading file 1 of 3 (4m38s remaining)