$NetBSD: README,v 1.4 2009/03/22 15:02:24 tsutsui Exp $
This distrib/cdrom directory was used to create bootable CD images
in the past releases with optional rsync(1) and mkisofs(8) tool.
All necessary binaries for ISOs must be prepared in ${DISTRIBDIR},
which is ${.OBJDIR}/download by default, and the binaries can be fetched
by rsync(1) with the "fetch" target defined in Makefile.
Now build.sh script has the "iso-image" target using our native makefs(8)
and this distrib/cdrom is being superseded, but our makefs(8) still
lacks support for a hybrid ISO9660/HFS file system which is required
to create bootable CD images for mac68k and macppc.
On the other hand, the recent version of mkisofs(8) seems to use
iconv(3) libraries on creating the hybrid ISO9660/HFS file system,
but the latest mkisofs(8) (at least cdrtools-2.01.01.36) from pkgsrc
dumps core on it. cdrtools-2.01 is required to build images. (PR pkg/37643)
Note you can also use compiled release binaries prepared in RELEASEDIR by
"build.sh release" if you need only single ISO image for a specific port.
Environment variables:
RELEASE
specify target release version (no default, mandatory)
TARGET_CD_IMAGE
specify target ${MACHINE}cd name
(default: all targets defined in ${RELEASE}.conf)
MKISOFS
specify mkisofs(8) path (default: /usr/pkg/bin/mkisofs)
RSYNC
specify rsync(1) path (default: /usr/pkg/bin/rsync)
RSYNC_HOST
specify rsync host (default: rsync.NetBSD.org)
RSYNC_PATH_PREFIX
specify extra prefix path of NetBSD module names for rsync mirrors
ex. "/pub", "/netbsd" etc. (default: empty)
DAILY_DIR
specify directory name on using NetBSD-daily snapshot for -current
ex. "200712060002Z" etc. (no default; mandatory for -current)
BRANCH
spcify branch name on using NetBSD-daily snapshot (default: current)
RELEASE_SUFFIX
specify suffix of directory names used for pre-releases
ex. "_BETA2", "_RC5" etc. (default: empty)
RSYNC_PATH
specify path used to rsync hosts (default: set from the above variables)
Example usage:
make RELEASE=5.0 TARGET_CD_IMAGE=mac68kcd fetch
-> fetch 5.0 mac68k sets from
rsync://rsync.NetBSD.org/NetBSD/NetBSD-5.0/
make RELEASE=4.0 TARGET_CD_IMAGE=mac68kcd RELEASE_SUFFIX=_RC5 fetch
-> fetch 4.0_RC5 mac68k sets from
rsync://rsync.NetBSD.org/NetBSD/NetBSD-4.0_RC5/
make RELEASE=current TARGET_CD_IMAGE=mac68kcd \
DAILY_DIR=200903060000Z fetch
-> fetch -current mac68k sets from
rsync://rsync.NetBSD.org/NetBSD-daily/HEAD/200903060000Z/
make RELEASE=4.0 TARGET_CD_IMAGE=mac68kcd RELEASE_SUFFIX=_RC5 \
RSYNC_HOST=rsync3.jp.NetBSD.org \
RSYNC_PATH_PREFIX=/pub fetch
-> fetch 4.0_RC5 mac68k sets from
rsync://rsync3.jp.NetBSD.org/pub/NetBSD/NetBSD-4.0_RC5/
make RELEASE=5.0 TARGET_CD_IMAGE=mac68kcd \
RSYNC_HOST=rsync.jp.NetBSD.org \
RSYNC_PATH=/NetBSD-daily/netbsd-5/200903070000Z fetch
-> fetch mac68k sets of netbsd-5 branch from
rsync://rsync.jp.NetBSD.org/pub/NetBSD-daily/netbsd-5/200903070000Z
make RELEASE=5.0 TARGET_CD_IMAGE=mac68kcd all
-> build an ISO image for mac68k from downloaded files as the above
make RELEASE=5.0 TARGET_CD_IMAGE=macppccd \
DISTRIBDIR=/usr/obj.macppc/releasedir all
-> build an ISO image for macppc from release binaries
built by "build.sh release" in the RELEASEDIR
(use appropriate RELEASEDIR on your build environment)
