Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RELEASE(7)	     BSD Miscellaneous Information Manual	    RELEASE(7)

NAME
     release --	layout of NetBSD releases and snapshots

DESCRIPTION
     This document describes the layout	of NetBSD releases and snapshots.
     This layout should	be consistent between FTP servers and CD-ROMs, except
     possibly the path that leads to the release hierarchy.

     In	this document, the following special words have	these definitions:

     <machine>	     The platform for which the	release	was built, correspond-
		     ing to the	hw.machine sysctl variable, e.g., i386 or
		     amiga.

     <machine_arch>  The architecture for which	a particular installation set
		     was built,	corresponding to the hw.machine_arch sysctl
		     variable, e.g., i386 or m68k.

     <rel>	     The release version number.

     All README	files are descriptions of the various files in directories
     that have "non-standard" contents.	 There may also	be a README file at
     the top-level, describing who built the snapshot and under	what circum-
     stances (e.g., whether it's an official NetBSD snapshot, or not).

     All MD5 files are MD5 digests for the various files in that directory, in
     the format	produced by the	command: cksum -m <file>.

     All SHA512	files are SHA512 digests for the various files in that direc-
     tory, in the format produced by the command: cksum	-a SHA512 <file>.

     The SHA512	digest is safer, but MD5 checksums are provided	so that	a
     wider range of operating systems can check	the integrity of the release
     files.

     Files that	end in .tgz are	gzipped	tar archives.  This is used in lieu of
     .tar.gz because the software used to download the sets may	incorrectly
     auto-unpack files ending in .gz and to accommodate	systems	which only
     support 3 character extensions to file names.

     All tar archives are relative to the target's / directory,	and do not in-
     clude the leading "/".

     The root of the release hierarchy may be the root directory of a CD-ROM,
     but in all	other cases it should be .../NetBSD-<rel>/.

     The root of the release hierarchy should contain the following files and
     subdirectories:

     images/	Image files intended for use in	installing NetBSD.  There are
		different types	of images for different	platforms, and some-
		times multiple different image types for a single platform.

		Images in this directory, unlike images	in the
		.../NetBSD-<rel>/<machine>/installation/ directories, contain
		file systems that have an internal layout that corresponds to
		a complete release for a given machine type.  If built with
		"iso-image-source", then it will also contain a	"source" di-
		rectory.  These	images are usually bootable.

		MD5

		SHA512

		NetBSD-<rel>-<machine>.iso  CDROM images in ISO	9660 format,
					    usually created with "./build.sh
					    ...	iso-image ..." after a
					    "./build.sh	-x ... release ..." in
					    src	or created with	"./build.sh
					    ...	iso-image-source ..." after a
					    "./build.sh	-x ... release
					    sourcesets ..." in src.

		NetBSD-<rel>-<machine>-install.img.gz
					    Bootable installation images in-
					    tended to be written to any	drive
					    which appears as an	sd(4) type,
					    such as USB	flash disks.  These
					    images are created with
					    "./build.sh	... install-image" in
					    src.

     shared/	Files shared by	two or more machine types.

		<machine_arch>/
				Files which may	be shared by all systems of
				the same <machine_arch>	will be	located	in
				.../NetBSD-<rel>/shared/<machine_arch>/	with
				symbolic links pointing	to these files from
				the <machine> subdirectory.

		ALL/		Files which are	completely machine-independent
				will be	located	in
				.../NetBSD-<rel>/shared/ALL/ with symbolic
				links pointing to these	files from the
				<machine> subdirectory.

     source/	Source code of the operating system should be put into
		.../NetBSD-<rel>/source/ using the following layout:

		sets/  Sources for the various system sets.

		       MD5

		       SHA512

		       gnusrc.tgz    Contains sources for all GPLed and	possi-
				     bly other programs	that contains restric-
				     tions in their licensing that prevent
				     others from using these programs in
				     closed-source environments.

		       sharesrc.tgz  Contains machine-independent data files
				     that can be shared	across architec-
				     tures/systems.

		       src.tgz	     The operating system's userland source
				     code, including all programs, tools, li-
				     braries, etc.

		       syssrc.tgz    Kernel sources for	all architectures plus
				     sources of	the tools needed to build ker-
				     nels (like	config(1)).

		       xsrc.tgz	     Source code of the	X Window System	used
				     on	all NetBSD architectures.  Includes X
				     clients and servers.

     <machine>/
		The binary releases in .../NetBSD-<rel>/<machine>/ fit the
		following layout:

		INSTALL.txt    Installation notes, including complete descrip-
			       tions of	files contained	within the release hi-
			       erarchy

		INSTALL.more   pretty version, suited for viewing with more(1)

		INSTALL.html   HTML version

		INSTALL.ps     PostScript version

		binary/	       system binaries

			       sets/	installation sets

					MD5

					SHA512

					base.tgz     The base binary distribu-
						     tion.  This set contains
						     the base NetBSD utilities
						     that are necessary	for
						     the system	to run and be
						     minimally functional.
						     This set excludes all
						     things listed in the sets
						     described below.

					comp.tgz     The compiler tools	dis-
						     tribution.	 This set con-
						     tains the C and C++ com-
						     pilers, assembler,
						     linker, other toolchain
						     components, and their
						     manual pages.  It also
						     includes the system in-
						     clude files
						     (/usr/include) and	the
						     static system libraries.

					etc.tgz	     This set contains the
						     system configuration
						     files that	reside in /etc
						     and in several other
						     places throughout the
						     file system hierarchy.

					games.tgz    This set includes the
						     games and their manual
						     pages.

					kern.tgz     This set includes a
						     generic kernel.

					man.tgz	     This set includes all of
						     the manual	pages for the
						     binaries and other	soft-
						     ware contained in the
						     base set which are	not
						     included in the other
						     sets.

					misc.tgz     This set includes miscel-
						     laneous non-essential
						     files, including dictio-
						     naries, the typesettable
						     document set, and various
						     other documentation and
						     example configuration
						     files.

					modules.tgz  This set includes all the
						     kernel modules.

					text.tgz     This set includes the
						     NetBSD text processing
						     tools, including
						     groff(1), all related
						     programs, and their man-
						     ual pages.

					xbase.tgz    This set includes the
						     base X11 distribution,
						     including manual pages
						     and excluding everything
						     contained in the other
						     X11 sets.

					xcomp.tgz    This set includes the X11
						     include files and static
						     X11 libraries.

					xfont.tgz    This set includes the X11
						     fonts.

					xserver.tgz  This set includes the X
						     servers and manual	pages
						     for a given machine.
						     Note: this	set may	not be
						     available on some
						     platforms.

			       kernel/	suitably named,	gzipped	kernels

					MD5

					SHA512

					netbsd-GENERIC.gz  A kernel built from
							   the GENERIC kernel
							   configuration file.
							   This	is meant as an
							   example only; dif-
							   ferent platforms
							   may have differ-
							   ently named ker-
							   nels.

		installation/  installation helper items

			       cdrom/	   CDROM images	in ISO 9660 format,
					   created as part of "build.sh	...
					   release ..."	in src.

					   Images in this directory are
					   bootable, and contain one a kernel,
					   installation	tools, and rescue
					   tools.  They	do not contain instal-
					   lation sets,	source sets, or	other
					   components of a complete release.

					   Note: These images are only present
					   in the amd64	and i386
					   distributions.

					   MD5

					   SHA512

					   boot.iso	 VGA console

					   boot-com.iso	 Serial	console

			       diskimage/  disk	images,	on those platforms
					   that	provide	them

					   MD5

					   SHA512

					   diskimage.gz

			       floppy/	   floppy images, on those platforms
					   that	provide	them

					   MD5

					   SHA512

					   boot1.fs

					   boot2.fs

			       instkernel/
					   installation	kernels	for platforms
					   that	can boot them directly

					   MD5

					   SHA512

					   netbsd.gz

			       miniroot/   miniroot images, on those platforms
					   that	provide	them

					   MD5

					   SHA512

					   miniroot.fs.gz

			       misc/	   miscellaneous installation helper
					   utilities, including	boot selec-
					   tors, floppy	writing	software,
					   other software that runs under for-
					   eign	operating systems, etc.

					   MD5

					   SHA512

					   ...

			       netboot/	   network boot	programs

					   MD5

					   SHA512

					   netboot.gz

			       tapeimage/  tape	images,	on those platforms
					   that	provide	them

					   MD5

					   SHA512

					   tapeboot

SEE ALSO
     cksum(1), gzip(1),	split(1), tar(1)

HISTORY
     The release manual	page first appeared in NetBSD 1.3.

BSD			       September 6, 2012			   BSD

NAME | DESCRIPTION | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=release&sektion=7&manpath=NetBSD+6.0>

home | help