| | 1 | $DragonFly: src/nrelease/Attic/README,v 1.2 2006/07/16 23:06:56 dillon Exp $ |
| | 2 | |
| | 3 | The DragonFly framework for building ISO image (nrelease) |
| | 4 | ========================================================= |
| | 5 | |
| | 6 | Important user-tunable variables |
| | 7 | -------------------------------- |
| | 8 | |
| | 9 | ISODIR default prefix of ISOFILE and ISOROOT |
| | 10 | ISOFILE name of the ISO image to generate |
| | 11 | ISOROOT location where to fresh world is installed to |
| | 12 | KERNCONF kernel configuration to use |
| | 13 | |
| | 14 | PKGSRC_PACKAGES default list of packages to be added to the ISO |
| | 15 | PKGSRC_PKG_ADD location of pkgsrc-style pkg_add used during build |
| | 16 | PKGSRC_PKG_PATH location of binary packages to be added to the ISO |
| | 17 | PKGSRC_BOOTSTRAP_FILE location of the bootstrap kit |
| | 18 | (this must be local, PKGSRC_PKG_PATH can be remote) |
| | 19 | PKGSRC_DB db location used by the bootstrap kit |
| | 20 | PKGSRC_PREFIX localbase used by the bootstrap kit |
| | 21 | PKGSRC_RSYNC_SRC where to fetch packages from during make fetch |
| | 22 | |
| | 23 | WITH_INSTALLER if defined, the BSD installer is added to the target |
| | 24 | |
| | 25 | The default values match the packages from packages.stura.uni-rostock.de. |
| | 26 | |
| | 27 | |
| | 28 | Important targets |
| | 29 | ----------------- |
| | 30 | |
| | 31 | fetch fetches the bootstrap kit and binary packages using rsync |
| | 32 | release builds world and kernel, installs them, adds packages and |
| | 33 | prepares the ISO image |
| | 34 | quickrel same as release, but use quickworld and quickkernel |
| | 35 | realquickrel same as release, but skips buildworld and buildkernel |
| | 36 | |
| | 37 | |
| | 38 | First time usage |
| | 39 | ---------------- |
| | 40 | |
| | 41 | The nrelease framework expects to find a working pkg_add from pkgsrc. |
| | 42 | You can use the bootstrap kit, which matches the default configuration, |
| | 43 | or install it yourself. If you use a location other than /usr/pkg, you |
| | 44 | have to specify PKGSRC_PKG_ADD in make.conf. |
| | 45 | |
| | 46 | If you want to have any packages install in the ISO (the default), run |
| | 47 | ``make fetch'' first, to get them and the bootstrap kit used in the ISO. |
| | 48 | By default, the current directory is used, the location can and should |
| | 49 | be overriden by PKGSRC_PKG_PATH in make.conf. |
| | 50 | |
| | 51 | RELEASE ENGINEERING |
| | 52 | -------------------------------- |
| | 53 | |
| | 54 | The steps required for engineering a release are documented in (CVS) |
| | 55 | doc/notes/release.txt. How to branch the CVS tree, etc. They were put |
| | 56 | in an out of the way place so normal developers would not accidently try |
| | 57 | to run the commands in question. |
| | 58 | |
projects / dragonfly.git / blame_incremental