Commit | Line | Data |
---|---|---|
75ef8f14 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 | ||
80a26ed1 | 8 | status = {"pmstatus", "dlstatus", "conffile-prompt", "error", "media-change" } |
75ef8f14 MV |
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 | 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 | ||
80a26ed1 MV |
50 | media-change |
51 | ------------ | |
1a82c63e | 52 | media-change:medium:drive:human-readable string |
80a26ed1 MV |
53 | |
54 | example: | |
1a82c63e | 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. |
80a26ed1 | 56 | |
75ef8f14 MV |
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) |