diff options
Diffstat (limited to 'doc/progress-reporting.md')
| -rw-r--r-- | doc/progress-reporting.md | 76 |
1 files changed, 76 insertions, 0 deletions
diff --git a/doc/progress-reporting.md b/doc/progress-reporting.md new file mode 100644 index 000000000..c4963af68 --- /dev/null +++ b/doc/progress-reporting.md @@ -0,0 +1,76 @@ +Install-progress reporting +-------------------------- + +If the apt options `APT::Status-Fd` is set, apt will send status +reports to that fd. The status information is separated with a '`:`', +there are the following status conditions: + +* pmstatus +* dlstatus +* conffile-prompt +* error +* media-change + +The reason for using a fd instead of an OpProgress class is that many +apt front-end 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 front-ends. + + +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 description 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 description 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) |