Subject: Re: Adding RELEASEDIR/iso to release(7)
To: None <tech-install@NetBSD.org>
From: Alan Barrett <apb@cequrux.com>
List: tech-install
Date: 04/06/2007 14:58:50
On Thu, 05 Apr 2007, Manuel Bouyer wrote:
> > releases(7) doesn't talk about RELEASEDIR/iso at all.  I'd like to
> > update it, but first I'd like to understand the difference between the
> > two locations.  Given a CD-ROM image, how would you determine which
> > directory it belongs in, and how would you choose the file name?
> 
> Well, the isos in RELEASEDIR/MACHINE/install/cdrom/* only contains
> INSTALL kernels, but not the binary sets.

Is that true for all architectures, including those that still use
mkisofs to generate images?

Is "does not contain binary sets" the important factor that should me
mentioned in release(7) as a differentiator between RELEASEDIR/iso and
RELEASEDIR/MACHINE/install/cdrom?

If the answers to the above questions are both "yes", then does
the following patch look OK?

--apb (Alan Barrett)

Index: src/share/man/man7/release.7
===================================================================
--- release.7	1 Apr 2007 14:13:55 -0000	1.22
+++ release.7	6 Apr 2007 12:54:36 -0000
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 1, 2007
+.Dd April 6, 2007
 .Dt RELEASE 7
 .Os
 .Sh NAME
@@ -155,6 +155,42 @@
 command:
 .Sy date -u .
 .
+.It Sy iso/
+CDROM images in ISO 9660 format, usually created with
+.Dq ./build.sh ... iso-image ...
+after a
+.Dq ./build.sh -x ... release sourcesets ...
+in
+.Pa src .
+.Pp
+Images in this directory, unlike images in the
+.Sm off
+.Xo
+.Sy .../NetBSD-
+.Em \*[Lt]rel\*[Gt]
+.Sy /
+.Em \*[Lt]machine\*[Gt]
+.Sy /installation/cdrom/
+.Xc
+.Sm on
+directory, should contain file systems that
+have an internal layout that corresponds to
+a complete release for one or more machine types.
+These images are usually bootable.
+.Bl -tag -width "netbsd-ARCH.iso"
+.It Sy BSDSUM
+.It Sy CKSUM
+.It Sy MD5
+.It Sy README
+.It Sy SYSVSUM
+.Sm off
+.It Xo
+.Em \*[Lt]machine_arch\*[Gt]
+.Sy cd.iso
+.Xc
+.Sm on
+.El
+.
 .It Sy shared/
 Files shared by one or more platforms.
 .Bl -tag -width "\*[Lt]machine_arch\*[Gt]"
@@ -353,14 +389,16 @@
 installation helper items
 .Bl -tag -width "diskimage/"
 .It Sy cdrom/
-CDROM images in ISO 9660 format, usually created with
-.Dq make iso-image
-in
-.Pa src/etc
-after a
-.Dq ./build.sh -x ... release sourcesets ...
+CDROM images in ISO 9660 format, usually created as part of
+.Dq build.sh ... release ...
 in
 .Pa src .
+.Pp
+Images in this directory will typically be bootable,
+and will contain one or more of a kernel, installation tools,
+and rescue tools.
+They will not contain installation sets, source sets, or
+other components of a complete release.
 .Bl -tag -width "netbsd-ARCH.iso"
 .It Sy BSDSUM
 .It Sy CKSUM