/[d-i]/trunk/installer/doc/TODO
ViewVC logotype

Diff of /trunk/installer/doc/TODO

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/doc/TODO revision 185 by joeyh, Sat Dec 2 00:32:14 2000 UTC trunk/installer/doc/TODO revision 18981 by joeyh, Wed Aug 11 18:45:06 2004 UTC
# Line 1  Line 1 
1  Done this week:  Things we really should fix before rc2:
2  - retriever controller (aka "anna", for anna's not nearly apt) is  
3    started, and works in a limited way, good enough for demo purposes.          - base-config's broken hwclock display #264314
4  - file retriever, which is the simplest possible retriever (it just                  (fixed in unstable, fix not yet in testing)
5    symlinks a file, rather like apt's file method).          - base-config's broken translations mess up mirror selection
6  - cdebconf now has a working frontend, and is usable.                  (fixed in 2.42, fix not yet in testing)
7  - basic demo system, in which you can use the main menu to tell anna to          - tasksel/aptitude problem that prevents installation of standard
8    retrieve and unpack some more udebs, then see them appear on the main            packages
9    menu. http://lists.debian.org/debian-boot-0011/msg00629.html                  (fixed in aptitude 0.2.15.6-0.sarge3 in t-p-u)
10  - first stab at a busybox udeb.          - aptitude bug that prevents tasks from working in some locales
11  - choose-mirror, a configuration tool for http/ftp/other retreivers has                  (#264716)
12    been started, but needs a lot of work.                  (apparently fixed in aptitude 0.2.15.6-0.sarge3 in t-p-u)
13            - netcfg issues with bad MTU data from dhcp server
14  Still Todo:                  (fixed in svn)
15            - fix sparc CDs, old mkisofs generates invalid images
16          - design [Joey Hess, debian-boot]          - partman confuses identically sized partitions (#241785, grave)
17                  80% done. Enough to know what the big peices are          - new hotplug is needed in testing to fix watchdog and framebuffer
18                  and how they fit together.            module load issues (0.0.20040329-14 fixes it)
19          - udeb archive setup [James Troup, Anthony Towns, Jason Gunthorpe]  
20                  95% support in new package pools code. James is now waiting  Things that would be nice for rc2, but can't block it:
21                  for after 2.1r2, it seems.  
22          - cdebconf (miniature debconf in C) [Randolph Chung, Anthony Towns]          - partman-efi, for reasonable setup of EFI partition on ia64
23                  In progress, has one working database backend and one                  (uploaded, needs testing, and propigation to testing)
24                  working text-based frontend.          - gdm locale problems on reboot (#265101)
25          - udpkg (tiny dpkg clone) [Randolph Chung, Joey Hess]          - gnome-session needs update in testing, so users log into gnome,
26                  Usable. One todo item (localized descriptions)            and not kde, from gdm (2.6.2-5 fixes it)
27          - main-menu (main menu generator) [Joey Hess]          - partman misdetects some partitions as type loop (#249371, grave)
28                  90% done (one non-trivial todo item)  
29          - busybox integration [Erik Andersen]  
30                  First pass busybox udeb is ready.  This TODO list can only touch on some larger issues, but there are a great
31                  http://people.debian.org/~andersee/  many open bugs on various components of the installer. See all bugs tagged
32          - network card detector [Glenn McGrath, David Whedon]  d-i in the BTS. Also, there are many unprocessed installation-reports bugs.
33                  Pcidetect is written, detects PCI cards only. Needs  
34                  testing. David has another detector that uses libdetect  
35                  instead.  Status for different parts of debian-installer.  The numbers are
36          - other hardware detection [David Whedon]  approximate (as in +/- 50%) and may change in any direction, at any
37                  David has written detectors for sound, ethernet, cd, cpu,  time.
38                  disk, and memory detection. All need testing.  
39          - network setup [UNCLAIMED]  [0%] Not begun
40                  Not started. Set up the network, via dhcp or via prompting;  ---------------------------------------------------------------------
41                  implementor decides.          - some architectures
42          - retreiver control program [Joey Hess, Glenn McGrath]                  hurd-i386 (we will ship w/o this)
43                  About 10% done realistically, but it does work.                  sh (we will ship w/o this)
44          - file retreiver [Joey Hess]  
45                  100% done, such as it is. Probably not useful in real life  [30%] Might need large rewrites. Current implementation might
46                  expcet in CD installs, but handy for the demo system.        work by accident
47          - choose-mirror [Joey Hess]  ---------------------------------------------------------------------
48                  Nearly 50% done, but entirely untested.          - GUI frontend to cdebconf.
49          - http retreiver [UNCLAMED]                  There are some basic implementations. The trick is to make
50                  Not started. Download udebs, other files from network.                  it a GUI that does not suck, while still using debconf
51          - target media detector [UNCLAIMED]                  underneath.
52                  Not started. Just has to figure out what media to install to.          - ppp support
53                  Probably trivial; most support already in the kernel.                    Not as important for analog dialup, as for ISDN, pppoe.
54          - disk partitioner [UNCLAIMED]  
55                  Not started. Some kind of a UI to let the user partition their  
56                  disks and decide what the partitions are used for.  [60%] Needs some work, but does its grunt work
57          - disk formatter [UNCLAIMED]  ---------------------------------------------------------------------
58                  Not started. Formats disks, turns on swap, etc.          - I18N
59          - base system installer [UNCLAIMED]                  Mostly done, still filling in minor holes.
60                  Not started. Installs the base system, probably from base.tgz          - translations
61                  for now, and does any necessary setup.                  Varying languages translated to varying degrees.
62          - {lilo,grub} installer [UNCLAIMED]                  http://people.debian.org/~seppy/d-i/translation-status.html
63                  Not started. Sets up {lilo,grub}.          - boot loader installers (lilo, grub, etc)
64          - kernel module udebs [Vaidhy]                  Work, except for when they don't. See BTS.
65                  Not started. We will need various sets of kernel modules;          - anna
66                  one such set is NIC drivers. Each set goes in a udeb; there                  Works, mostly.  Needs support for Release files.
67                  probably has to be a system to build the whole kernel and                  Support for signed Release files would be cool, but
68                  udebs.                  needs gpgv-udeb.
69          - library reduction [Marcus Brinkmann]                  Needs to have load-installer properly split out of the anna
70                  Not started. There is code in the boot-floppies that should                  binary to save space on root floppy. Or removed, not used
71                  be usable, but this is still one of the hardest parts.                  anymore.
72          - install media build system [UNCLAIMED]          - disk selector, partitioner
73                  Not started. Puts all the peices together and makes                  We have switched to partman everything except a couple of
74                  install media.                  subarches and s390.
75            - bugreporter-udeb
76                    only supports saving to floppy, which many lack
77                    should offer a way to save via network or to usb stick
78            - post-reboot configuration
79                    base-config is stable, though it could use more polish
80                    i18n is needed.
81                    Some questions repeat questions from d-i.
82            - web site
83                    http://www.debian.org/devel/debian-installer/
84                    Could be better laid out, lacking some sections, other
85                    parts are quite good.
86            - archive integration
87                    No automatic propagation to testing.
88                    No source propagation for udeb sources!
89            - pcmcia support
90                    Much improved, generally works now.
91                    Automatic PCI resource range exclusion based on probing
92                    still needed, work in progress.
93            - low memory support
94                    Where "low" is 32-46 mb!
95                    Works, but user must be careful to set up swap ASAP.
96                    There is no sanity checking, and some bad failure modes.
97                    Zboob's patch for ultra-lowmem needs work and is not yet
98                    integrated.
99          - user documentation          - user documentation
100                  Not started. (Waiting until we have something to document..)                  Installation manual is up-to-date for i386.
101                    Needs sanity checking for other architectures.
102                    Translations need updates.
103            - developer documentation
104                    We understand it, but casual hackers have a high barrier to
105                    doing simple things like using a custom kernel.
106            - 2.6 support
107                    Works on i386, with minor bugs.
108                    Works on powerpc, at least newworld. Testing on
109                    other subarches needed, especially G5 and oldworld (with
110                    mkvmlinuz).
111            - some architectures
112                    i386
113                    ia64
114                    powerpc
115                    mips
116                            SGI (mips/r4k-ip22 and mips/r5k-ip22)
117                                    - fix parted's DVH disk labels support (#239371)
118                                    - install dvhtool
119                            Broadcom SWARM (mips/sb1-swarm-bn)
120                                    - Needs a working boot loader in the archive
121                            Documentation, manual
122                            XXX the above may be somewhat out of date
123                    mipsel
124                            DECstation (mipsel/r3k-kn02 and mipsel/r4k-kn04)
125                                    - cannot boot from CD (see end of #241231)
126                            Cobalt (mipsel/cobalt)
127                                    - figure out whether to set link_in_boot=yes
128                                      (see trunk/packages/rootskel/debian/templates-arch)
129                                    - boot has to be ext2 -r 0
130                                    - support installs via SSH, w/o serial console
131                                    - boot: use: execute rd_start=0x{initrd-start} rd_size=0x{initrd-size} console=ttyS0,{console-speed}
132                                    - debconf should output progess on the LCD
133                            Documentation, manual
134                            XXX the above may be somewhat out of date
135                    m68k (some subarches)
136                    alpha
137                    sparc
138                    arm (some subarches)
139                    hppa
140                    amd64 (unofficial)
141                    s/390
142                            lowmem issues
143                            On its first release, probably still some problems.
144    
145    [90%] Single missing important feature or bug.
146    ---------------------------------------------------------------------
147            - hw-detect
148                    Working but needs to be switched over to discover2
149            - iso-scan
150                    Works, but does not flag the disk the iso is mounted from
151                    as unusable by the rest of the installer.
152            - netcfg
153                    Working, pending rewrite for IPv6.
154            - bts
155                    Still need a non-manual way to tag our bugs.
156            - language-chooser
157                    The perennial problem is how to order/present the list of
158                    languages. Many complaints, but it works.
159            - base system installer
160                    It can break due to testing package churn. cdebootstrap
161                    would fix this; also debootstrap/apt/archive changes in
162                    progress to add Base: overrides to Packages files.
163    
164    [100%] Those shouldn't need to be touched any more
165           (famous last words)
166    ---------------------------------------------------------------------
167            - udpkg
168            - cd installs
169            - net retriever
170            - cdrom retriever
171            - ethdetect
172            - cdebconf
173            - floppy retriever
174            - main-menu
175            - choose-mirror
176            - busybox integration
177            - install media build system
178            - kernel-package integration
179            - library reduction
180            - wireless support
181    
182    Common problems and transitions
183    ===============================
184    
185    This is a list of common mistakes that need to be corrected throughout the
186    code base:
187    
188      * All debconf commands that INPUT, GO, GET or SET questions should check
189        their return value. This is pure evil:
190    
191        debconf->command(debconf, "GET", "mirror/suite", NULL); /* unchecked return code ! */
192        asprintf(&command, "foo %s", debconf->value);
193        system(command);
194    
195      * cdebconf's debconfclient.h has a set of macros for calling debconf
196        (debconf_get() and so on)
197        These should perhaps be used consistently throughout the code for
198        clarity.
199    
200      * There needs to be a centralised logging method. Syslog will do, but
201        we currently have a lot of nasty code that appends messages to
202        /var/log/messages directly. All of that would be converted to pipe it
203        to logger. However, this is a problem, because piping a command to
204        logger loses the exit status of the command. Need some way to run a
205        command, logging the ouput to syslog, w/o losing exit status.
206    
207  Other stuff:    * udebs should not include md5sums files, or postrm, prerm, preinst
208       - The main menu design has some issues. If a step is failing      scripts. This includes ones generated by debhelper. Linda will find
209         because some step above it did something wrong, but thought      these pretty well.
        it succeeded (a disk was partitioned, but very badly, and  
        installing the base system to it fails), there is no way to  
        force the user to back up. This seems to preclude linear  
        install mode. I posted a longer example to -boot. Three  
        possible fixes:  
                         - Detect loops, and have code to figure out what went  
                           wrong and back up to the appropriate step that can  
                           fix it  
                         - Detect loops, and back up to the beginning of  
                           the menu  
                         - Detect whenever any menu item fails, and leave  
                           linear mode. (BEST)  
     - Need to define module subsystems for network/hardware  
       support, network configuration, target media support, etc.  
210    
211      * There is no need to set the seen flag anymore. All code that does so
212        should be removed, unless that code is expected to also possibly run on
213        a normal debian system (choose-mirror).

Legend:
Removed from v.185  
changed lines
  Added in v.18981

  ViewVC Help
Powered by ViewVC 1.1.5