INSTALL(8) NetBSD System Manager's Manual INSTALL(8)
NAME
INSTALL - Installation procedure for NetBSD/acorn32.
CONTENTS
About this Document............................................1
What is NetBSD?................................................2
Upgrade path to NetBSD 1.5.1...................................2
Major Changes Between 1.5 and 1.5.1............................2
Changes Between The NetBSD 1.4 and 1.5 Releases................4
Kernel......................................................4
Networking..................................................4
File system.................................................5
Security....................................................5
System administration and user tools........................5
Miscellaneous...............................................6
The Future of NetBSD...........................................6
Sources of NetBSD..............................................7
NetBSD 1.5ZC Release Contents..................................7
NetBSD/acorn32 subdirectory structure.......................9
Binary distribution sets....................................9
NetBSD/acorn32 System Requirements and Supported Devices......10
Supported devices..........................................10
Unsupported devices........................................11
Getting the NetBSD System on to Useful Media..................12
Preparing your System for NetBSD installation.................14
Installing the NetBSD System..................................14
To install from floppy.....................................16
To install from tape.......................................17
To install via FTP or NFS..................................18
To install from CD-ROM.....................................19
Completing your installation...............................19
Post installation steps.......................................19
Upgrading a previously-installed NetBSD System................22
Compatibility Issues With Previous NetBSD Releases............22
General issues.............................................23
Issues affecting an upgrade from NetBSD 1.4 or prior.......23
Using online NetBSD documentation.............................23
Administrivia.................................................24
Thanks go to..................................................24
We are........................................................27
Legal Mumbo-Jumbo.............................................30
The End.......................................................32
DESCRIPTION
About this Document
This document describes the installation procedure for NetBSD 1.5ZC on
the acorn32 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 pre-
sented.
.txt Plain old ASCII.
You are reading the ASCII 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 Net-
working Release 2 (Net/2), 4.4BSD-Lite, and 4.4BSD-Lite2 sources. NetBSD
runs on thirty-one different system architectures featuring twelve dis-
tinct families of CPUs, and is being ported to more. The NetBSD 1.5ZC re-
lease contains complete binary releases for fifteen different machine
types. (The sixteen remaining are not fully supported at this time and
are thus not part of the binary distribution. For information on them,
please see the NetBSD web site at
http://www.netbsd.org/.)
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, it's
likely that NetBSD wouldn't exist.
Upgrade path to NetBSD 1.5.1
If you are not installing your system ``from scratch'' but instead are
going to upgrade an existing system already running NetBSD you need to
know which versions you can upgrade with NetBSD 1.5.1.
NetBSD 1.5.1 is an upgrade of NetBSD 1.5 and earlier major and patch
releases of NetBSD.
The intermediate development versions of code available on the main trunk
in our CVS repository (also known as ``NetBSD-current'') from after the
point where the release cycle for 1.5 was started are designated by ver-
sion identifiers such as 1.5A, 1.5B, etc. These identifiers do not des-
ignate releases, but indicate major changes in internal kernel APIs.
Note that the kernel from NetBSD 1.5.1 can not be used to upgrade a sys-
tem running one of those intermediate development versions. Trying to
use the NetBSD 1.5.1 kernel on such a system will probably result in
problems.
Please also note that it is not possible to do a direct ``version'' com-
parison between any of the intermediate development versions mentioned
above and 1.5.1 to determine if a given feature is present or absent in
1.5.1. The development of 1.5 and the subsequent ``point'' releases is
done on a separate branch in the CVS repository. The branch was created
when the release cycle for 1.5 was started, and during the release cycle
of 1.5 and its patch releases, selected fixes and enhancements have been
imported from the main development trunk. So, there are features in
1.5.1 which were not in, e.g. 1.5B, and vice versa.
Major Changes Between 1.5 and 1.5.1
The complete list of changes between NetBSD 1.5 and 1.5.1 can be found in
the file CHANGES-1.5.1 in the top directory of the source tree. The fol-
lowing are highlights only:
o A driver for the Aironet/Cisco wireless PCMCIA cards has been added;
see an(4).
o NFS client performance has been improved, typically by 40% for writes
but possibly up to 100% in certain setups.
o The siop(4) driver has improved in performance and robustness.
o Support for cloning pseudo-interfaces has been added. See
ifconfig(8).
o Support for 802.1Q virtual LANs has been added. See vlan(4).
o The isp(4) driver has been upgraded to (among other things) work on
MacPPC.
o BIND has been upgraded to version 8.2.3 (SA2001-001).
o Support for booting from RAIDframe RAID1 mirrors on i386 added.
o The lfs(4) file system has again been substantially updated, but is
still experimental.
o Ultra/66 support has been added for capable VIA chipsets, and Ul-
tra/100 support has been added for the HPT370, Promise and Intel ICH2
controllers in the pciide(4) driver. Support for Intel 82801BAM con-
trollers has also been added, and handling of Ali controllers has
been improved.
o OpenSSH has been updated to deal with a security issue (SA2001-003).
o Sendmail has been upgraded to version 8.11.3.
o The ex(4) driver has added support for 3Com 3c555, 3c556 and 3c556B
MiniPCI Ethernet cards.
o A driver for the on-board audio hardware found on many Apple PowerMa-
cs has been added; see awacs(4).
o The sip(4) driver has been fixed to properly support the dp83815, as
found in current Netgear FA311 10/100 cards.
o ftpd(8) has been updated to deal with two security issues (SA2000-018
and SA2001-005).
o ntpd(8) has been updated to deal with a security issue (SA2001-004).
o telnetd(8) has been updated to deal with a security issue
(SA2000-017).
o A vulnerability on i386 related to USER_LDT has been fixed
(SA2001-002).
o The Linux emulation has been enhanced to prepare for the support of
using the Linux version of VMware.
o IP checksumming speed has been improved on i386 compared to
NetBSD 1.5 by about 10%.
o Support for the Socket Communications LP-E Type II PCMCIA NE2000
clone card has been added to ne(4).
o The DHCP software has been upgraded to ISC version 3, Beta 2, patch-
level 23, to fix core dumps in dhclient(8), among other things.
Please note that the new dhcpd(8) forces you to configure a "ddns-up-
date-style" of either "ad-hoc", "interim" or "none".
o Various fixes and enhancements to INET6 and IPSEC code; among them
improved interaction between IPF/Nat and IPSEC.
o The Heimdal kerberos(8) implementation has been upgraded to version
0.3e.
o Support for Accton EN2242 and other AmdTek AN985 cards added to the
tlp(4) driver.
o Several country-specific keyboard mappings have been added for USB
keyboards.
o A driver for Yamaha YMF724/740/744/745-based sound cards has been
added, see yds(4).
o The maximum number of BSD disklabel partitions on the i386 port has
been increased from 8 to 16.
o Drivers for the AC'97 based audio sound chips ESS Technology Maestro
1, 2, and 2E (see esm(4)), NeoMagic 256 (see neo(4)), and Cirrus Log-
ic CrystalClear PCI Audio CS4281 (see clct(4)) have been added.
In addition, many bugs have been fixed--more than 95 problems reported
through our problem tracking system have been fixed, and some other non-
reported problems have also been found and fixed. See the CHANGES-1.5.1
file for the complete list.
Changes Between The NetBSD 1.4 and 1.5 Releases
The NetBSD 1.5 release provides numerous significant functional enhance-
ments, including support for many new devices, integration of hundreds of
bug fixes, new and updated kernel subsystems, and many userland enhance-
ments. The result of these improvements is a stable operating system fit
for production use that rivals most commercially available systems.
It is impossible to completely summarize over one year of development
that went into the NetBSD 1.5ZC release. Some highlights include:
Kernel
o Ports to new platforms including: arc, cobalt, hpcmips, news68k,
sgimips, and sparc64.
o Improved performance and stability of the UVM virtual memory subsys-
tem.
o Implementation of generic kernel locking code, as well as a restruc-
ture and re-tuning of the scheduler, to be used by the future symmet-
ric multi-processing (SMP) implementation.
o Improved compatibility support for Linux, OSF1, and SVR4 programs.
o New compatibility support for Win32 programs.
o Support for dynamically loaded ELF kernel modules.
o Kernel process tracing using ktruss(1).
o Deletion of swap devices using swapctl(8).
o Easier hot-pluggability of keyboards and mice using a new wscons de-
vice--wsmux.
o Improved PCMCIA and CardBus support, including support for detaching
of devices and cards, resulting in better support for notebooks and
PDA devices.
o Numerous hardware improvements, including areas such as: audio, UD-
MA/66 support for ATA drives, USB, and wireless networking.
Networking
o Addition of IP version 6 (IPv6) and IPsec to the networking stack,
from the KAME project. This includes addition of kernel code for
IPv6/IPsec, IPv4/v6 dual-stack user applications and supporting li-
braries. Due to this, the shlib major version for pcap(3) is incre-
mented and you may need to recompile userland tools. The KAME IPv6
part includes results from the unified-IPv6 effort.
File system
o Significant Fast file system (FFS) performance enhancements via inte-
gration of Kirk McKusick's soft updates and trickle sync code.
o Support for the Windows NT `NTFS' file system (read-only at this
stage).
o Support for revision 1 of the Linux `ext2fs' file system.
o Enhanced stability and usability of LFS (the BSD log-structured file
system).
o Various RAIDframe enhancements including: auto-detection of RAID com-
ponents and auto-configuration of RAID sets, and the ability to con-
figure the root file system (/) on a RAID set.
o Support for Microsoft Joliet extensions to the ISO9660 CD file sys-
tem.
o Improved file system vnode locking mechanisms, thus resolving a
source of several panics in the past.
o Support for NFS and RPC over IPv6.
o The server part of NFS locking (implemented by rpc.lockd(8)) now
works.
Security
o Strong cryptographic libraries and applications integrated, including
the AES cipher Rijndael, the OpenSSL library, more complete Kerberos
IV and Kerberos V support, and an SSH server and client.
o sysctl(3) interfaces to various elements of process and system infor-
mation, allowing programs such as ps(1), dmesg(1) and the like to op-
erate without recompilation after kernel upgrades, and remove the ne-
cessity to run setgid kmem (thus improving system security).
o Disable various services by default, and set the default options for
disabled daemons to a higher level of logging.
o Several code audits were performed. One audit replaced string rou-
tines that were used without bounds checking, and another one identi-
fied and disabled places where format strings were used in unsafe
ways, allowing arbitrary data to be entered by (possibly) malicious
users to overwrite application code, and leading from Denial of Ser-
vice attacks to compromised systems.
o sshd(8) and ssh(1) now require rnd(4) kernel random number devices.
System administration and user tools
o Conversion of the rc(8) system startup and shutdown scripts to an
`rc.d' mechanism, with separate control scripts for each service, and
appropriate dependency ordering provided by rcorder(8).
o postfix(1) provided as alternative mail transport agent to
sendmail(8).
o User management tools useradd(8), usermod(8), userdel(8),
groupadd(8), groupmod(8), and groupdel(8) added to the system.
o Incorporation of a login class capability database (/etc/login.conf)
from BSD/OS.
o Improved support for usernames longer than eight characters in pro-
grams such as at(1) and w(1).
o Many enhancements to ftpd(8) providing features found in larger and
less secure FTP daemons, such as user classes, connection limits, im-
proved support for virtual hosting, transfer statistics, transfer
rate throttling, and support for various IETF ftpext working group
extensions.
o The ftp(1) client has been improved even further, including transfer
rate throttling, improved URL support, command line uploads. See the
man page for details.
Miscellaneous
o Updates to the NetBSD source code style code (located in
/usr/share/misc/style) to use ANSI C only (instead of K&R) and re-
flect current (best) practice, and begin migrating the NetBSD source
code to follow it.
o Implementation of many SUSv2 features to the curses(3) library, in-
cluding support for color.
o Updates of most third party packages that are shipped in the base
system, including file(1), ipfilter(4), ppp(4), and sendmail(8) to
the latest stable release.
o Many new packages in the pkgsrc system, including standard desktops
like KDE and GNOME as well as latest Tcl/Tk and perl and many of the
components of the Java Enterprise platform. The package framework
itself now has full wildcard dependency support.
Kernel interfaces have continued to be refined, and more subsystems and
device drivers are shared among the different ports. You can look for
this trend to continue.
NetBSD 1.5ZC on acorn32 is, as usual, also fully backward compatible with
old NetBSD acorn32 binaries, so you don't need to recompile all your lo-
cal programs provided you set the appropriate binary compatibility op-
tions in your kernel configuration.
New port-specific features include:
o Addition of Xarm32VIDC Xserver for RiscPC and ARM7500 based systems.
The Future of NetBSD
The NetBSD Foundation has been incorporated as a non-profit organization.
Its purpose is to encourage, foster and promote the free exchange of com-
puter software, namely the NetBSD Operating System. The foundation will
allow for many things to be handled more smoothly than could be done with
our previous informal organization. In particular, it provides the
framework to deal with other parties that wish to become involved in the
NetBSD Project.
The NetBSD Foundation will help improve the quality of NetBSD by:
o providing better organization to keep track of development efforts,
including co-ordination with groups working in related fields.
o providing a framework to receive donations of goods and services and
to own the resources necessary to run the NetBSD Project.
o providing a better position from which to undertake promotional ac-
tivities.
o periodically organizing workshops for developers and other interested
people to discuss ongoing work.
We intend to begin narrowing the time delay between releases. Our ambi-
tion is to provide a full release every six to eight months.
We hope to support even more hardware in the future, and we have a rather
large number of other ideas about what can be done to improve NetBSD.
We intend to continue our current practice of making the NetBSD-current
development source available on a daily basis.
We intend to integrate free, positive changes from whatever sources sub-
mit them, providing that they are well thought-out and increase the us-
ability of the system.
Above all, we hope to create a stable and accessible system, and to be
responsive to the needs and desires of NetBSD users, because it is for
and because of them that NetBSD exists.
Sources of NetBSD
Refer to
http://www.netbsd.org/Sites/net.html.
NetBSD 1.5ZC Release Contents
The root directory of the NetBSD 1.5ZC release is organized as follows:
.../NetBSD-1.5ZC/
CHANGES Changes since earlier NetBSD releases.
LAST_MINUTE Last minute changes.
MIRRORS A list of sites that mirror the NetBSD 1.5ZC distribution.
README.files README describing the distribution's contents.
TODO NetBSD 's todo list (also somewhat incomplete and out of
date).
patches/ Post-release source code patches.
source/ Source distribution sets; see below.
In addition to the files and directories listed above, there is one di-
rectory per architecture, for each of the architectures for which
NetBSD 1.5ZC has a binary distribution. There are also README.export-
control files sprinkled liberally throughout the distribution tree, which
point out that there are some portions of the distribution that may be
subject to export regulations of the United States, e.g. code under
src/crypto and src/sys/crypto. It is your responsibility to determine
whether or not it is legal for you to export these portions and to act
accordingly.
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.
22.3 MB gzipped, 98.8 MB uncompressed
pkgsrc This set contains the ``pkgsrc'' sources, which contain the in-
frastructure to build third-party packages.
7.4 MB gzipped, 73.0 MB uncompressed
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.
3.3 MB gzipped, 13.2 MB uncompressed
src This set contains all of the base NetBSD 1.5ZC sources which
are not in gnusrc, sharesrc, or syssrc.
24.8 MB gzipped, 123.1 MB uncompressed
syssrc This set contains the sources to the NetBSD 1.5ZC kernel for
all architectures; config(8); and dbsym(8).
18.0 MB gzipped, 90.9 MB uncompressed
xsrc This set contains the sources to the X Window System.
78.1 MB gzipped, 393.6 MB uncompressed
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. They may be un-
packed into /usr/src with the command:
# ( cd / ; tar -zxpf - ) < set_name.tgz
The sets/Split/ subdirectory contains split versions of the source sets
for those users who need to load the source sets from floppy or otherwise
need a split distribution. The split sets are named set_name.xx where
set_name is the distribution set name, and xx is the sequence number of
the file, starting with ``aa'' for the first file in the distribution
set, then ``ab'' for the next, and so on. All of these files except the
last one of each set should be exactly 240,640 bytes long. (The last file
is just long enough to contain the remainder of the data for that distri-
bution set.)
The split distributions may be reassembled and extracted with cat as fol-
lows:
# cat set_name.?? | ( cd / ; tar -zxpf - )
In each of the source distribution set directories, there are files which
contain the checksums of the files in the directory:
BSDSUM Historic BSD checksums for the various files in that di-
rectory, in the format produced by the command: cksum -o 1
file.
CKSUM POSIX checksums for the various files in that directory,
in the format produced by the command: cksum file.
MD5 MD5 digests for the various files in that directory, in
the format produced by the command: cksum -m file.
SYSVSUM Historic AT&T System V UNIX checksums for the various
files in that directory, in the format produced by the
command: cksum -o -2 file.
The MD5 digest is the safest checksum, followed by the POSIX checksum.
The other two checksums are provided only to ensure that the widest pos-
sible range of system can check the integrity of the release files.
NetBSD/acorn32 subdirectory structure
The acorn32-specific portion of the NetBSD 1.5ZC release is found in the
acorn32 subdirectory of the distribution: .../NetBSD-1.5ZC/acorn32/
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/ acorn32 binary distribution sets; see below.
installation/
floppy/ acorn32 boot and installation floppies; see
below.
misc/ Miscellaneous acorn32 installation utilities;
see installation section, below.
Binary distribution sets
The NetBSD acorn32 binary distribution sets contain the binaries which
comprise the NetBSD 1.5ZC release for the acorn32. There are eight binary
distribution sets. The binary distribution sets can be found in the
acorn32/binary/sets subdirectory of the NetBSD 1.5ZC distribution tree,
and are as follows:
base The NetBSD 1.5ZC acorn32 base binary distribution. You must in-
stall this distribution set. It contains the base NetBSD utili-
ties that are necessary for the system to run and be minimally
functional. It includes shared library support, and excludes
everything described below.
comp Things needed for compiling programs. This set includes the
system include files (/usr/include) and the various system li-
braries (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.
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.
0.1 MB gzipped, 0.6 MB uncompressed
games This set includes the games and their manual pages.
kern This set contains a NetBSD/acorn32 1.5ZC GENERIC kernel, named
/netbsd. You must install this distribution set.
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.
6.3 MB gzipped, 25.4 MB uncompressed
misc This set includes the (rather large) system dictionaries, the
typesettable document set, and other files from /usr/share.
2.6 MB gzipped, 10.1 MB uncompressed
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 XFree86, and tightly track XFree86 releases. They are currently
equivalent to XFree86 3.3.6. 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.
xcontrib Programs that were contributed to X.
xfont Fonts needed by X.
6.2 MB gzipped, 7.5 MB uncompressed
xmisc Miscellaneous X programs.
The acorn32 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 files are /-relative and therefore are extracted below the current
directory. That is, if you want to extract the binaries into your system,
i.e. replace the system binaries with them, you have to run the tar -xpf
command from /.
Note: Each directory in the acorn32 binary distribution also has its own
checksum files, just as the source distribution does.
NetBSD/acorn32 System Requirements and Supported Devices
NetBSD/acorn32 1.5ZC runs on Acorn systems with ARM6 or later processors,
with or without FPU coprocessor. The minimal configuration is said to re-
quire 8 MB of RAM and 50 MB of disk space, though we do not know of any-
one running with a system quite this minimal today. To install the entire
system requires much more disk space (the unpacked binary distribution,
without sources, requires at least 65 MB without counting space needed
for swap space, etc), and to run X or compile the system, more RAM is
recommended. (8 MB of RAM will actually allow you to run X and/or com-
pile, but it won't be speedy. Note that until you have around 16 MB of
RAM, getting more RAM is more important than getting a faster CPU.)
Supported devices
o RiscPC/A7000(+) floppy controller
o IDE controllers
- Acorn motherboard IDE
- Simtec IDE controller
- RapIDE Issue 2 IDE controller
- ICS V5 & V6 IDE controller
o SCSI host adapters
- Cumana SCSI 2
- PowerTec SCSI 2
- MCS Connect32 SCSI 2
- Acorn SCSI
- Oak SCSI I
- Morley SCSI I (uncached only)
o VIDC20 video
o RiscPC Motherboard serial port
o RiscPC Motherboard parallel port
o Ethernet adapters
- Acorn Ether1
- Atomwide Ether3
- ANT Ether3
- ANT Ether5
- Atomwide EtherA
- ANT EtherB
- Acorn EtherH
- I-cubed EtherH
- ANT EtherM
o Most SCSI disk drives
o Most SCSI tape drives
o CD-ROM drives
- Most SCSI CD-ROM drives
- Most ATAPI CD-ROM drives
Note: Some low-priced IDE CD-ROM drives are known for be-
ing not or not fully ATAPI compliant, and thus re-
quires some hack (generally an entry to a quirk
table) to work with NetBSD.
o Mice
- RiscPC quadrature mouse
- A7000 PS/2 mouse
o Processors
- ARM 610
- ARM 700
- ARM 700 + FPA11
- ARM 710
- ARM 7500
- ARM 7500FE
- ARM 810. [*]
- SA110
o Motherboards
- Acorn RiscPC
- Acorn A7000
- Acorn A7000+
o Other devices
- RiscPC keyboard
- A7000 keyboard
- RiscPC realtime clock
Drivers for hardware marked with ``[*]'' are not present in installation
kernels.
Support for some devices is limited to particular kernels. eg there is no
SA110 support in A7000 kernels.
Unsupported devices
o Acorn/Aleph1 PC cards
o Any SCSI card using a PowerROM
o Podule based serial ports
o Castle SCSI/Ethernet cards
Drivers are planned for some of the above devices.
Getting the NetBSD System on to Useful Media
Installation is supported from several media types, including:
o CD-ROM
o MS-DOS floppy
o FTP
o Remote NFS partition
o Tape
o Existing NetBSD partitions, if performing an upgrade
The steps necessary to prepare the distribution sets for installation de-
pend upon which installation medium you choose. The steps for the vari-
ous media are outlined below.
CD-ROM Find out where the distribution set files are on the CD-
ROM.
Proceed to the instruction on installation.
MS-DOS floppy Count the number of set_name.xx files that make up the
distribution sets you want to install or upgrade. You
will need one sixth that number of 1.44 MB floppies.
Format all of the floppies with MS-DOS. Do not make any
of them bootable MS-DOS floppies, i.e. don't use format /s
to format them. (If the floppies are bootable, then the
MS-DOS system files that make them bootable will take up
some space, and you won't be able to fit the distribution
set parts on the disks.) If you're using floppies that
are formatted for MS-DOS by their manufacturers, they
probably aren't bootable, and you can use them out of the
box.
Place all of the set_name.xx files on the MS-DOS disks.
Once you have the files on MS-DOS disks, you can proceed
to the next step in the installation or upgrade process.
If you're installing NetBSD from scratch, go to the sec-
tion on preparing your hard disk, below. If you're up-
grading an existing installation, go directly to the sec-
tion on upgrading.
FTP The preparations for this installation/upgrade method are
easy; all you need to do is make sure that there's an FTP
site from which you can retrieve the NetBSD distribution
when you're about to install or upgrade. You need to know
the numeric IP address of that site, and, if it's not on a
network directly connected to the machine on which you're
installing or upgrading NetBSD, you need to know the nu-
meric IP address of the router closest to the NetBSD ma-
chine. Finally, you need to know the numeric IP address
of the NetBSD machine itself. If you don't have access to
a functioning nameserver during installation, the IP ad-
dress of ftp.netbsd.org is 204.152.184.75 (as of April,
2001).
Once you have this information, you can proceed to the
next step in the installation or upgrade process. If
you're installing NetBSD from scratch, go to the section
on preparing your hard disk, below. If you're upgrading
an existing installation, go directly to the section on
upgrading.
Note: This method of installation is recommended only for
those already familiar with using BSD network con-
figuration and management commands. If you aren't,
this documentation should help, but is not intended
to be all-encompassing.
NFS Place the NetBSD distribution sets you wish to install in-
to a directory on an NFS server, and make that directory
mountable by the machine on which you are installing or
upgrading NetBSD. This will probably require modifying
the /etc/exports file on of the NFS server and resetting
its mount daemon (mountd). (Both of these actions will
probably require superuser privileges on the server.)
You need to know the numeric IP address of the NFS server,
and, if the server is not on a network directly connected
to the machine on which you're installing or upgrading
NetBSD, you need to know the numeric IP address of the
router closest to the NetBSD machine. Finally, you need
to know the numeric IP address of the NetBSD machine it-
self.
Once the NFS server is set up properly and you have the
information mentioned above, you can proceed to the next
step in the installation or upgrade process. If you're
installing NetBSD from scratch, go to the section on
preparing your hard disk, below. If you're upgrading an
existing installation, go directly to the section on up-
grading.
Note: This method of installation is recommended only for
those already familiar with using BSD network con-
figuration and management commands. If you aren't,
this documentation should help, but is not intended
to be all-encompassing.
Tape To install NetBSD from a tape, you need to make a tape
that contains the distribution set files, in `tar' format.
If you're making the tape on a UNIX-like system, the easi-
est way to do so is probably something like:
# tar -cf tape_device dist_directories
where tape_device is the name of the tape device that de-
scribes the tape drive you're using; possibly /dev/rst0,
or something similar, but it will vary from system to sys-
tem. (If you can't figure it out, ask your system admin-
istrator.) In the above example, dist_directories are the
distribution sets' directories, for the distribution sets
you wish to place on the tape. For instance, to put the
misc, base, and etc distributions on tape (in order to do
the absolute minimum installation to a new disk), you
would do the following:
# cd .../NetBSD-1.5ZC
# cd acorn32/binary
# tar -cf tape_device misc etc kern
Note: You still need to fill in tape_device in the
example.
Once you have the files on the tape, you can proceed to
the next step in the installation or upgrade process. If
you're installing NetBSD from scratch, go to the section
on preparing your hard disk, below. If you're upgrading
an existing installation, go directly to the section on
upgrading.
Upgrade If you are upgrading NetBSD, you also have the option of
installing NetBSD by putting the new distribution sets
somewhere in your existing file system, and using them
from there. To do that, you must do the following:
Place the distribution sets you wish to upgrade somewhere
in your current file system tree. Please note that the
/dev on the floppy used for upgrades only knows about wd0,
wd1, sd0, sd1, and sd2. If you have more than two IDE
drives or more than three SCSI drives, you should take
care not to place the sets on the high-numbered drives.
At a bare minimum, you must upgrade the base and kern bi-
nary distributions, and so must put the base and kern sets
somewhere in your file system. If you wish, you can do
the other sets, as well, but you should not upgrade the
etc distribution; it contains contains system configura-
tion files that you should review and update by hand.
Once you have done this, you can proceed to the next step
in the upgrade process, actually upgrading your system.
Preparing your System for NetBSD installation
First and foremost, before beginning the installation process, make sure
you have a reliable backup of any data on your hard disk that you wish to
keep. Repartitioning your hard disk is an excellent way to destroy impor-
tant data.
Second, read and perform the instructions in acorn32/platform/prep that
are specific to your platform for partitioning and booting (even if
you're dedicating a device to NetBSD).
Finally, when you are happy with your NetBSD installation, do whatever is
necessary to restore order to the partition you took space away from.
This will most likely involve restoring files, but might involve some
other ``house-work''.
Your hard disk is now prepared to have NetBSD installed on it, and you
should proceed with the installation instructions.
Installing the NetBSD System
Installing NetBSD is a relatively complex process, but if you have this
document in hand and are careful to read and remember the information
which is presented to you by the install program, it shouldn't be too
much trouble.
Before you begin, you should know the geometry of your hard disk, i.e.
the sector size (note that sector sizes other than 512 bytes are not cur-
rently supported), the number of sectors per track, the number of tracks
per cylinder (also known as the number of heads), and the number of
cylinders on the disk. The NetBSD kernel will try to discover these pa-
rameters on its own, and if it can it will print them at boot time. If
possible, you should use the parameters it prints. (You might not be
able to because you're sharing your disk with another operating system,
or because your disk is old enough that the kernel can't figure out its
geometry.)
If NetBSD will be sharing the disk with RiscOS or another operating sys-
tem, you should have already completed the section of these notes that
instructed you on how to prepare your hard disk. You should know the size
of the NetBSD area of the disk and its offset from the beginning of the
disk. You will need this information when setting up your NetBSD parti-
tions.
You should now be ready to install NetBSD. It might be handy for you to
have a pencil, some paper, and a calculator handy.
The following is a walk-through of the steps you will take while getting
NetBSD installed on your hard disk. If any question has a default answer,
it will be displayed in brackets (``[]'') after the question. If you wish
to stop the installation, you may press CONTROL-C at any time, but if you
do, you'll have to begin the installation process again from scratch.
Boot your machine using the installation kernel for your platform. (In-
structions for doing this on your platform can be found in the prepara-
tion section of this document.)
If this doesn't work, ensure that you're using the correct kernel for
your hardware.
Depending upon your platform and the method of loading the, it may take a
while to load the kernel.
You will then be presented with the NetBSD kernel boot messages. You will
want to read them, to determine your disk's name and geometry. Its name
will be something like sd0 or wd0 and the geometry will be printed on a
line that begins with its name. As mentioned above, you will need your
disk's geometry when creating NetBSD 's partitions. You will also need to
know the name, to tell the install tools what disk to install on.
While booting, you will probably see several warnings. You should be
warned that no swap space is present, and that init(8) cannot find
/etc/rc. Do not be alarmed, these are completely normal. When you reach
the prompt asking you for a shell name, just press RETURN.
You will be asked if you wish to install or upgrade your system or go to
a shell prompt. Enter install.
You will be presented with a welcome message and a prompt, asking if you
wish to proceed with the installation process. If you wish to proceed,
enter `y' and press RETURN.
You will be asked what type of disk driver you have. The valid options
are listed by the install program, to make sure you get it right.
The install program will then tell you which disks of that type it can
install on, and ask you which it should use. Reply with the name of your
disk. (The first disk of the type you selected, either wd0 for IDE disks,
or sd0 for SCSI disks, is the default.)
You will then be asked to name your disk's disklabel. The default re-
sponse is `mywd' or `mysd' depending on the type of your disk, and for
most purposes it will be OK. If you choose to name it something differ-
ent, make sure the name is a single word and contains no special charac-
ters. You don't need to remember this name.
You will be prompted for your disk's geometry information, i.e. the num-
ber of bytes per sector, cylinders on the disk, tracks per cylinder
(heads), and sectors per track. Enter them when they are requested. If
you make a mistake, press CONTROL-C and when you get to the shell prompt,
restart the install process by running the install command. Once you have
entered this data, the install program will tell you the total size of
your disk, in both sectors, and cylinders. Remember this number; if
you're installing on the whole disk, you'll need it again soon.
When describing your partitions, you will have the option of entering da-
ta about them in units of disk sectors or cylinders. If you choose to en-
ter the information in units of sectors, remember that, for optimal per-
formance, partitions should begin and end on cylinder boundaries. You
will be asked about which units you wish to use, and you should reply
with `c' for cylinders, or `s' for sectors.
You will be asked for the size of the NetBSD portion of the disk. If
you're installing on the whole disk, reply with the size of the disk, as
printed earlier by the install program. If you're using only part of the
disk, reply with the size that you specified in the partition editor.
(Don't forget to enter the size in the units you specified in the last
step!)
If you are not installing on the whole disk, you will be asked for the
offset of the NetBSD partition from the beginning of the disk. Reply with
the appropriate offset (again, in whichever units you specified), as de-
termined by how you set up your disk using the partition editor.
You will be asked to enter the size of your NetBSD root partition (/).
It should be at least 13 MB, but if you are going to be doing develop-
ment, 14-16 MB is a more desirable size. This size should be expressed in
units of sectors or cylinders, depending on which you said you wanted to
use.
Next, you will be asked for the size of your swap partition. You should
probably allocate twice as much swap space as you have real memory. Sys-
tems that will be heavily used should have more swap space allocated, and
systems that will be lightly used can get by with less. If you want the
system to be able to save crash dumps when it panics, you will need at
least as much swap space as you have RAM. Again, this number should be
expressed in units of sectors or cylinders, as appropriate.
The install program will then ask you for information about the rest of
the partitions you want on your disk. For most purposes, you will want
only one more partition, /usr. (Machines used as servers will probably
also want /var as a separate partition. That can be done with these in-
stallation tools, but is not covered here.) The install program will tell
you how much space there is left to be allocated in the NetBSD area of
the disk, and, if you only want one more partition (/usr), you should en-
ter it at the prompt when the installer asks you how large the next par-
tition should be. It will then ask you for the name of the mount point
for that partition. If you're doing a basic installation, that is /usr.
You are now at the point of no return. Nothing has been written to your
disk yet, but if you confirm that you want to install NetBSD, your hard
drive will be modified, and its contents may be scrambled at the whim of
the install program. This is especially likely if you have given the in-
stall program incorrect information. If you are sure you want to proceed,
enter yes at the prompt.
The install program will now label your disk and make the file systems
you specified. The file systems will be initialized to contain NetBSD
bootstrapping binaries and configuration files. It will also create an
/etc/fstab for your system, and mount all of the file systems under /mnt.
(In other words, your / (root) partition will be mounted on /mnt, your
/usr partition on /mnt/usr, and so on.) There should be no errors in this
section of the installation. If there are, restart from the beginning of
the installation process.
You will be placed at a shell prompt ( `#'). The task is to install the
distribution sets. The flow of installation differs depending on your
hardware resources, and on what media the distribution sets reside.
To install from floppy
The first thing you should do is pick a temporary directory where the
distribution files can be stored. To do this, enter the command
Set_tmp_dir, and enter the name of the temporary directory. (Don't forget
that if your disk is still mounted under /mnt; you should probably pick a
directory under /mnt/usr.)
After you have picked a temporary directory, enter the Load_fd command,
to load the distribution sets from your floppies.
You will be asked which floppy drive to use. Enter `0' (zero) if you're
using the first floppy drive, or enter `1' if you're using the second.
You will be prompted to insert a floppy into the drive, to have its con-
tents copied to your hard disk. Do so, and press RETURN to begin copying.
When that is done, read the remainder of the floppies that contain the
distribution sets that you want to install, one by one. When the last is
read, and you are being prompted for another, press CONTROL-C.
Run the Extract command once for each distribution set you wish to in-
stall. For instance, if you wish to install the base distribution set,
followed by the text distribution set, and finally the etc distribution
set, use the commands:
# Extract base
# Extract text
# Extract etc
For each extraction, it will ask you if the extraction should be verbose.
If you reply affirmatively, it will print out the name of each file
that's being extracted.
Note: If you know that you will be running low on disk space when in-
stalling NetBSD, you can load and extract one distribution set at
a time. To do this, load only the floppies which contain the files
for the first distribution set, extract them, and then change to
the temporary directory and remove them with the command rm
set_name.??
Once you are finished extracting all of the sets that you wish to in-
stall, you should proceed to the instructions below (after the last in-
stall medium type-specific instructions), that explain how you should
configure your system.
To install from tape
The first thing you should do is pick a temporary directory where the
distribution files can be stored. To do this, enter the command
Set_tmp_dir, and enter the name of the temporary directory. (Don't forget
that your disk is mounted under /mnt; you should probably pick a directo-
ry under /mnt/usr.) The default is /mnt/usr/distrib.
After you have picked a temporary directory, enter the Load_tape command,
to load the distribution sets from tape.
You will be asked which tape drive to use. The default is rst0, which is
correct if you're using the SCSI tape drive with the lowest SCSI-ID num-
ber. (For the SCSI tape drive with the next lowest SCSI-ID number, you
should use rst1, and so on.)
You will be prompted to press RETURN when you have inserted the tape into
the tape drive. When you do, the contents of the tape will be extracted
into the temporary directory, and the names of the files being extracted
will be printed.
After the tape has been extracted, to go the directory containing the
first distribution set you wish to install. (Depending on how you made
the tape, it's probably a subdirectory of the temporary directory you
specified above.) Once there, run the Set_tmp_dir command again, and ac-
cept its default answer by pressing return at the prompt.
Use the Extract command to extract the distribution set. For instance, if
you're extracting the base set, use the command:
# Extract base
You will be asked if you wish the extraction to be verbose. If you reply
affirmatively, the name of each file being extracted will be printed.
Repeat the previous two steps for each distribution set you wish to in-
stall. Change to the set's directory, run Set_tmp_dir, and then run
Extract set_name to extract the set.
Once you are finished extracting all of the sets that you wish to in-
stall, you should proceed to the instructions below (after the last in-
stall medium type-specific instructions), that explain how you should
configure your system.
To install via FTP or NFS
The first thing you should do is pick a temporary directory where the
distribution files can be stored. To do this, enter the command
Set_tmp_dir, and enter the name of the temporary directory. (Don't forget
that your disk is mounted under /mnt; you should probably pick a directo-
ry under /mnt/usr.) The default is /mnt/usr/distrib.
Configure the appropriate ethernet interface (e.g. ea0, eb0, etc.) up,
with a command like:
ifconfig ifname ipaddr [netmask netmask]
where ifname is the interface name, like those listed above, and ipaddr
is the numeric IP address of the interface. If the interface has a spe-
cial netmask, supply the word netmask and that netmask at the end of the
command line. (The brackets indicate that those arguments are optional.)
For instance, to configure interface ea0 with IP address 129.133.10.10,
use the command:
# ifconfig ea0 129.133.10.10
and to configure interface eb0 with IP address 128.32.240.167 and a spe-
cial netmask, 0xffffff00, use the command:
# ifconfig eb0 128.32.240.167 netmask 0xffffff00
If the NFS server or FTP server is not on a directly- connected network,
you need to set up a route to it using a command like:
route add default gate_ipaddr
where gate_ipaddr is your gateway's numeric IP address.
If you are NFS-mounting the distribution sets, mount them on the tempo-
rary directory with a command like:
mount -t nfs serv_ipaddr:dist_dir tmp_dir
where serv_ipaddr is the server's numeric IP address, dist_dir is the
path to the distribution files on the server, and tmp_dir is the name of
the local temporary directory.
Once this is done, proceed as if you had loaded the files from tape,
changing to the appropriate directories, running Set_tmp_dir, and running
Extract as appropriate.
If you are retrieving the distribution sets using ftp, change into the
temporary directory, and execute the command:
ftp serv_ipaddr
where serv_ipaddr is once again the server's numeric IP address. Get the
files with FTP, taking care to use binary mode when transferring the
files.
Once you have all of the files for the distribution sets that you wish to
install, you can proceed using the instructions above, as if you had in-
stalled from a floppy. (Note that as with the floppy install, if you're
short on disk space, you can transfer only one set at a time, extract it,
then delete it, to save space.)
To install from CD-ROM
First create a mount point so that you can mount the CD-ROM:
# mkdir /mnt/cdrom
If you get an error here of ``mkdir: /mnt/cdrom'', don't worry it just
means that you didn't need to create the directory.
Then all you need to do is mount the CD-ROM. For the first CD-ROM drive
use:
# mount -rt cd9660 /dev/cd0a /mnt/cdrom
Or, for the second use:
# mount -rt cd9660 /dev/cd1a /mnt/cdrom
Once this is done, extract the required sets as described in the To
install from floppy section, but ensure that you set the temporary direc-
tory to the location of the sets on the CD-ROM (usually /cdrom/distrib,
but check the release notes that came with the CD).
Completing your installation
Once you have finished extracting all of the distribution sets that you
wish to install, and are back at the `#' prompt, you are ready to config-
ure your system. The configuration utility expects that you have in-
stalled the base and etc distribution sets. If you have not, you will not
be able to run it successfully (nor will you have a functional system, in
any case). To configure your newly-installed NetBSD system, run the com-
mand Configure. It will ask you for the system's host name, domain name,
and other network configuration information. It will set up your configu-
ration files and make the device nodes for the newly-installed system.
Congratulations, you have successfully installed NetBSD 1.5ZC.
Post installation steps
Once you've got the operating system running, there are a few things you
need to do in order to bring the system into a properly configured state,
with the most important ones described below.
1. Configuring /etc/rc.conf
If you or the installation software haven't done any configuration
of /etc/rc.conf (sysinst usually will), the system will drop you in-
to single user mode on first reboot with the message
/etc/rc.conf is not configured. Multiuser boot aborted.
and with the root file system (/) mounted read-write. When the sys-
tem asks you to choose a shell, simply press RETURN to get to a
/bin/sh prompt. If you are asked for a terminal type, respond with
vt220 (or whatever is appropriate for your terminal type) and press
RETURN. You may need to type one of the following commands to get
your delete key to work properly, depending on your keyboard:
# stty erase '^h'
# stty erase '^?'
At this point, you need to configure at least one file in the /etc
directory. You will need to mount your root filesystem read/write
with:
# /sbin/mount -u -w /
Change to the /etc directory and take a look at the /etc/rc.conf
file. Modify it to your tastes, making sure that you set
rc_configured=YES so that your changes will be enabled and a multi-
user boot can proceed. Default values for the various programs can
be found in /etc/defaults/rc.conf, where some in-line documentation
may be found. More complete documentation can be found in
rc.conf(5).
If your /usr directory is on a separate partition and you do not
know how to use ed, you will have to mount your /usr partition to
gain access to ex or vi. Do the following:
# mount /usr
# export TERM=vt220
If you have /var on a separate partition, you need to repeat that
step for it. After that, you can edit /etc/rc.conf with vi(1). When
you have finished, type exit at the prompt to leave the single-user
shell and continue with the multi-user boot.
Other values that need to be set in /etc/rc.conf for a networked en-
vironment are hostname and possibly defaultroute, furthermore add an
ifconfig_int for your <int> network interface, along the lines of
ifconfig_de0="inet 123.45.67.89 netmask 255.255.255.0"
or, if you have myname.my.dom in /etc/hosts:
ifconfig_de0="inet myname.my.dom netmask 255.255.255.0"
To enable proper hostname resolution, you will also want to add an
/etc/resolv.conf file or (if you are feeling a little more adventur-
ous) run named(8). See resolv.conf(5) or named(8) for more informa-
tion.
Other files in /etc that may require modification or setting up in-
clude /etc/mailer.conf, /etc/nsswitch.conf, and /etc/wscons.conf.
2. Logging in
After reboot, you can log in as root at the login prompt. Unless
you've set a password in sysinst, there is no initial password. If
you're using the machine in a networked environment, you should cre-
ate an account for yourself (see below) and protect it and the
``root'' account with good passwords. Unless you have connected an
unusual terminal device as the console you can just press RETURN
when it prompts for Terminal type? [...].
3. Adding accounts
Use the useradd(8) command to add accounts to your system, do not
edit /etc/passwd directly. See useradd(8) for more information on
how to add a new user to the system.
4. The X Window System
If you have installed the X Window System, look at the files in
/usr/X11R6/lib/X11/doc for information.
Don't forget to add /usr/X11R6/bin to your path in your shell's dot
file so that you have access to the X binaries.
5. Installing third party packages
If you wish to install any of the software freely available for
UNIX-like systems you are strongly advised to first check the NetBSD
package system. This automatically handles any changes necessary to
make the software run on NetBSD, retrieval and installation of any
other packages on which the software may depend, and simplifies in-
stallation (and deinstallation), both from source and precompiled
binaries.
o More information on the package system is at
http://www.netbsd.org/Documentation/software/packages.html
o A browsable listing of available packages is at
ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/README.html
o Precompiled binaries can be found at
ftp://ftp.netbsd.org/pub/NetBSD/packages,
usually in the 1.5ZC/acorn32/All subdir. You can install them
with the following commands:
# PKG_PATH=
ftp://ftp.netbsd.org/pub/NetBSD/packages/1.5ZC/acorn32/All
# export PKG_PATH
# pkg_add -v tcsh
# pkg_add -v apache
# pkg_add -v perl
...
The above commands will install the tcsh shell, the Apache web
server and the perl programming language as well as all the
packages they depend on.
o Package sources for compiling packages on your own can be ob-
tained by retrieving the file
ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-
current/tar_files/pkgsrc.tar.gz
They are typically extracted into /usr/pkgsrc (though other lo-
cations work fine), with the commands:
# mkdir /usr/pkgsrc
# ( cd /usr/pkgsrc ; tar -zxpf - ) < pkgsrc.tar.gz
After extracting, then see the README file in the extraction di-
rectory (e.g. /usr/pkgsrc/README) for more information.
6. Misc
o Edit /etc/mail/aliases to forward root mail to the right place.
Don't forget to run newaliases(1) afterwards.
o The /etc/mail/sendmail.cf file will almost definitely need to be
adjusted; files aiding in this can be found in
/usr/share/sendmail. See the README file there for more infor-
mation.
o Edit /etc/rc.local to run any local daemons you use.
o Many of the /etc files are documented in section 5 of the manu-
al; so just invoking
# man 5 filename
is likely to give you more information on these files.
Upgrading a previously-installed NetBSD System
The upgrade to NetBSD 1.5ZC is a binary upgrade; it can be quite diffi-
cult to advance to a later version by recompiling from source due primar-
ily to interdependencies in the various components.
To do the upgrade, you must have the boot floppy available. You must al-
so have at least the base and kern binary distribution sets available, so
that you can upgrade with them, using one of the upgrade methods de-
scribed above. Finally, you must have sufficient disk space available to
install the new binaries. Since the old binaries are being overwritten
in place, you only need space for the new binaries, which weren't previ-
ously on the system. If you have a few megabytes free on each of your
root (/) and /usr partitions, you should have enough space.
Since upgrading involves replacing the boot blocks on your NetBSD parti-
tion, the kernel, and most of the system binaries, it has the potential
to cause data loss. You are strongly advised to back up any important
data on your disk, whether on the NetBSD partition or on another operat-
ing system's partition, before beginning the upgrade process.
The upgrade procedure using the sysinst tool is similar to an installa-
tion, but without the hard disk partitioning. The original /etc directo-
ry is renamed to /etc.old, and no attempt is made to merge any of the
previous configuration into the new system except that the previous
/etc/fstab file is copied into the new configuration. Getting the binary
sets is done in the same manner as the installation procedure; refer to
the installation part of the document for how to do this. Also, some san-
ity checks are done, i.e. file systems are checked before unpacking the
sets.
After a new kernel has been copied to your hard disk, your machine is a
complete NetBSD 1.5ZC system. However, that doesn't mean that you're fin-
ished with the upgrade process. You will probably want to update the set
of device nodes you have in /dev. If you've changed the contents of /dev
by hand, you will need to be careful about this, but if not, you can just
cd into /dev, and run the command:
# sh MAKEDEV all
You must also deal with certain changes in the formats of some of the
configuration files. The most notable change is that the options given to
many of the file systems in /etc/fstab have changed, and some of the file
systems have changed names. To find out what the new options are, it's
suggested that you read the manual page for the file system's mount com-
mands, for example mount_nfs(8) for NFS.
Finally, you will want to delete old binaries that were part of the ver-
sion of NetBSD that you upgraded from and have since been removed from
the NetBSD distribution.
Compatibility Issues With Previous NetBSD Releases
Users upgrading from previous versions of NetBSD may wish to bear the
following problems and compatibility issues in mind when upgrading to
NetBSD 1.5ZC.
General issues
o /etc/rc modified to use /etc/rc.d/*
Prior to NetBSD 1.5, /etc/rc was a traditional BSD style monolithic
file; each discrete program or substem from /etc/rc and /etc/netstart
has been moved into separate scripts in /etc/rc.d/.
At system startup, /etc/rc uses rcorder(8) to build a dependency list
of the files in /etc/rc.d and then executes each script in turn with
an argument of `start'. Many rc.d scripts won't start unless the ap-
propriate rc.conf(5) entry in /etc/rc.conf is set to `YES.'
At system shutdown, /etc/rc.shutdown uses rcorder(8) to build a de-
pendency list of the files in /etc/rc.d that have a ``KEYWORD:
shutdown'' line, reverses the resulting list, and then executes each
script in turn with an argument of `stop'. The following scripts
support a specific shutdown method: cron, inetd, local, and xdm.
Local and third-party scripts may be installed into /etc/rc.d as nec-
essary. Refer to the other scripts in that directory and rc(8) for
more information on implementing rc.d scripts.
Issues affecting an upgrade from NetBSD 1.4 or prior
o named(8) leaks version information
Previous releases of NetBSD disabled a feature of named(8) where the
version number of the server could be determined by remote clients.
This feature has not been disabled in NetBSD 1.5, because there is a
named.conf(5) option to change the version string:
option {
version "newstring";
};
o sysctl(8) pathname changed
sysctl(8) is moved from /usr/sbin/sysctl to /sbin/sysctl. If you
have hardcoded references to the full pathname (in shell scripts, for
example) please be sure to update those.
o sendmail(8) configuration file pathname changed
Due to sendmail(8) upgrade from 8.9.x to 8.10.x, /etc/sendmail.cf is
moved to /etc/mail/sendmail.cf. Also, the default sendmail.cf(5)
refers different pathnames than before. For example, /etc/aliases is
now located at /etc/mail/aliases, /etc/sendmail.cw is now called
/etc/mail/local-host-names, and so forth. If you have customized
sendmail.cf(5) and friends, you will need to move the files to the
new locations. See /usr/share/sendmail/README for more information.
o sshd(8) configuration file pathname changed
Configuration files for ssh(1) and sshd(8) are moved from /etc to
/etc/ssh.
Using online NetBSD documentation
Documentation is available if you first install the manual distribution
set. Traditionally, the ``man pages'' (documentation) are denoted by
`name(section)'. Some examples of this are
o intro(1),
o man(1),
o apropros(1),
o passwd(1), and
o passwd(5).
The section numbers group the topics into several categories, but three
are of primary interest: user commands are in section 1, file formats are
in section 5, and administrative information is in section 8.
The man command is used to view the documentation on a topic, and is
started by entering man [section] topic. The brackets [] around the sec-
tion should not be entered, but rather indicate that the section is op-
tional. If you don't ask for a particular section, the topic with the
lowest numbered section name will be displayed. For instance, after log-
ging in, enter
# man passwd
to read the documentation for passwd(1). To view the documentation for
passwd(5), enter
# man 5 passwd
instead.
If you are unsure of what man page you are looking for, enter apropos
subject-word
where subject-word is your topic of interest; a list of possibly related
man pages will be displayed.
Administrivia
If you've got something to say, do so! We'd like your input. There are
various mailing lists available via the mailing list server at
[email protected]. To get help on using the mailing list server, send
mail to that address with an empty body, and it will reply with instruc-
tions.
There are various mailing lists set up to deal with comments and ques-
tions about this release. Please send comments to: netbsd-
[email protected].
To report bugs, use the send-pr(1) command shipped with NetBSD, and fill
in as much information about the problem as you can. Good bug reports in-
clude lots of details. Additionally, bug reports can be sent by mail to:
[email protected].
Use of send-pr(1) is encouraged, however, because bugs reported with it
are entered into the NetBSD bugs database, and thus can't slip through
the cracks.
There are also port-specific mailing lists, to discuss aspects of each
port of NetBSD. Use majordomo to find their addresses, or visit
http://www.netbsd.org/MailingLists/.
If you're interested in doing a serious amount of work on a specific
port, you probably should contact the `owner' of that port (listed be-
low).
If you'd like to help with this effort, and have an idea as to how you
could be useful, send us mail or subscribe to:
[email protected].
As a favor, please avoid mailing huge documents or files to these mailing
lists. Instead, put the material you would have sent up for FTP or WWW
somewhere, then mail the appropriate list about it, or, if you'd rather
not do that, mail the list saying you'll send the data to those who want
it.
Thanks go to
o The former members of UCB's Computer Systems Research Group, includ-
ing (but not limited to):
Keith Bostic
Ralph Campbell
Mike Karels
Marshall Kirk McKusick
for their ongoing work on BSD systems, support, and encouragement.
o Also, our thanks go to:
Mike Hibler
Rick Macklem
Jan-Simon Pendry
Chris Torek
for answering lots of questions, fixing bugs, and doing the various
work they've done.
o UC Berkeley's Experimental Computing Facility provided a home for
sun-lamp in the past, people to look after it, and a sense of humor.
Rob Robertson, too, has added his unique sense of humor to things,
and for a long time provided the primary FTP site for NetBSD.
o Vixie Enterprises for hosting the NetBSD FTP, SUP, and WWW servers.
o Redback Networks, Inc. for hosting the NetBSD mail and GNATS server.
o The Helsinki University of Technology in Finland for hosting the
NetBSD CVS server.
o The Internet Research Institute in Japan for hosting the server which
runs the CVSweb interface to the NetBSD source tree.
o The many organisations that provide NetBSD mirror sites.
o Without CVS, this project would be impossible to manage, so our hats
go off to Brian Berliner, Jeff Polk, and the various other people
who've had a hand in making CVS a useful tool.
o Dave Burgess
[email protected] has been maintaining the
386BSD/NetBSD/FreeBSD FAQ for quite some time, and deserves to be
recognized for it.
o The following individuals and organizations (each in alphabetical or-
der) have made donations or loans of hardware and/or money, to sup-
port NetBSD development, and deserve credit for it:
Steve Allen
Jason Birnschein
Mason Loring Bliss
Jason Brazile
Mark Brinicombe
David Brownlee
Simon Burge
Dave Burgess
Ralph Campbell
Brian Carlstrom
James Chacon
Bill Coldwell
Charles Conn
Tom Coulter
Charles D. Cranor
Christopher G. Demetriou
Scott Ellis
Hubert Feyrer
Castor Fu
Greg Gingerich
William Gnadt
Michael Graff
Guenther Grau
Ross Harvey
Charles M. Hannum
Michael L. Hitch
Kenneth Alan Hornstein
Jordan K. Hubbard
Soren Jorvang
Scott Kaplan
Noah M. Keiserman
Harald Koerfgen
John Kohl
Chris Legrow
Ted Lemon
Norman R. McBride
Neil J. McRae
Perry E. Metzger
Toru Nishimura
Herb Peyerl
Mike Price
Dave Rand
Michael Richardson
Heiko W. Rupp
Brad Salai
Chuck Silvers
Thor Lancelot Simon
Bill Sommerfeld
Paul Southworth
Eric and Rosemary Spahr
Ted Spradley
Kimmo Suominen
Jason R. Thorpe
Steve Wadlow
Krister Walfridsson
Jim Wise
Reinoud Zandijk
Christos Zoulas
AboveNet Communications, Inc.
Advanced System Products, Inc.
Avalon Computer Systems
Bay Area Internet Solutions
Brains Corporation, Japan
Canada Connect Corporation
Co-operative Research Centre for Enterprise Distributed Systems Technology
Demon Internet, UK
Digital Equipment Corporation
Distributed Processing Technology
Easynet, UK
Free Hardware Foundation
Innovation Development Enterprises of America
Internet Software Consortium
MS Macro System GmbH, Germany
Numerical Aerospace Simulation Facility, NASA Ames Research Center
Piermont Information Systems Inc.
Precedence Technologies Ltd
Salient Systems Inc.
VMC Harald Frank, Germany
Warped Communications, Inc.
Whitecross Database Systems Ltd.
(If you're not on that list and should be, tell us! We probably were
not able to get in touch with you, to verify that you wanted to be
listed.)
o Finally, we thank all of the people who've put sweat and tears into
developing NetBSD since its inception in January, 1993. (Obviously,
there are a lot more people who deserve thanks here. If you're one of
them, and would like to mentioned, tell us!)
We are...
(in alphabetical order)
The NetBSD core group:
Alistair Crooks
[email protected]
Jun-ichiro itojun Hagino
[email protected]
Frank van der Linden
[email protected]
Luke Mewburn
[email protected]
Christos Zoulas
[email protected]
The portmasters (and their ports):
Mark Brinicombe
[email protected] arm32
Simon Burge
[email protected] pmax
Simon Burge
[email protected] sbmips
Jeremy Cooper
[email protected] sun3x
Matt Fredette
[email protected] sun2
Chris Gilbert
[email protected] cats
Ross Harvey
[email protected] alpha
Jun-ichiro itojun Hagino
[email protected] sh3
Ben Harris
[email protected] acorn26
Eduardo Horvath
[email protected] sparc64
Darrin Jewell
[email protected] next68k
Soren Jorvang
[email protected] cobalt
Soren Jorvang
[email protected] sgimips
Wayne Knowles
[email protected] mipsco
Paul Kranenburg
[email protected] sparc
Anders Magnusson
[email protected] vax
Minoura Makoto
[email protected] x68k
Phil Nelson
[email protected] pc532
Tohru Nishimura
[email protected] luna68k
NONAKA Kimihiro
[email protected] prep
Scott Reynolds
[email protected] mac68k
Kazuki Sakamoto
[email protected] bebox
Noriyuki Soda
[email protected] arc
Wolfgang Solfrank
[email protected] ofppc
Ignatios Souvatzis
[email protected] amiga
Jonathan Stone
[email protected] pmax
Shin Takemura
[email protected] hpcmips
Jason Thorpe
[email protected] alpha
Jason Thorpe
[email protected] hp300
Tsubai Masanari
[email protected] macppc
Tsubai Masanari
[email protected] newsmips
Izumi Tsutsui
[email protected] news68k
Frank van der Linden
[email protected] i386
Leo Weppelman
[email protected] atari
Nathan Williams
[email protected] sun3
Steve Woodford
[email protected] mvme68k
Steve Woodford
[email protected] mvmeppc
Reinoud Zandijk
[email protected] acorn32
The NetBSD 1.5ZC Release Engineering team:
Chris G. Demetriou
[email protected]
Havard Eidnes
[email protected]
Ted Lemon
[email protected]
Perry Metzger
[email protected]
Curt Sampson
[email protected]
Jason Thorpe
[email protected]
Todd Vierling
[email protected]
Developers and other contributors:
Nathan Ahlstrom
[email protected]
Steve Allen
[email protected]
Julian Assange
[email protected]
Lennart Augustsson
[email protected]
Christoph Badura
[email protected]
Bang Jun-Young
[email protected]
Dieter Baron
[email protected]
Robert V. Baron
[email protected]
Jason Beegan
[email protected]
Erik Berls
[email protected]
John Birrell
[email protected]
Mason Loring Bliss
[email protected]
Rafal Boni
[email protected]
Manuel Bouyer
[email protected]
John Brezak
[email protected]
Allen Briggs
[email protected]
Aaron Brown
[email protected]
Andrew Brown
[email protected]
David Brownlee
[email protected]
Frederick Bruckman
[email protected]
Jon Buller
[email protected]
Dave Burgess
[email protected]
Robert Byrnes
[email protected]
D'Arcy J.M. Cain
[email protected]
Dave Carrel
[email protected]
James Chacon
[email protected]
Bill Coldwell
[email protected]
Julian Coleman
[email protected]
Chuck Cranor
[email protected]
Aidan Cully
[email protected]
Johan Danielsson
[email protected]
Matt DeBergalis
[email protected]
Rob Deker
[email protected]
Chris G. Demetriou
[email protected]
Tracy Di Marco White
[email protected]
Jaromir Dolecek
[email protected]
Andy Doran
[email protected]
Roland Dowdeswell
[email protected]
Emmanuel Dreyfus
[email protected]
Matthias Drochner
[email protected]
Jun Ebihara
[email protected]
Havard Eidnes
[email protected]
Stoned Elipot
[email protected]
Enami Tsugutomo
[email protected]
Bernd Ernesti
[email protected]
Erik Fair
[email protected]
Gavan Fantom
[email protected]
Hubert Feyrer
[email protected]
Jason R. Fink
[email protected]
Thorsten Frueauf
[email protected]
Castor Fu
[email protected]
Ichiro Fukuhara
[email protected]
Brian R. Gaeke
[email protected]
Thomas Gerner
[email protected]
Simon J. Gerraty
[email protected]
Justin Gibbs
[email protected]
Adam Glass
[email protected]
Michael Graff
[email protected]
Brad Grantham
[email protected]
Brian C. Grayson
[email protected]
Matthew Green
[email protected]
Juergen Hannken-Illjes
[email protected]
Charles M. Hannum
[email protected]
Eric Haszlakiewicz
[email protected]
John Hawkinson
[email protected]
HAYAKAWA Koichi
[email protected]
Rene Hexel
[email protected]
Michael L. Hitch
[email protected]
Christian E. Hopps
[email protected]
Ken Hornstein
[email protected]
Marc Horowitz
[email protected]
Nick Hudson
[email protected]
Martin Husemann
[email protected]
Dean Huxley
[email protected]
Bernardo Innocenti
[email protected]
Tetsuya Isaki
[email protected]
ITOH Yasufumi
[email protected]
IWAMOTO Toshihiro
[email protected]
Matthew Jacob
[email protected]
Lonhyn T. Jasinskyj
[email protected]
Chris Jones
[email protected]
Takahiro Kambe
[email protected]
Antti Kantee
[email protected]
Masanori Kanaoka
[email protected]
KAWAMOTO Yosihisa
[email protected]
Mario Kemper
[email protected]
Lawrence Kesteloot
[email protected]
Thomas Klausner
[email protected]
Klaus Klein
[email protected]
Wayne Knowles
[email protected]
John Kohl
[email protected]
Martti Kuparinen
[email protected]
Kevin Lahey
[email protected]
Johnny C. Lam
[email protected]
Martin J. Laubach
[email protected]
Ted Lemon
[email protected]
Joel Lindholm
[email protected]
Mike Long
[email protected]
Warner Losh
[email protected]
Tomasz Luchowski
[email protected]
Federico Lupi
[email protected]
Brett Lymn
[email protected]
Paul Mackerras
[email protected]
MAEKAWA Masahide
[email protected]
David Maxwell
[email protected]
Dan McMahill
[email protected]
Gregory McGarry
[email protected]
Jared D. McNeill
[email protected]
Neil J. McRae
[email protected]
Perry Metzger
[email protected]
der Mouse
[email protected]
Joseph Myers
[email protected]
Ken Nakata
[email protected]
Bob Nestor
[email protected]
NISHIMURA Takeshi
[email protected]
NONAKA Kimihiro
[email protected]
Jesse Off
[email protected]
Tatoku Ogaito
[email protected]
Masaru Oki
[email protected]
Atsushi Onoe
[email protected]
Greg Oster
[email protected]
Herb Peyerl
[email protected]
Matthias Pfaller
[email protected]
Chris Pinnock
[email protected]
Dante Profeta
[email protected]
Chris Provenzano
[email protected]
Michael Rauch
[email protected]
Waldi Ravens
[email protected]
Darren Reed
[email protected]
Michael Richardson
[email protected]
Tim Rightnour
[email protected]
Gordon Ross
[email protected]
Heiko W. Rupp
[email protected]
David Sainty
[email protected]
SAITOH Masanobu
[email protected]
Curt Sampson
[email protected]
Wilfredo Sanchez
[email protected]
Ty Sarna
[email protected]
SATO Kazumi
[email protected]
Matthias Scheler
[email protected]
Karl Schilke (rAT)
[email protected]
Konrad Schroder
[email protected]
Reed Shadgett
[email protected]
Tim Shepard
[email protected]
Takeshi Shibagaki
[email protected]
Takao Shinohara
[email protected]
Takuya SHIOZAKI
[email protected]
Chuck Silvers
[email protected]
Thor Lancelot Simon
[email protected]
Jeff Smith
[email protected]
SOMEYA Yoshihiko
[email protected]
Bill Sommerfeld
[email protected]
Bill Squier
[email protected]
Bill Studenmund
[email protected]
Kevin Sullivan
[email protected]
SUNAGAWA Keiki
[email protected]
Kimmo Suominen
[email protected]
TAMURA Kent
[email protected]
Shin'ichiro TAYA
[email protected]
Matt Thomas
[email protected]
Christoph Toshok
[email protected]
UCHIYAMA Yasushi
[email protected]
Masao Uebayashi
[email protected]
Shuichiro URATA
[email protected]
Todd Vierling
[email protected]
Aymeric Vincent
[email protected]
Paul Vixie
[email protected]
Krister Walfridsson
[email protected]
Lex Wennmacher
[email protected]
Assar Westerlund
[email protected]
Todd Whitesel
[email protected]
Rob Windsor
[email protected]
Dan Winship
[email protected]
Jim Wise
[email protected]
Michael Wolfson
[email protected]
Colin Wood
[email protected]
YAMAMOTO Takashi
[email protected]
Yuji Yamano
[email protected]
Maria Zevenhoven
[email protected]
Legal Mumbo-Jumbo
All product names mentioned herein are trademarks or registered trade-
marks of their respective owners.
The following notices are required to satisfy the license terms of the
software that we have mentioned in this document:
This product includes software developed by the University of California,
Berkeley and its contributors. This product includes software developed
by The NetBSD Foundation, Inc. This product includes software developed
by the NetBSD Foundation, Inc. and its contributors. This product in-
cludes software developed by the Computer Systems Engineering Group at
Lawrence Berkeley Laboratory. This product includes software developed
by Adam Glass and Charles Hannum. This product includes software devel-
oped by Adam Glass and Charles M. Hannum. This product includes software
developed by Adam Glass. This product includes software developed by Al-
istair G. Crooks. This product includes software developed by Amancio
Hasty and Roger Hardiman. This product includes software developed by
Berkeley Software Design, Inc. This product includes software developed
by Bill Paul. This product includes software developed by Charles D.
Cranor and Washington University. This product includes software devel-
oped by Charles D. Cranor. This product includes software developed by
Charles Hannum, by the University of Vermont and State Agricultural Col-
lege and Garrett A. Wollman, by William F. Jolitz, and by the University
of California, Berkeley, Lawrence Berkeley Laboratory, and its contribu-
tors. This product includes software developed by Charles Hannum. This
product includes software developed by Charles M. Hannum. This product
includes software developed by Chris Provenzano. This product includes
software developed by Christian E. Hopps. This product includes software
developed by Christopher G. Demetriou for the NetBSD Project. This prod-
uct includes software developed by Christopher G. Demetriou. This prod-
uct includes software developed by Christos Zoulas. This product in-
cludes software developed by David Jones and Gordon Ross. This product
includes software developed by Dean Huxley. This product includes soft-
ware developed by Eric S. Hvozda. This product includes software devel-
oped by Ezra Story. This product includes software developed by Gardner
Buchanan. This product includes software developed by Gordon Ross. This
product includes software developed by Gordon W. Ross and Leo Weppelman.
This product includes software developed by Gordon W. Ross. This product
includes software developed by Hauke Fath. This product includes soft-
ware developed by HAYAKAWA Koichi. This product includes software devel-
oped by Hellmuth Michaelis and Joerg Wunsch. This product includes soft-
ware developed by Herb Peyerl. This product includes software developed
by Holger Veit and Brian Moore for use with "386BSD" and similar operat-
ing systems. This product includes software developed by Hubert Feyrer
for the NetBSD Project. This product includes software developed by Iain
Hibbert. This product includes software developed by Ian W. Dall. This
product includes software developed by Ignatios Souvatzis for the NetBSD
Project. This product includes software developed by Jason R. Thorpe for
And Communications,
http://www.and.com/. This product includes software
developed by Joachim Koenig-Baltes. This product includes software de-
veloped by Jochen Pohl for The NetBSD Project. This product includes
software developed by John Polstra. This product includes software de-
veloped by Jonathan Stone and Jason R. Thorpe for the NetBSD Project.
This product includes software developed by Jonathan Stone for the NetBSD
Project. This product includes software developed by Jonathan Stone.
This product includes software developed by Julian Highfield. This prod-
uct includes software developed by Kenneth Stailey. This product in-
cludes software developed by Leo Weppelman. This product includes soft-
ware developed by Lloyd Parkes. This product includes software developed
by Manuel Bouyer. This product includes software developed by Marc
Horowitz. This product includes software developed by Mark Brinicombe
for the NetBSD Project. This product includes software developed by Mark
Brinicombe. This product includes software developed by Mark Tinguely
and Jim Lowe. This product includes software developed by Markus Wild.
This product includes software developed by Martin Husemann and Wolfgang
Solfrank. This product includes software developed by Mats O Jansson and
Charles D. Cranor. This product includes software developed by Mats O
Jansson. This product includes software developed by Matthias Pfaller.
This product includes software developed by Michael L. Hitch. This prod-
uct includes software developed by Niels Provos. This product includes
software developed by Paul Kranenburg. This product includes software
developed by Paul Mackerras. This product includes software developed by
Peter Galbavy. This product includes software developed by Philip A.
Nelson. This product includes software developed by Rodney W. Grimes.
This product includes software developed by Roland C. Dowdeswell. This
product includes software developed by Rolf Grossmann. This product in-
cludes software developed by Scott Bartram. This product includes soft-
ware developed by SigmaSoft, Th. Lockert. This product includes software
developed by Tatoku Ogaito for the NetBSD Project. This product includes
software developed by Terrence R. Lambert. This product includes soft-
ware developed by Theo de Raadt and John Brezak. This product includes
software developed by Theo de Raadt. This product includes software de-
veloped by Tohru Nishimura for the NetBSD Project. This product includes
software developed by TooLs GmbH. This product includes software de-
signed by William Allen Simpson. This product includes software devel-
oped by Winning Strategies, Inc. This product includes software devel-
oped by Zembu Labs, Inc. This product includes software developed by the
Center for Software Science at the University of Utah. This product in-
cludes software developed by the Computer Systems Laboratory at the Uni-
versity of Utah. This product includes software developed by the Univer-
sity of Calgary Department of Computer Science and its contributors.
This product includes software developed by the University of Vermont and
State Agricultural College and Garrett A. Wollman. This product includes
software developed for the FreeBSD project. This product includes soft-
ware developed for the Internet Software Consortium by Ted Lemon. This
product includes software developed for the NetBSD Project by Frank van
der Linden. This product includes software developed for the NetBSD Pro-
ject by Jason R. Thorpe. This product includes software developed for
the NetBSD Project by John M. Vinopal. This product includes software
developed for the NetBSD Project by Matthias Drochner. This product in-
cludes software developed for the NetBSD Project by Matthieu Herrb. This
product includes software developed for the NetBSD Project by Perry E.
Metzger. This product includes software developed for the NetBSD Project
by Piermont Information Systems Inc. This product includes software de-
veloped for the NetBSD Project by Ted Lemon. This product includes soft-
ware developed for the NetBSD Project by Wasabi Systems, Inc. This prod-
uct includes software developed by LAN Media Corporation and its contrib-
utors. This product includes software developed by Michael Graff for the
NetBSD Project. This product includes software developed by Niklas Hal-
lqvist, C Stone and Job de Haas. This product includes software devel-
oped by Eric Young (
[email protected]). This product includes software
developed by the OpenSSL Project for use in the OpenSSL Toolkit
(
http://www.openssl.org/). This product includes software developed by
the University of Oregon. This product includes software developed by
the University of Southern California and/or Information Sciences Insti-
tute. This product includes software developed by Internet Initiative
Japan Inc. This product includes software developed by Reinoud Zandijk.
This product includes software developed at the Information Technology
Division, US Naval Research Laboratory.
This product includes software developed by Advanced Risc Machines Ltd.
This product includes software developed by Neil Carson.
This product includes software developed by the RiscBSD kernel team.
This product includes software developed by Scott Stevens.
The End
NetBSD May 21, 2001 32