/[d-i]/trunk/build/README
ViewVC logotype

Contents of /trunk/build/README

Parent Directory Parent Directory | Revision Log Revision Log

Revision 4608 - (show annotations) (download)
Tue Oct 7 21:41:37 2003 UTC (9 years, 7 months ago) by joeyh
File size: 2720 byte(s) 
- remove my daily build stuff from Makefile
- remove code to rm a $(TEMP)/modules directory that is not referenced anywhere
- also code to remove $(NETDRIVERS), also unreferenced
- remove the USER_MOUNT_HACK
- make the TYPE sanity check clearer (combine it all into one place, commnent)
- update copyright
- broke list file parsing out into a standalone program (pkg-list), and
  removed the nasty, nasty code that used to do this
- removed NO_KERNEL and NO_BASE hacks. Instead list files can #include
  "base" and/or "kernel" to get those.
- modified all list files to include base/kernel as necessary
- no need for a versioned dep on sed anymore, removed it (good riddance!)
- many comment cleanups
- move wget-cache removal to the crufy old debian/rules, which creates it.
- move pcmcia-cs-udeb to the net_drivers image. Library reduction should still
  kick in for it
- Don't fail get_udebs if the apt-get update fails. It will fail later if not
  all required udebs are already downloaded. This allows for offline builds.
- Add a config/local, that can override other configs. I use it to set my
  floppy device. Like sources.list.local, it is not in CVS
- add a NO_TERMINFO to prevent copying of that for the bootfloppy.
  Terminfo should really be in a udeb..
- reordered targets
- remove fetch-sources and compile-udebs targets. If you used them, I will
  put them back, but they're unreferenced and look crufty
- don't generate -reduced entries in status for the kernel image
  (it was finding .dep files..)
- remove DEBUGUDEBDIR in reallyclean
- if a /etc/apt/sources.list item does not have "main" on it, it is probably
  not something to use for d-i
- add a warning comment to the top of generated sources.list
- add a FLOPPY_SIZE to netboot config. 1440 is a bit too small, but 2880
  may be far too big, so it needs tweaking
- remove extraneous dd in make/arch/linux-i386, the mkfs.mdsos -C will
  set up the file
- doc updates for new sources.list system, etc
- add listtypes target to makefile
- add sources.list to .cvsignore
- fix regexp for reduced font file in .cvsignore
- moved some more paths out of the main Makefile to config/dir
- corrected wording in the powerpc boot.msg file
1 The files in this directory are used to build the Debian installer.
2 Basically it consists of downloading udebs, unpacking them, applying some
3 magic (library reduction etc.) and building an image.
4
5 Recipe:
6 - Install the build-dependencies on the host system
7 (run dpkg-checkbuilddeps).
8 - Run "make sources.list" to automatically create a d-i sources.list.
9 Or, create your own sources.list.local.
10 - Run "fakeroot make image"
11
12 A more detailed overview of how the installer is built:
13
14 * sources.list is used to configure apt to download udebs from a mirror.
15 It is autogenerated based on /etc/apt/sources.list, by the Makefile's
16 sources.list target. Or you can provide your own locally modified
17 sources.list.local.
18 * The Makefile is configured via the make fragements in the config
19 directory. There are per-arch and per-image fragments that are included
20 by the main Makefile. There is also a make subdirectory, with
21 architecture-specific fragements that are included into the makefile for
22 non-configuration items.
23 * config/local can be added to override anything set in other fragments,
24 that is local to your system, and that you want to avoid accidentially
25 committing.
26 * pkg-lists has subdirectories for the different image types that list udebs
27 that are put on each image. The pkg-lists/TYPE/common files list udebs
28 common to all architectures, and the files named by architecture list
29 udebs specific to an architecture. These files can have #include lines to
30 include files from pkg-lists. Also, ${kernel:Version} in these files is
31 replaced with the kernel version, as set in the KERNELIMAGEVERSION variable.
32 * There's a TYPE variable that selects the type of image to build. Eg,
33 "fakeroot make TYPE=net" ("make listtypes" will list all available image
34 types)
35 * Apt is used to download the required udebs. This does *not* include
36 libraries; libraries used by udebs must be installed on the build system,
37 and so are build-depended on.
38 * If you have some udebs that are not available on your mirror yet,
39 you can drop them in localudebs/ and they will be used.
40 * dpkg is used to unpack the udebs into the build directory.
41 * A customized set of reduced libraries is generated to correspond to the
42 udebs that were installed.
43 * Some boot images have associated "driver" disks. These disks just get
44 udebs put on them. They are also unpacked and library reduction is run
45 against them when doing library reduction for their parent image.
46 * "make demo" (run as root) will chroot into the system.
47 * To burn a demo CD image (ISO) with the created installation system,
48 add the "image" argument to the the make call above. The resulting
49 filesystem images will be placed in dest/.
  ViewVC Help
Powered by ViewVC 1.1.5