1 Install-progress reporting
2 --------------------------
4 If the apt options: "APT::Status-Fd" is set, apt will send status
5 reports to that fd. The status information is separated with a ':',
6 there are the following status conditions:
8 status = {"pmstatus", "dlstatus", "conffile-prompt", "error", "media-change" }
10 The reason for using a fd instead of a OpProgress class is that many
11 apt frontend fork a (vte) terminal for the actual installation.
13 The reason to do the mapping and l10n of the dpkg states to human
14 readable (and translatable) strings is that this way the translation
15 needs to be done only once for all frontends.
20 Status of the package manager (dpkg). This is send when packages
21 are installed/removed.
22 pmstatus:pkgname:TotalPercentage:action-description
24 PkgName = the name of the package
25 TotalPercentage = the total progress between [0..100]
26 description = a i18ned human readable decription of the current action
30 # ./apt-get install -o APT::Status-Fd=2 3dchess >/dev/null
31 pmstatus:3dchess:20:Preparing 3dchess
32 pmstatus:3dchess:40:Unpacking 3dchess
33 pmstatus:3dchess:60:Preparing to configure 3dchess
34 pmstatus:3dchess:80:Configuring 3dchess
35 pmstatus:3dchess:100:Installed 3dchess
39 pmerror:deb:TotalPercentage:error string
42 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
47 pmconffile:conffile:percent:'current-conffile' 'new-conffile' useredited distedited
52 media-change:medium:drive:human-readable string
55 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.
60 dlstatus:AlreadDownloaded:TotalPercentage:action-description
62 AlreadyDownloaded = the number of already downloaded packages
63 TotalPercentage = the total progress between [0..100]
64 description = a i18ned human readable decription of the current action
67 dlstatus:1:9.05654:Downloading file 1 of 3 (4m40s remaining)
68 dlstatus:1:9.46357:Downloading file 1 of 3 (4m39s remaining)
69 dlstatus:1:9.61022:Downloading file 1 of 3 (4m38s remaining)