May 13, 2019 INSTALL 8 NetBSD

NAME

INSTALL - Installation procedure for NetBSD/evbarm.


                                                              
 About this Document............................................2
 What is NetBSD?................................................3
 Changes Between The NetBSD 8.1 and 8.2 Releases................3
 Features to be removed in a later release......................3
 The NetBSD Foundation..........................................3
 Sources of NetBSD..............................................3
 NetBSD 8.2 Release Contents....................................3
    NetBSD/evbarm subdirectory structure........................5
    Binary distribution sets....................................5
 NetBSD/evbarm System Requirements and Supported Devices........7
    Supported devices (Technologic Systems TS-7200).............7
       TS-5620 Real Time Clock..................................7
       Serial ports.............................................7
       Ethernet adapters........................................7
       Other on-board functions.................................7
    Supported devices (ARM, Ltd. Integrator)....................8
       PrimeCell PL030 Real Time Clock..........................8
       Serial ports.............................................8
       SCSI host adapters.......................................8
       Ethernet adapters........................................8
    Supported devices (Intel IQ80310)...........................8
       Serial ports.............................................8
       Ethernet adapters........................................8
       i80312 Companion I/O functions...........................8
    Supported devices (Intel IQ80321)...........................8
       Serial ports.............................................8
       Ethernet adapters........................................8
       i80321 I/O Processor functions...........................8
    Supported devices (Team ASA Npwr)...........................8
       Serial ports.............................................9
       SCSI host adapters.......................................9
       Ethernet adapters........................................9
    Supported devices (Intel IXM1200)...........................9
       Serial ports.............................................9
       Ethernet adapters........................................9
    Supported devices (Samsung SMDK2800)........................9
       Serial ports.............................................9
    Supported devices (ADI BRH).................................9
       Serial ports.............................................9
       Ethernet adapters........................................9
    Supported devices (Arcom Viper).............................9
       Serial ports.............................................9
       Ethernet adapters........................................9
 Getting the NetBSD System on to Useful Media...................9
 Preparing your System for NetBSD installation.................12
    Preparation for the Technologic Systems TS-7200............12
    Preparation for the Intel IQ80310..........................13
    Preparation for the Intel IQ80321..........................15
 Installing the NetBSD System..................................17
    Installation for the Technologic Systems TS-7200...........17
    Installation for the Intel IQ80310.........................17
    Installation for the Intel IQ80321.........................19
 Post installation steps.......................................20
 Upgrading a previously-installed NetBSD System................22
 Compatibility Issues With Previous NetBSD Releases............23
    Important note regarding ABI change on ARM ports...........23
    Issues affecting an upgrade from NetBSD 5.x releases.......24
    Issues affecting an upgrade from NetBSD 6.x releases.......24
    Issues affecting an upgrade from NetBSD 7.x releases.......24
 Using online NetBSD documentation.............................25
 Administrivia.................................................25
 Thanks go to..................................................26
 We are........................................................26
 Legal Mumbo-Jumbo.............................................33
 The End.......................................................40

DESCRIPTION

About this Document

This document describes the installation procedure for NetBSD 8.2 on the evbarm platform. It is available in four different formats titled INSTALL.ext, where .ext is one of .ps, .html, .more, or .txt:

.ps: PostScript.
.html: Standard Internet HTML.
.more: The enhanced text format used on UNIX-like systems by the more(1) and less(1) pager utility programs. This is the format in which the on-line man pages are generally presented.
.txt: Plain old ASCII.

You are reading the HTML version.

What is NetBSD?

The NetBSD Operating System is a fully functional Open Source UNIX-like operating system derived from the University of California, Berkeley Networking Release 2 (Net/2), 4.4BSD-Lite, and 4.4BSD-Lite2 sources. NetBSD runs on many different different system architectures (ports) across a variety of distinct CPU families, and is being ported to more. The NetBSD 8.2 release contains complete binary releases for most of these system architectures, with preliminary support for the others included in source form. Please see the NetBSD website at http://www.NetBSD.org/ for information on them.)

NetBSD is a completely integrated system. In addition to its highly portable, high performance kernel, NetBSD features a complete set of user utilities, compilers for several languages, the X Window System, firewall software and numerous other tools, all accompanied by full source code.

NetBSD is a creation of the members of the Internet community. Without the unique cooperation and coordination the net makes possible, NetBSD would not exist.

Changes Between The NetBSD 8.1 and 8.2 Releases

The NetBSD 8.2 release is the first security/critical update of the NetBSD 8 release branch. It represents a selected subset of fixes deemed important for security or stability reasons. The complete list of changes can be found in the CHANGES-8.2:
https://cdn.netbsd.org/pub/NetBSD/NetBSD-8.2/CHANGES-8.2
file in the top level directory of the NetBSD 8.2 release tree.

The release anouncements, status, updates and links to other resources can be found at
https://www.netbsd.org/releases/formal-8/

Features to be removed in a later release

The following features are to be removed from NetBSD in the future:

dhclient(8) in favor of dhcpcd(8).
groff(1). Man pages are now handled with mandoc(1), and groff(1) can still be found in pkgsrc as textproc/groff.
rtsol(8) and rtsold(8).

The NetBSD Foundation

The NetBSD Foundation is a tax exempt, not-for-profit 501(c)(3) corporation that devotes itself to the traditional goals and Spirit of the NetBSD Project and owns the trademark of the word ``NetBSD''. It supports the design, development, and adoption of NetBSD worldwide. More information on the NetBSD Foundation, its composition, aims, and work can be found at:
http://www.NetBSD.org/foundation/

Sources of NetBSD

Refer to
http://www.NetBSD.org/mirrors/

NetBSD 8.2 Release Contents

The root directory of the NetBSD 8.2 release is organized as follows:

.../NetBSD-8.2/

CHANGES: Changes between the 7.0 and 8.0 releases.
CHANGES-8.0: Changes between the initial 8.0 branch and final release of 8.0.
CHANGES-8.1: Changes between the 8.0 release and the 8.1 release.
CHANGES-8.2: Changes between the 8.1 release and the 8.2 release.
CHANGES.prev: Changes in previous NetBSD releases.
LAST_MINUTE: Last minute changes and notes about the release.
README.files: README describing the distribution's contents.
images/: Images (ISO 9660 or USB) for installing NetBSD. Depending on your system, these may be bootable.
source/: Source distribution sets; see below.

In addition to the files and directories listed above, there is one directory per architecture, for each of the architectures for which NetBSD 8.2 has a binary distribution.

The source distribution sets can be found in subdirectories of the source subdirectory of the distribution tree. They contain the complete sources to the system. The source distribution sets are as follows:

gnusrc: This set contains the ``gnu'' sources, including the source for the compiler, assembler, groff, and the other GNU utilities in the binary distribution sets.
sharesrc: This set contains the ``share'' sources, which include the sources for the man pages not associated with any particular program; the sources for the typesettable document set; the dictionaries; and more.
src: This set contains all of the base NetBSD 8.2 sources which are not in gnusrc, sharesrc, or syssrc.
syssrc: This set contains the sources to the NetBSD 8.2 kernel for all architectures as well as the config(1) utility.
xsrc: This set contains the sources to the X Window System.

All the above source sets are located in the source/sets subdirectory of the distribution tree.

The source sets are distributed as compressed tar files. Except for the pkgsrc set, which is traditionally unpacked into /usr/pkgsrc, all sets may be unpacked into /usr/src with the command:
# cd / ; tar -zxpf set_name.tgz

In each of the source distribution set directories, there are files which contain the checksums of the files in the directory:

MD5: MD5 digests in the format produced by the command:
cksum -a MD5 file.
SHA512: SHA512 digests 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.

NetBSD/evbarm subdirectory structure

The evbarm-specific portion of the NetBSD 8.2 release is found in the evbarm subdirectory of the distribution: .../NetBSD-8.2/evbarm/. It contains the following files and directories:

INSTALL.html

INSTALL.ps

INSTALL.txt

INSTALL.more

Installation notes in various file formats, including this file. The .more file contains underlined text using the more(1) conventions for indicating italic and bold display.

binary/

kernel/

netbsd-GENERIC.gz: A gzipped NetBSD kernel containing code for everything supported in this release.

sets/

evbarm binary distribution sets; see below.

installation/

misc/: Miscellaneous evbarm installation utilities; see installation section below.

Binary distribution sets

The NetBSD evbarm binary distribution sets contain the binaries which comprise the NetBSD 8.2 release for evbarm. The binary distribution sets can be found in the evbarm/binary/sets subdirectory of the NetBSD 8.2 distribution tree, and are as follows:

base

The NetBSD 8.2 evbarm base binary distribution. You must install this distribution set. It contains the base NetBSD utilities that are necessary for the system to run and be minimally functional.

comp

Things needed for compiling programs. This set includes the system include files (/usr/include) and the various system libraries (except the shared libraries, which are included as part of the base set). This set also includes the manual pages for all of the utilities it contains, as well as the system call and library manual pages.

debug

This distribution set contains debug information for all base system utilities. It is usefull when reporting issues with binaries or during developement. This set is huge, if the target disk is small, do not install it.

etc

This distribution set contains the system configuration files that reside in /etc and in several other places. This set must be installed if you are installing the system from scratch, but should not be used if you are upgrading.

games

This set includes the games and their manual pages.

kern-INTEGRATOR

(see below)

kern-IQ80310

(see below)

kern-IQ80321

(see below)

kern-TEAMASA_NPWR

These sets contain a NetBSD/evbarm 8.2 kernel, named /netbsd. Some of these sets also contain a binary format kernel named /netbsd.bin and an S-record format kernel named /netbsd.srec that your firmware may need to boot. You must install the kernel that matches your hardware.

man

This set includes all of the manual pages for the binaries and other software contained in the base set. Note that it does not include any of the manual pages that are included in the other sets.

misc

This set includes the system dictionaries, the typesettable document set, and other files from /usr/share.

modules

This set includes kernel modules to add functionality to a running system.

text

This set includes NetBSD's text processing tools, including groff(1), all related programs, and their manual pages.

NetBSD maintains its own set of sources for the X Window System in order to assure tight integration and compatibility. These sources are based on X.Org. Binary sets for the X Window System are distributed with NetBSD. The sets are:

xbase: The basic files needed for a complete X client environment. This does not include the X servers.
xcomp: The extra libraries and include files needed to compile X source code.
xdebug: This distribution set contains debug information for all X11 binaries. It is usefull when reporting issues with these binaries or during developement. This set is huge, if the target disk is small, do not install it.
xfont: Fonts needed by the X server and by X clients.
xetc: Configuration files for X which could be locally modified.
xserver: The X server.

The evbarm binary distribution sets are distributed as gzipped tar files named with the extension .tgz, e.g. base.tgz.

The instructions given for extracting the source sets work equally well for the binary sets, but it is worth noting that if you use that method, the filenames stored in the sets are relative and therefore the files are extracted below the current directory. Therefore, if you want to extract the binaries into your system, i.e. replace the system binaries with them, you have to run the tar -xzpf command from the root directory ( / ) of your system.

Note:: Each directory in the evbarm binary distribution also has its own checksum files, just as the source distribution does.