release man page on NetBSD

Man page or keyword search:  
man Server   9087 pages
apropos Keyword Search (all sections)
Output format
NetBSD logo
[printable version]

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
     include 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”
		directory.  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
					    intended 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,
				     libraries, 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
			       hierarchy

		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
						     include 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
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server NetBSD

List of man pages available for NetBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net