README
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