README.progress-reporting 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. Install-progress reporting
  2. --------------------------
  3. If the apt options: "APT::Status-Fd" is set, apt will send status
  4. reports to that fd. The status information is separated with a ':',
  5. there are the following status conditions:
  6. status = {"pmstatus", "dlstatus", "conffile-prompt", "error", "media-change" }
  7. The reason for using a fd instead of a OpProgress class is that many
  8. apt front-end fork a (vte) terminal for the actual installation.
  9. The reason to do the mapping and l10n of the dpkg states to human
  10. readable (and translatable) strings is that this way the translation
  11. needs to be done only once for all front-ends.
  12. pmstatus
  13. --------
  14. Status of the package manager (dpkg). This is send when packages
  15. are installed/removed.
  16. pmstatus:pkgname:TotalPercentage:action-description
  17. PkgName = the name of the package
  18. TotalPercentage = the total progress between [0..100]
  19. description = a i18ned human readable decription of the current action
  20. Example:
  21. # ./apt-get install -o APT::Status-Fd=2 3dchess >/dev/null
  22. pmstatus:3dchess:20:Preparing 3dchess
  23. pmstatus:3dchess:40:Unpacking 3dchess
  24. pmstatus:3dchess:60:Preparing to configure 3dchess
  25. pmstatus:3dchess:80:Configuring 3dchess
  26. pmstatus:3dchess:100:Installed 3dchess
  27. pmerror
  28. -------
  29. pmerror:deb:TotalPercentage:error string
  30. Example:
  31. 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
  32. pmconffile
  33. ----------
  34. pmconffile:conffile:percent:'current-conffile' 'new-conffile' useredited distedited
  35. media-change
  36. ------------
  37. media-change:medium:drive:human-readable string
  38. example:
  39. 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.
  40. dlstatus
  41. --------
  42. dlstatus:AlreadDownloaded:TotalPercentage:action-description
  43. AlreadyDownloaded = the number of already downloaded packages
  44. TotalPercentage = the total progress between [0..100]
  45. description = a i18ned human readable decription of the current action
  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)