describe new iso-image-source target

This commit is contained in:
jnemeth 2007-08-30 10:29:02 +00:00
parent e44b703953
commit 1f84965eb7
2 changed files with 75 additions and 3 deletions

View File

@ -527,6 +527,34 @@ BUILDING
ity, which is not part of NetBSD, but which can be
installed from pkgsrc/sysutils/cdrtools.
iso-image-source
Create a NetBSD installation CD-ROM image in the
RELEASEDIR/iso directory. The CD-ROM file system will have
a layout as described in release(7). It will have top
level directories for the machine type and source.
For most machine types, the CD-ROM will be bootable, and
will automatically run the sysinst(8) menu-based installa-
tion program, which can be used to install or upgrade a
NetBSD system. Bootable CD-ROMs also contain tools that
may be useful in repairing a damaged NetBSD installation.
Before ``make iso-image-source'' is attempted, RELEASEDIR
must be populated by ``make sourcesets release'' or equiva-
lent.
Note that other, smaller, CD-ROM images may be created in
the RELEASEDIR/MACHINE/installation/cdrom directory by
``make release''. These smaller images usually contain the
same tools as the larger images in RELEASEDIR/iso, but do
not contain additional content such as the distribution
sets.
Note that the mac68k port still uses an older method of
creating CD-ROM images. This requires the mkisofs(1) util-
ity, which is not part of NetBSD, but which can be
installed from pkgsrc/sysutils/cdrtools.
regression-tests
Can only be run after building the regression tests in the
directory ``regress''. Runs the compiled regression tests
@ -771,4 +799,4 @@ HISTORY
BUGS
A few platforms are not yet using this build system.
NetBSD April 13, 2007 NetBSD
NetBSD August 30, 2007 NetBSD

View File

@ -1,4 +1,4 @@
.\" $NetBSD: BUILDING.mdoc,v 1.50 2007/08/30 00:35:11 ad Exp $
.\" $NetBSD: BUILDING.mdoc,v 1.51 2007/08/30 10:29:02 jnemeth Exp $
.\"
.\" Copyright (c) 2001-2007 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -40,7 +40,7 @@
.\" Toolchain prefix for commands
.ds toolprefix nb
.
.Dd April 13, 2007
.Dd August 30, 2007
.Dt BUILDING 8
.Os NetBSD
.
@ -973,6 +973,50 @@ utility, which is not part of
but which can be installed from
.Pa pkgsrc/sysutils/cdrtools .
.
.It iso-image-source
Create a
.Nx
installation CD-ROM image in the
.Sy RELEASEDIR Ns Pa /iso
directory.
The CD-ROM file system will have a layout as described in
.Xr release 7 .
It will have top level directories for the machine type and source.
.Pp
For most machine types, the CD-ROM will be bootable, and will automatically
run the
.Xr sysinst 8
menu-based installation program, which can be used to install or upgrade a
.Nx
system.
Bootable CD-ROMs also contain tools that may be useful in
repairing a damaged
.Nx
installation.
.Pp
Before
.Dq make iso-image-source
is attempted, RELEASEDIR must be populated by
.Dq make sourcesets release
or equivalent.
.Pp
Note that other, smaller, CD-ROM images may be created in the
.Sy RELEASEDIR/MACHINE Ns Pa /installation/cdrom
directory by
.Dq make release .
These smaller images usually contain the same tools as the larger images in
.Sy RELEASEDIR Ns Pa /iso ,
but do not contain additional content such as the distribution sets.
.Pp
Note that the mac68k port still uses an older method of creating
CD-ROM images.
This requires the
.Xr mkisofs 1
utility, which is not part of
.Nx ,
but which can be installed from
.Pa pkgsrc/sysutils/cdrtools .
.
.It Sy regression-tests
Can only be run after building the regression tests in the directory
.Dq regress .