distrib/cdrom/README

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