| | 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 separated with a ':', |
| | 6 | there are the following status conditions: |
| | 7 | |
| | 8 | status = {"pmstatus", "dlstatus", "conffile-prompt", "error", "media-change" } |
| | 9 | |
| | 10 | The reason for using a fd instead of a OpProgress class is that many |
| | 11 | apt front-end 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 front-ends. |
| | 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 | pmerror |
| | 38 | ------- |
| | 39 | pmerror:deb:TotalPercentage:error string |
| | 40 | |
| | 41 | Example: |
| | 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 |
| | 43 | |
| | 44 | |
| | 45 | pmconffile |
| | 46 | ---------- |
| | 47 | pmconffile:conffile:percent:'current-conffile' 'new-conffile' useredited distedited |
| | 48 | |
| | 49 | |
| | 50 | media-change |
| | 51 | ------------ |
| | 52 | media-change:medium:drive:human-readable string |
| | 53 | |
| | 54 | example: |
| | 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. |
| | 56 | |
| | 57 | |
| | 58 | dlstatus |
| | 59 | -------- |
| | 60 | dlstatus:AlreadDownloaded:TotalPercentage:action-description |
| | 61 | |
| | 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 |
| | 65 | |
| | 66 | Example: |
| | 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) |
projects / apt.git / blame_incremental