b4b75848de
set in src/etc after a "make release" in both "src" and "xsrc", to create a ISO-image of the release in $RELEASEDIR/installation/cdrom. Hook for architecture dependent pre/post-processing in etc/etc.*/Makefile.inc are available as 'iso-image_md_post' and 'iso-image_md_pre', see etc/etc.i386/Makefile.inc as an example. Might be useful for setting up bootable CDs on alpha, sparc, ... Reviewed by Todd Whitesel and Thomas Klausner.
405 lines
10 KiB
Groff
405 lines
10 KiB
Groff
.\" $NetBSD: release.7,v 1.8 2000/09/11 21:53:31 hubertf Exp $
|
|
.\"
|
|
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to The NetBSD Foundation
|
|
.\" by Charles M. Hannum and Jason R. Thorpe.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the NetBSD
|
|
.\" Foundation, Inc. and its contributors.
|
|
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
|
|
.\" contributors may be used to endorse or promote products derived
|
|
.\" from this software without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.Dd November 18, 1997
|
|
.Dt RELEASE 7
|
|
.Os
|
|
.Sh NAME
|
|
.Nm release
|
|
.Nd layout of NetBSD releases and snapshots
|
|
.Sh DESCRIPTION
|
|
This document describes the layout of
|
|
.Nx
|
|
releases and snapshots.
|
|
This layout should be consistent between FTP servers and CD-ROMs,
|
|
except possibly the path that leads to the release hierarchy.
|
|
.Pp
|
|
In this document, the following special words have these definitions:
|
|
.Bl -tag -width "<machine_arch>"
|
|
.It Em <machine>
|
|
The platform for which the release was built, corresponding to the
|
|
.Em hw.machine
|
|
sysctl variable, e.g.
|
|
.Em i386
|
|
or
|
|
.Em amiga .
|
|
.It Em <machine_arch>
|
|
The architecture for which a particular installation set was built,
|
|
corresponding to the
|
|
.Em hw.machine_arch
|
|
sysctl variable, e.g.
|
|
.Em i386
|
|
or
|
|
.Em m68k .
|
|
.It Em <rel>
|
|
The target release.
|
|
.El
|
|
.Pp
|
|
All
|
|
.Sy README
|
|
files are descriptions of the various files in directories that have
|
|
.Dq non-standard
|
|
contents.
|
|
.Pp
|
|
All
|
|
.Sy BSDSUM
|
|
files are historic
|
|
.Bx
|
|
checksums for the various files in that directory,
|
|
in the format produced by the command:
|
|
.Sy cksum -o 1 <file> .
|
|
.Pp
|
|
All
|
|
.Sy CKSUM
|
|
files are POSIX checksums for the various files in that directory, in the
|
|
format produced by the command:
|
|
.Sy cksum <file> .
|
|
.Pp
|
|
All
|
|
.Sy MD5
|
|
files are MD5 digests for the various files in that directory, in the
|
|
format produced by the command:
|
|
.Sy cksum -m <file> .
|
|
.Pp
|
|
All
|
|
.Sy SYSVSUM
|
|
files are historic
|
|
.At V
|
|
checksums for the various files in
|
|
that directory, in the format produced by the command:
|
|
.Sy cksum -o 2 <file> .
|
|
.Pp
|
|
The MD5 digest is the safest checksum, followed by the POSIX checksum.
|
|
The other two checksums are provided only to ensure that the widest possible
|
|
range of system can check the integrity of the release files.
|
|
.Pp
|
|
Files that end in
|
|
.Sy .tgz
|
|
are gzipped tar archives. This is used in lieu of
|
|
.Sy .tar.gz
|
|
because the software used to download the sets may incorrectly auto-unpack
|
|
files ending in
|
|
.Sy .gz
|
|
and to accommodate systems which only support 3 character extensions
|
|
to file names.
|
|
.Pp
|
|
All tar archives are relative to the target's
|
|
.Sy /
|
|
directory, and
|
|
.Em do not
|
|
include the leading
|
|
.Dq / .
|
|
.Pp
|
|
All compression of release files is to be performed with the command:
|
|
.Sy gzip -9 .
|
|
.Pp
|
|
The root of the release hierarchy is
|
|
.Sm off
|
|
.Xo
|
|
.Sy .../NetBSD-
|
|
.Em <rel>
|
|
.Sy /
|
|
.Em <machine>
|
|
.Sy / .
|
|
.Xc
|
|
.Sm on
|
|
For files which may be shared by all systems of the same
|
|
.Em <machine_arch> ,
|
|
(e.g. the
|
|
.Sy games
|
|
and
|
|
.Sy xbase
|
|
sets for m68k-based platforms), this hierarchy will have a second root of
|
|
.Sm off
|
|
.Xo
|
|
.Sy .../NetBSD-
|
|
.Em <rel>
|
|
.Sy /
|
|
.Em <machine_arch>
|
|
.Sy /
|
|
.Xc
|
|
.Sm on
|
|
which will contain those files. For files which are completely
|
|
machine-independent (e.g. the
|
|
.Sy xfont
|
|
set), this hierarchy will have a third root of
|
|
.Sy .../NetBSD- Ns Em <rel> Ns Sy /mi/
|
|
which will contain those files.
|
|
Unless otherwise noted, all files may be symbolic links to common
|
|
.Em <machine_arch>
|
|
or machine-independent files located in their respective directory
|
|
hierarchies.
|
|
.Bl -tag -width "installation/"
|
|
.It Sy SOURCE_DATE
|
|
a file containing the date, in UTC, of the source code from which the
|
|
release or snapshot was built, in the default format produced by the
|
|
command:
|
|
.Sy date -u
|
|
.It Sy INSTALL.txt
|
|
Installation notes, including complete descriptions of files contained
|
|
within the release hierarchy
|
|
.It Sy INSTALL.more
|
|
pretty version of this, suited for viewing with
|
|
.Xr more 1
|
|
.It Sy INSTALL.html
|
|
HTML version of this
|
|
.It Sy INSTALL.ps
|
|
PostScript version of this
|
|
.It Sy binary/
|
|
system binaries
|
|
.Bl -tag -width "security/"
|
|
.It Sy sets/
|
|
installation sets
|
|
.Bl -tag -width "xcontrib.tgz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy SYSVSUM
|
|
.It Sy Split/
|
|
installation sets split with the
|
|
.Xr split 1
|
|
command.
|
|
.Em "Note: split installation sets may not be available for all platforms" .
|
|
.Bl -tag -width "base.aa"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy SYSVSUM
|
|
.It Sy base.aa
|
|
.It Sy base.ab
|
|
.It Sy ...
|
|
.El
|
|
.It Sy base.tgz
|
|
The base binary distribution. This set contains the base
|
|
.Nx
|
|
utilities that are necessary for the system to run and be minimally
|
|
functional. It includes shared libraries for those architectures that
|
|
support support them. This set excludes all things listed in the sets
|
|
described below.
|
|
.It Sy comp.tgz
|
|
The compiler tools distribution. This set contains the C and C++
|
|
compilers, assembler, linker, other toolchain components, and their
|
|
manual pages. It also includes the system include files
|
|
.Pq Pa /usr/include
|
|
, and the static system libraries.
|
|
.It Sy etc.tgz
|
|
This set contains the system configuration files that reside in
|
|
.Pa /etc
|
|
and in several other places throughout the file system hierarchy.
|
|
.It Sy games.tgz
|
|
This set includes the games and their manual pages.
|
|
.It Sy kern.tgz
|
|
This set includes a generic kernel.
|
|
.It Sy man.tgz
|
|
This set includes all of the manual pages for the binaries and other
|
|
software contained in the
|
|
.Sy base
|
|
set which are not included in the other sets.
|
|
.It Sy misc.tgz
|
|
This set includes the system dictionaries (which are rather large), the
|
|
typesettable document set, and manual pages for other architectures, which
|
|
happen to be installed from the source tree by default.
|
|
.It Sy text.tgz
|
|
This set includes the
|
|
.Nx
|
|
text processing tools, including
|
|
.Xr groff 1 ,
|
|
all related programs, and their manual pages.
|
|
.It Sy xbase.tgz
|
|
This set includes the base X11 distribution, including manual pages and
|
|
shared libraries for those architectures that support them, and excluding
|
|
everything contained in the other X11 sets.
|
|
.It Sy xcomp.tgz
|
|
This set includes the X11 include files and static X11 libraries.
|
|
.It Sy xcontrib.tgz
|
|
This set includes binaries and manual pages for programs built from the
|
|
X11
|
|
.Dq contrib
|
|
sources.
|
|
.It Sy xfont.tgz
|
|
This set includes the X11 fonts.
|
|
.It Sy xserver.tgz
|
|
This set includes the X servers and manual pages for <machine>.
|
|
.Em "Note: this set may not be available on some platforms" .
|
|
.El
|
|
.It Sy kernel/
|
|
suitably named, gzipped kernels
|
|
.Bl -tag -width "netbsd-GENERIC.gz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Sy netbsd-GENERIC.gz
|
|
A kernel built from the
|
|
.Sy GENERIC
|
|
kernel configuration file. This is meant as an example only; different
|
|
platforms may have differently named kernels.
|
|
.El
|
|
.It Sy security/
|
|
security-related system binaries
|
|
.Bl -tag -width "secr.tgz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy SYSVSUM
|
|
.It Sy Split/
|
|
.Bl -tag -width "secr.aa"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy SYSVSUM
|
|
.It Sy secr.aa
|
|
.It Sy secr.ab
|
|
.It Sy ...
|
|
.El
|
|
.It Sy secr.tgz
|
|
This set contains executables which are built from the
|
|
.Dq Pa src/domestic
|
|
portion of the
|
|
.Nx
|
|
source tree. It can only be found on those sites
|
|
which carry the complete
|
|
.Nx
|
|
distribution and can legally obtain it.
|
|
(Remember, because of United States law, it may not be legal to distribute
|
|
this set to locations outside the United States and Canada.)
|
|
.El
|
|
.El
|
|
.It Sy installation/
|
|
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 make release
|
|
in both
|
|
.Pa src
|
|
and
|
|
.Pa xsrc .
|
|
.Bl -tag -width "netbsd-ARCH.iso"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Xo
|
|
.Sm off
|
|
.Sy netbsd-
|
|
.Em <machine_arch>
|
|
.Sy .iso
|
|
.Sm on
|
|
.Xc
|
|
.El
|
|
.It Sy diskimage/
|
|
disk images, for those platforms that provide them
|
|
.Bl -tag -width "diskimage-rz25.gz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Sy diskimage-rz25.gz
|
|
.El
|
|
.It Sy floppy/
|
|
floppy images, for those platforms that provide them
|
|
.Bl -tag -width "floppy-144.gz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Sy floppy-144.gz
|
|
.El
|
|
.It Sy miniroot/
|
|
miniroot images, for those platforms that provide them
|
|
.Bl -tag -width "miniroot.gz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Sy miniroot.gz
|
|
.El
|
|
.It Sy misc/
|
|
miscellaneous installation helper utilities, including boot selectors,
|
|
floppy writing software, other software that runs under foreign operating
|
|
systems, etc.
|
|
.Bl -tag -width "CKSUMS"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Sy ...
|
|
.El
|
|
.It Sy netboot/
|
|
network boot programs
|
|
.Bl -tag -width "netboot.gz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Sy netboot.gz
|
|
.El
|
|
.It Sy tapeimage/
|
|
tape images, for those platforms that provide them
|
|
.Bl -tag -width "tapeimage-hp9144.gz"
|
|
.It Sy BSDSUM
|
|
.It Sy CKSUM
|
|
.It Sy MD5
|
|
.It Sy README
|
|
.It Sy SYSVSUM
|
|
.It Sy tapeimage-hp9144.gz
|
|
.El
|
|
.El
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr cksum 1 ,
|
|
.Xr date 1 ,
|
|
.Xr gzip 1 ,
|
|
.Xr split 1 ,
|
|
.Xr tar 1
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
manual page first appeared in
|
|
.Nx 1.3 .
|