projects / apt.git / blame
| Commit | Line | Data |
|---|---|---|
| f77bf408 MV |
1 | Install-progress reporting |
| 2 | -------------------------- | |
| 3 | ||
| 4 | If the apt options: "APT::Status-Fd" is set, apt will send status | |
| 5 | reports to that fd. The status information is seperated with a ':', | |
| 6 | there are the following status conditions: | |
| 7 | ||
| 8 | status = {"pmstatus", "dlstatus", "conffile-prompt", "error" } | |
| 9 | ||
| 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. | |
| 12 | ||
| 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. | |
| 16 | ||
| 17 | ||
| 18 | pmstatus | |
| 19 | -------- | |
| 20 | Status of the package manager (dpkg). This is send when packages | |
| 21 | are installed/removed. | |
| 22 | pmstatus:pkgname:TotalPercentage:action-description | |
| 23 | ||
| 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 | |
| 27 | ||
| 28 | ||
| 29 | Example: | |
| 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 | |
| 36 | ||
| 37 | ||
| 38 | dlstatus | |
| 39 | -------- | |
| 40 | dlstatus:AlreadDownloaded:TotalPercentage:action-description | |
| 41 | ||
| 42 | AlreadyDownloaded = the number of already downloaded packages | |
| 43 | TotalPercentage = the total progress between [0..100] | |
| 44 | description = a i18ned human readable decription of the current action | |
| 45 | ||
| 46 | Example: | |
| 47 | dlstatus:1:9.05654:Downloading file 1 of 3 (4m40s remaining) | |
| 48 | dlstatus:1:9.46357:Downloading file 1 of 3 (4m39s remaining) | |
| 49 | dlstatus:1:9.61022:Downloading file 1 of 3 (4m38s remaining) |