1$NetBSD: README,v 1.4 2009/03/22 15:02:24 tsutsui Exp $ 2 3This distrib/cdrom directory was used to create bootable CD images 4in the past releases with optional rsync(1) and mkisofs(8) tool. 5All necessary binaries for ISOs must be prepared in ${DISTRIBDIR}, 6which is ${.OBJDIR}/download by default, and the binaries can be fetched 7by rsync(1) with the "fetch" target defined in Makefile. 8 9Now build.sh script has the "iso-image" target using our native makefs(8) 10and this distrib/cdrom is being superseded, but our makefs(8) still 11lacks support for a hybrid ISO9660/HFS file system which is required 12to create bootable CD images for mac68k and macppc. 13 14On the other hand, the recent version of mkisofs(8) seems to use 15iconv(3) libraries on creating the hybrid ISO9660/HFS file system, 16but the latest mkisofs(8) (at least cdrtools-2.01.01.36) from pkgsrc 17dumps core on it. cdrtools-2.01 is required to build images. (PR pkg/37643) 18 19Note you can also use compiled release binaries prepared in RELEASEDIR by 20"build.sh release" if you need only single ISO image for a specific port. 21 22 23Environment variables: 24 25RELEASE 26 specify target release version (no default, mandatory) 27 28TARGET_CD_IMAGE 29 specify target ${MACHINE}cd name 30 (default: all targets defined in ${RELEASE}.conf) 31 32MKISOFS 33 specify mkisofs(8) path (default: /usr/pkg/bin/mkisofs) 34 35RSYNC 36 specify rsync(1) path (default: /usr/pkg/bin/rsync) 37 38RSYNC_HOST 39 specify rsync host (default: rsync.NetBSD.org) 40 41RSYNC_PATH_PREFIX 42 specify extra prefix path of NetBSD module names for rsync mirrors 43 ex. "/pub", "/netbsd" etc. (default: empty) 44 45DAILY_DIR 46 specify directory name on using NetBSD-daily snapshot for -current 47 ex. "200712060002Z" etc. (no default; mandatory for -current) 48 49BRANCH 50 spcify branch name on using NetBSD-daily snapshot (default: current) 51 52RELEASE_SUFFIX 53 specify suffix of directory names used for pre-releases 54 ex. "_BETA2", "_RC5" etc. (default: empty) 55 56RSYNC_PATH 57 specify path used to rsync hosts (default: set from the above variables) 58 59 60Example usage: 61 62make RELEASE=5.0 TARGET_CD_IMAGE=mac68kcd fetch 63 -> fetch 5.0 mac68k sets from 64 rsync://rsync.NetBSD.org/NetBSD/NetBSD-5.0/ 65 66make RELEASE=4.0 TARGET_CD_IMAGE=mac68kcd RELEASE_SUFFIX=_RC5 fetch 67 -> fetch 4.0_RC5 mac68k sets from 68 rsync://rsync.NetBSD.org/NetBSD/NetBSD-4.0_RC5/ 69 70make RELEASE=current TARGET_CD_IMAGE=mac68kcd \ 71 DAILY_DIR=200903060000Z fetch 72 -> fetch -current mac68k sets from 73 rsync://rsync.NetBSD.org/NetBSD-daily/HEAD/200903060000Z/ 74 75make RELEASE=4.0 TARGET_CD_IMAGE=mac68kcd RELEASE_SUFFIX=_RC5 \ 76 RSYNC_HOST=rsync3.jp.NetBSD.org \ 77 RSYNC_PATH_PREFIX=/pub fetch 78 -> fetch 4.0_RC5 mac68k sets from 79 rsync://rsync3.jp.NetBSD.org/pub/NetBSD/NetBSD-4.0_RC5/ 80 81make RELEASE=5.0 TARGET_CD_IMAGE=mac68kcd \ 82 RSYNC_HOST=rsync.jp.NetBSD.org \ 83 RSYNC_PATH=/NetBSD-daily/netbsd-5/200903070000Z fetch 84 -> fetch mac68k sets of netbsd-5 branch from 85 rsync://rsync.jp.NetBSD.org/pub/NetBSD-daily/netbsd-5/200903070000Z 86 87make RELEASE=5.0 TARGET_CD_IMAGE=mac68kcd all 88 -> build an ISO image for mac68k from downloaded files as the above 89 90make RELEASE=5.0 TARGET_CD_IMAGE=macppccd \ 91 DISTRIBDIR=/usr/obj.macppc/releasedir all 92 -> build an ISO image for macppc from release binaries 93 built by "build.sh release" in the RELEASEDIR 94 (use appropriate RELEASEDIR on your build environment) 95