984 lines
30 KiB
Plaintext
984 lines
30 KiB
Plaintext
|
.\" $NetBSD: main,v 1.1 1999/01/13 08:18:45 ross Exp $
|
||
|
.\"
|
||
|
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
|
||
|
.\" All rights reserved.
|
||
|
.\"
|
||
|
.\" Redistribution and use in source and binary forms, with or without
|
||
|
.\" modification, are permitted provided that the following conditions
|
||
|
.\" are met:
|
||
|
.\" 1. Redistributions of source code must retain the above copyright
|
||
|
.\" notice, this list of conditions and the following disclaimer.
|
||
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||
|
.\" notice, this list of conditions and the following disclaimer in the
|
||
|
.\" documentation and/or other materials provided with the distribution.
|
||
|
.\" 3. All advertising materials mentioning features or use of this software
|
||
|
.\" must display the following acknowledgement:
|
||
|
.\" This product includes software developed by the NetBSD
|
||
|
.\" Foundation, Inc. and its contributors.
|
||
|
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
|
||
|
.\" contributors may be used to endorse or promote products derived
|
||
|
.\" from this software without specific prior written permission.
|
||
|
.\"
|
||
|
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
|
||
|
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
|
||
|
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||
|
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
|
||
|
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||
|
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||
|
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||
|
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||
|
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||
|
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||
|
.\" POSSIBILITY OF SUCH DAMAGE.
|
||
|
.\"
|
||
|
.ig
|
||
|
|
||
|
The notes that describe the improvements over the last release
|
||
|
aren't appropriate for a snapshot, so these are conditional on
|
||
|
FOR_RELEASE. 0 == snapshot; 1 == release
|
||
|
..
|
||
|
.
|
||
|
.tm Processing INSTALL
|
||
|
.
|
||
|
.\" -------------------- CONFIGURATION --------------------
|
||
|
.
|
||
|
.nr FOR_RELEASE 0
|
||
|
.ds MACHINE_LIST alpha amiga arm32 atari hp300 i386 mac68k mvme68k
|
||
|
.as MACHINE_LIST " pc532 pmax sparc sun3 sun3x vax x68k
|
||
|
.so ../common/macros
|
||
|
.Dd 13 October 1998
|
||
|
.Dt INSTALL 8
|
||
|
.Os NetBSD
|
||
|
.Sh NAME
|
||
|
.Nm INSTALL
|
||
|
.Nd Installation procedure for NetBSD/\*[MACHINE]
|
||
|
.Sh DESCRIPTION
|
||
|
.Pp
|
||
|
.
|
||
|
.Ss About this Document
|
||
|
.
|
||
|
This document describes the installation procedure for
|
||
|
.Nx \*V
|
||
|
on the
|
||
|
.Em \*[MACHINE] No platform .
|
||
|
It is available in four different formats titled
|
||
|
.Pa INSTALL. Ns Ar ext ,
|
||
|
.No where Ar ext
|
||
|
is one of
|
||
|
.Pa .ps , .html , .more ,
|
||
|
.No or Pa txt .
|
||
|
.Bl -tag -width \&.morex -offset indent
|
||
|
.It Pa \&.ps
|
||
|
PostScript.
|
||
|
.It Pa \&.html
|
||
|
.No Standard internet Tn HTML .
|
||
|
.It Pa \&.more
|
||
|
The enhanced text format used on Unix-like systems by the
|
||
|
.Xr more 1
|
||
|
and
|
||
|
.Xr less 1
|
||
|
pager utility programs. This is the format in which the on-line
|
||
|
.Em man
|
||
|
pages are generally presented.
|
||
|
.It Pa \&.txt
|
||
|
Plain old
|
||
|
.Tn ASCII .
|
||
|
.El
|
||
|
.Pp
|
||
|
You are reading the
|
||
|
.Em \*[format] No version .
|
||
|
.
|
||
|
.Ss "What is NetBSD?"
|
||
|
.
|
||
|
The
|
||
|
.Nx
|
||
|
Operating System is a fully functional UN*X-like system
|
||
|
derived from the Berkeley Networking Release 2 (Net/2), 4.4BSD-Lite,
|
||
|
and 4.4BSD-Lite2 sources.
|
||
|
.Nx
|
||
|
runs on many architectures and is
|
||
|
being ported to more.
|
||
|
.Pp
|
||
|
.Nx
|
||
|
is a creation of the members of the Internet community.
|
||
|
Without the unique cooperation and coordination the net makes
|
||
|
possible, it's likely that this release wouldn't have come about.
|
||
|
.if \n[_FOR_RELEASE] \{\
|
||
|
.Pp
|
||
|
The
|
||
|
.Nx \*V
|
||
|
release is a landmark. Building upon the successful
|
||
|
.Nx
|
||
|
1.2 release, we have provided numerous and significant
|
||
|
functional enhancements, including support for many new devices,
|
||
|
integration of many bug fixes, new and updated kernel subsystems, and
|
||
|
many userland enhancements. The results of these improvements is a
|
||
|
stable operating system fit for production use that rivals most
|
||
|
commercially available systems.
|
||
|
.Pp
|
||
|
It is impossible to summarize the 18 months of development that went
|
||
|
into the
|
||
|
.Nx \*V
|
||
|
release. Some of the significant changes include:
|
||
|
.Bl -bullet
|
||
|
.It
|
||
|
Support for machine independent device drivers has been
|
||
|
radically improved with the addition of the "bus.h" interface,
|
||
|
providing a high quality abstraction for machine and
|
||
|
architecture independent device access.
|
||
|
.It
|
||
|
The bus_dma interface has also been integrated, providing a
|
||
|
machine-independent abstraction for DMA mapping. This permits many
|
||
|
good things, including (among many) clean multi-platform
|
||
|
bounce buffer support.
|
||
|
.It
|
||
|
Framework support for ISA "Plug and Play" has been added, as
|
||
|
well as support for numerous "Plug and Play" devices.
|
||
|
.It
|
||
|
APM support has been added to NetBSD/i386.
|
||
|
.It
|
||
|
An initial cut of multi-platform PCMCIA support has been added.
|
||
|
.It
|
||
|
Support for ATAPI devices (initially just ATAPI CD-ROM drives)
|
||
|
has been added.
|
||
|
.It
|
||
|
Support for Sun 3/80s (sun3x architecture) has been added.
|
||
|
.It
|
||
|
Support for R4000 DECstations has been added.
|
||
|
.It
|
||
|
Integration/merger of 4.4BSD Lite-2 sources into userland
|
||
|
programs has nearly been completed.
|
||
|
.It
|
||
|
Most of userland now compiles with high levels of gcc warnings
|
||
|
turned on, which has lead to the discovery and elimination of
|
||
|
many bugs.
|
||
|
.It
|
||
|
The i386 boot blocks have been completely replaced with a new,
|
||
|
libsa based two stage boot system. This has permitted
|
||
|
integration of compressed boot support (see below).
|
||
|
.It
|
||
|
Many ports now support booting of compressed kernels, and
|
||
|
feature new "Single Floppy" install systems that boot
|
||
|
compressed install kernels and ramdisks. We intend to do
|
||
|
substantial work on improving ease of installation in the
|
||
|
future.
|
||
|
.It
|
||
|
"ypserv" has been added, thus completing our support for the
|
||
|
"yp" network information system suite.
|
||
|
.It
|
||
|
Support for the Linux "ext2fs" filesystem and for FAT32 "msdosfs"
|
||
|
filesystems has been added.
|
||
|
.It
|
||
|
TCP now has a SYN "compressed state engine" which provides
|
||
|
increased robustness under high levels of received SYNs (as in
|
||
|
the case of "SYN flood" attacks.) (Much of this code was
|
||
|
derived from sources provided by BSDI.)
|
||
|
.It
|
||
|
An initial implementation of Path MTU discovery has been
|
||
|
integrated (though it is not turned on by default).
|
||
|
.It
|
||
|
An initial kernel based random number generator pseudodevice has
|
||
|
been added.
|
||
|
.It
|
||
|
Several major fixes have been integrated for the VM subsystem,
|
||
|
including the fix of a notorious VM leak, improved
|
||
|
synchronization between mmap()ed and open()ed files, and
|
||
|
massively improved performance in low real memory conditions.
|
||
|
.It
|
||
|
A new swap subsystem has radically improved configuration and
|
||
|
management of swap devices and adds swapping to files.
|
||
|
.It
|
||
|
Userland ntp support, including xntpd, has been integrated.
|
||
|
.It
|
||
|
The audio subsystems have been substantially debugged and
|
||
|
improved, and now offer substantial emulation of the OSS audio
|
||
|
interface, thus providing the ability to cleanly run emulated
|
||
|
Linux and FreeBSD versions of sound intensive programs.
|
||
|
.It
|
||
|
A "packages" system has been adapted from FreeBSD and will
|
||
|
provide binary package installations for third party
|
||
|
applications.
|
||
|
.It
|
||
|
The XFree86 X source tree has been made a supported part of
|
||
|
the
|
||
|
.Nx
|
||
|
distribution, and X servers (if built for this
|
||
|
port), libraries and utilities are now shipped with our releases.
|
||
|
.It
|
||
|
The ftp(1) program has been made astoundingly overfunctional.
|
||
|
It supports command line editing, tab completion, status bars,
|
||
|
automatic download of URLs specified on the command line,
|
||
|
firewall support and many other features.
|
||
|
.It
|
||
|
All ports now use "new" config. Old config has been laid to rest.
|
||
|
.It
|
||
|
The ARP subsystem and API has been rewritten to make it less
|
||
|
ethernet-centric.
|
||
|
.It
|
||
|
A new if_media subsystem has been added which allows network
|
||
|
interfaces to be configured using media type names rather than
|
||
|
device-specific mode bits.
|
||
|
.It
|
||
|
Many kernel interface manual pages have been added to manual
|
||
|
section 9.
|
||
|
.It
|
||
|
Several ports support much more hardware.
|
||
|
.It
|
||
|
Many updates to bring
|
||
|
.Nx
|
||
|
closer to standards compliance.
|
||
|
.It
|
||
|
Most third party packages have been updated to the latest stable
|
||
|
release.
|
||
|
.El
|
||
|
As has been noted, there have also been innumerable bug fixes.
|
||
|
.Pp
|
||
|
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.
|
||
|
.Pp
|
||
|
.Nx \*V also includes some refinement to the
|
||
|
.Nx
|
||
|
binary emulation
|
||
|
system (which includes FreeBSD, HP-UX, iBCS2, Linux, OSF/1, SunOS, SVR4,
|
||
|
Solaris and Ultrix compatibility), bringing
|
||
|
.Nx
|
||
|
closer to the goal of
|
||
|
making the emulation as accurate as possible.
|
||
|
.Pp
|
||
|
In the near future, we hope to integrate a fully rewritten Virtual
|
||
|
Memory subsystem, kernel threads, and SMP support.
|
||
|
.Pp
|
||
|
.so whatis -----------------------------------------------
|
||
|
.\}
|
||
|
.
|
||
|
.Ss "The Future of NetBSD"
|
||
|
.
|
||
|
The
|
||
|
.Nx
|
||
|
Foundation has been incorporated as a non-profit
|
||
|
organization. Its purpose is to encourage, foster and promote the
|
||
|
free exchange of computer software, namely the
|
||
|
.Nx
|
||
|
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
|
||
|
.Nx
|
||
|
Project.
|
||
|
.Pp
|
||
|
The
|
||
|
.Nx
|
||
|
Foundation will help improve the quality of
|
||
|
.Nx
|
||
|
by:
|
||
|
.Bl -bullet
|
||
|
.It
|
||
|
providing better organization to keep track of development
|
||
|
efforts, including co-ordination with groups working in
|
||
|
related fields.
|
||
|
.It
|
||
|
providing a framework to receive donations of goods and
|
||
|
services and to own the resources necessary to run the
|
||
|
.Nx
|
||
|
Project.
|
||
|
.It
|
||
|
providing a better position from which to undertake
|
||
|
promotional activities.
|
||
|
.It
|
||
|
periodically organizing workshops for developers and other
|
||
|
interested people to discuss ongoing work.
|
||
|
.El
|
||
|
We hope to have regular releases of the full binary and source trees,
|
||
|
but these are difficult to coordinate, especially with all of the
|
||
|
architectures which we now support!
|
||
|
.Pp
|
||
|
We hope to support even
|
||
|
.Em more
|
||
|
hardware in the future, and we have a
|
||
|
rather large number of other ideas about what can be done to improve
|
||
|
.Nx .
|
||
|
.Pp
|
||
|
We intend to continue our current practice of making the
|
||
|
NetBSD-current development source available on a daily basis.
|
||
|
.Pp
|
||
|
We intend to integrate free, positive changes from whatever sources
|
||
|
will provide them, providing that they are well thought-out and
|
||
|
increase the usability of the system.
|
||
|
.Pp
|
||
|
Above all, we hope to create a stable and accessible system, and to be
|
||
|
responsive to the needs and desires of
|
||
|
.Nx
|
||
|
users, because it is for
|
||
|
and because of them that
|
||
|
.Nx
|
||
|
exists.
|
||
|
.br_ne 10P
|
||
|
.
|
||
|
.Ss "Sources of NetBSD"
|
||
|
.
|
||
|
.so ../common/mirrors -----------------------------------------------
|
||
|
.br_ne 10P
|
||
|
.
|
||
|
.Ss "NetBSD \*V Release Contents
|
||
|
.
|
||
|
The root directory of the
|
||
|
.Nx \*V
|
||
|
release is organized as follows:
|
||
|
.ie \n[_FOR_RELEASE] \{\
|
||
|
.Pp
|
||
|
.Pa .../NetBSD-\*V/
|
||
|
.Bl -tag -width LAST_MINUTE
|
||
|
.It Li BUGS
|
||
|
Known bugs list (somewhat incomplete and out of date).
|
||
|
.It Li CHANGES
|
||
|
Changes since earlier
|
||
|
.Nx
|
||
|
releases.
|
||
|
.It Li LAST_MINUTE
|
||
|
Last minute changes.
|
||
|
.It Li MIRRORS
|
||
|
A list of sites that mirror the
|
||
|
.Nx \*V
|
||
|
distribution.
|
||
|
.It Li README.files
|
||
|
README describing the distribution's contents.
|
||
|
.It Li TODO
|
||
|
NetBSD's todo list (also somewhat incomplete and out of date).
|
||
|
.It Li patches/
|
||
|
Post-release source code patches.
|
||
|
.It Li source/
|
||
|
Source distribution sets; see below.
|
||
|
.El
|
||
|
.Pp
|
||
|
In addition to the files and directories listed above, there is one
|
||
|
directory per architecture, for each of the architectures for which
|
||
|
.Nx \*V
|
||
|
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 (i.e. the `domestic' portion) that may be subject to
|
||
|
export regulations of the United States. It is your responsibility
|
||
|
to determine whether or not it is legal for you to export these portions
|
||
|
and to act accordingly.
|
||
|
.Pp
|
||
|
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:
|
||
|
.Bl -tag -width sharesrc.tgz...
|
||
|
.It secrsrc.tgz:
|
||
|
This set contains the "domestic" sources. These
|
||
|
sources may be subject to United States export
|
||
|
regulations.
|
||
|
.br
|
||
|
.Em 412K gzipped, 1.8M uncompressed
|
||
|
.It gnusrc.tgz:
|
||
|
This set contains the "gnu" sources, including
|
||
|
the source for the compiler, assembler, groff,
|
||
|
and the other GNU utilities in the binary distribution
|
||
|
sets.
|
||
|
.br
|
||
|
.Em 15.6M gzipped, 66.4M uncompressed
|
||
|
.It syssrc.tgz:
|
||
|
This set contains the sources to the
|
||
|
.Nx \*V
|
||
|
kernel, config(8), and dbsym(8).
|
||
|
.br
|
||
|
.Em 10.7M gzipped, 50.0M uncompressed
|
||
|
.It sharesrc.tgz:
|
||
|
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.
|
||
|
.br
|
||
|
.Em 2.9M gzipped, 11.1M uncompressed
|
||
|
.It src.tgz:
|
||
|
This set contains all of the
|
||
|
.Nx \*V
|
||
|
sources which
|
||
|
are not mentioned above.
|
||
|
.br
|
||
|
.Em 13.9M gzipped, 60.7M uncompressed
|
||
|
.El
|
||
|
.Pp
|
||
|
Most of the above source sets are located in the
|
||
|
.Pa source/sets
|
||
|
subdirectory of the distribution tree. The secrsrc.tgz set is
|
||
|
contained in the
|
||
|
.Pa source/security
|
||
|
subdirectory. This set, which is
|
||
|
available only to users in the United States and Canada, contains the
|
||
|
sources normally found in
|
||
|
.Pa /usr/src/domestic
|
||
|
\- primarily kerberos and
|
||
|
other cryptographic security related software. (Remember, because of
|
||
|
United States law, it may not be legal to distribute this set to
|
||
|
locations outside of the United States and Canada.)
|
||
|
.Pp
|
||
|
The source sets are distributed as compressed tar files. They may be
|
||
|
unpacked into
|
||
|
.Pa /usr/src
|
||
|
with the command:
|
||
|
.D1 Ic "cat set_name.tgz | gunzip | (cd /; tar xpf - )
|
||
|
.No The Pa sets/Split/
|
||
|
.No and Pa security/Split/
|
||
|
subdirectories contain 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 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
|
||
|
distribution set.)
|
||
|
.Pp
|
||
|
The split distributions may be reassembled and extracted with
|
||
|
.Ic cat No as follows:
|
||
|
.D1 Ic "cat set_name.?? | gunzip | (cd /; tar xpf - )
|
||
|
.Pp
|
||
|
In each of the source distribution set directories, there is a file
|
||
|
named
|
||
|
.Pa CKSUMS
|
||
|
which contains the checksums of the files in that
|
||
|
directory, as generated by the
|
||
|
.Xr cksum 1
|
||
|
utility. You can use cksum to
|
||
|
check the integrity of the archives, if you suspect that one of the
|
||
|
files is corrupt and have access to a cksum binary. Checksums based on
|
||
|
other algorithms may also be present \*- see the
|
||
|
.Xr release 7
|
||
|
man page for details.
|
||
|
.\}
|
||
|
.el \{\
|
||
|
.Pp
|
||
|
.Pa \&.../NetBSD-current/tar_files/
|
||
|
.Dl doc.tar.gz
|
||
|
.Dl pkgsrc.tar.gz
|
||
|
.Dl src/*.tar.gz
|
||
|
.Dl xsrc.tar.gz
|
||
|
.Pp
|
||
|
Other directories provide unpacked source trees for distribution via
|
||
|
the source update protocol, for more information see:
|
||
|
.Lk http://www.netbsd.org/Sites/net.html#sup
|
||
|
.\}
|
||
|
.so ../common/contents -----------------------------------------------
|
||
|
.br_ne 7P
|
||
|
.
|
||
|
.Ss "NetBSD/\*[MACHINE] System Requirements and Supported Devices"
|
||
|
.
|
||
|
.so hardware -----------------------------------------------
|
||
|
.br_ne 7P
|
||
|
.
|
||
|
.Ss "Getting the NetBSD System on to Useful Media"
|
||
|
.
|
||
|
.so xfer -----------------------------------------------
|
||
|
.br_ne 7P
|
||
|
.
|
||
|
.Ss "Preparing your System for NetBSD Installation"
|
||
|
.
|
||
|
.so prep -----------------------------------------------
|
||
|
.br_ne 7P
|
||
|
.
|
||
|
.Ss "Installing the NetBSD System"
|
||
|
.
|
||
|
.so install -----------------------------------------------
|
||
|
.br_ne 7P
|
||
|
.
|
||
|
.Ss "Post installation steps"
|
||
|
.
|
||
|
.so ../common/postinstall -----------------------------------------------
|
||
|
.br_ne 7P
|
||
|
.
|
||
|
.Ss "Upgrading a previously-installed NetBSD System"
|
||
|
.
|
||
|
.so upgrade -----------------------------------------------
|
||
|
.br_ne 7P
|
||
|
.
|
||
|
.Ss "Compatibility Issues With Previous NetBSD Releases"
|
||
|
.
|
||
|
Users upgrading from previous versions of
|
||
|
.Nx
|
||
|
may wish to bear the
|
||
|
following problems and compatibility issues in mind when upgrading to
|
||
|
.Nx \*V
|
||
|
.
|
||
|
.
|
||
|
.Bl -bullet
|
||
|
.It
|
||
|
Swap configuration
|
||
|
.
|
||
|
.
|
||
|
.Bl -tag -width 3n
|
||
|
.It Description
|
||
|
All swap partitions are now configured by the swapctl(8)
|
||
|
program. The kernel no longer configures a default swap
|
||
|
partition. Because of this, all swap partitions
|
||
|
.No must be listed in Pa /etc/fstab .
|
||
|
.Pp
|
||
|
Many users of previous releases relied on the kernel
|
||
|
configuring a "default" swap partition and did not list any swap space in
|
||
|
.Pa /etc/fstab
|
||
|
at all -- such users will now have no
|
||
|
swap space configured unless they list swap partitions in
|
||
|
.Pa /etc/fstab !
|
||
|
.Pp
|
||
|
Common symptoms of of this problem include machine crashes
|
||
|
during builds, and similar memory intensive activities.
|
||
|
.It Fix
|
||
|
The most common position for a swap partition is the `b'
|
||
|
partition of the drive the root file system is on. For
|
||
|
diskless systems, check the new swapctl(8) manual for more
|
||
|
detail on how this is done. Example fstab entries:
|
||
|
.
|
||
|
.Bl -column /dev/sd0bxx nonexx swapxx sw,priority=0xx
|
||
|
.It /dev/sd0b Ta none Ta swap Ta sw,priority=0
|
||
|
.It /dev/sd1b Ta none Ta swap Ta sw,priority=5
|
||
|
.El
|
||
|
.
|
||
|
.El
|
||
|
.
|
||
|
.It
|
||
|
NFS now uses reserved ports
|
||
|
.
|
||
|
.Bl -tag -width 3n
|
||
|
.It Description
|
||
|
Earlier versions of
|
||
|
.Nx
|
||
|
did not use a reserved (\*(<= 1023)
|
||
|
port when making NFS client requests. When acting as a server
|
||
|
NetBSD now requires reserved ports by default.
|
||
|
.Pp
|
||
|
Old clients mounting a new server will receive a 'permission
|
||
|
denied' response when the directory is accessed. New clients
|
||
|
should work fine with old servers.
|
||
|
.It Fix
|
||
|
Add '-P' to the mount options in the old client's
|
||
|
.Pa /etc/fstab ,
|
||
|
or (less preferred), add
|
||
|
.Li \&-noresvport,noresvmnt
|
||
|
to the options on the new server's
|
||
|
.Pa /etc/exports .
|
||
|
.El
|
||
|
.
|
||
|
.It
|
||
|
NFS daemons and other programs in /sbin moved
|
||
|
.
|
||
|
.Bl -tag -width 3n
|
||
|
.It Description
|
||
|
The NFS daemons (nfsd, nfsiod, mountd) have been moved from
|
||
|
the
|
||
|
.Pa /sbin
|
||
|
to the
|
||
|
.Pa /usr/sbin directory .
|
||
|
When new binaries are
|
||
|
loaded over old ones during upgrade, most programs get
|
||
|
overlaid and replaced, but unless these binaries are
|
||
|
explicitly removed they will not disappear. The installation
|
||
|
subsystems on some
|
||
|
.Nx
|
||
|
architectures will not properly
|
||
|
remove these binaries.
|
||
|
.Pp
|
||
|
Due to changes in the NFS subsystem, the old NFS daemon
|
||
|
binaries will not work correctly, and will cause serious
|
||
|
problems. Unfortunately, the default startup script
|
||
|
.Pq Pa /etc/rc
|
||
|
will run the old binaries in
|
||
|
.Pa /sbin
|
||
|
if they are present instead of the new ones in
|
||
|
.Pa /usr/sbin .
|
||
|
.Pp
|
||
|
Some other programs (dumpfs, dumplfs and quotacheck) have also
|
||
|
been moved from
|
||
|
.Pa /sbin
|
||
|
to
|
||
|
.Pa /usr/sbin ,
|
||
|
and old versions may be
|
||
|
left behind by accident. They, too, may cause difficulties.
|
||
|
.It Fix
|
||
|
Remove the old daemon binaries
|
||
|
.Pp Pa (/sbin/nfsiod ,
|
||
|
.Pa /sbin/nfsd ,
|
||
|
.Pa /sbin/mountd ,
|
||
|
.Pq etc.
|
||
|
after your upgrade has finished. You may
|
||
|
wish to do an
|
||
|
.D1 Ic "ls -lt /sbin | more
|
||
|
to help determine which
|
||
|
binaries were not replaced/removed during your upgrade.
|
||
|
.El
|
||
|
.
|
||
|
.It
|
||
|
.Tn AMANDA
|
||
|
(The Advanced Maryland Automatic Network Disk Archiver, from
|
||
|
.Lk http://www.amanda.org)
|
||
|
.
|
||
|
.Bl -tag -width 3n
|
||
|
.It Description
|
||
|
Due to a change in the output of dump(8) to ensure
|
||
|
consistency in the messages, AMANDA's dump output
|
||
|
parser breaks.
|
||
|
.Pp
|
||
|
Error messages such as the following may be an
|
||
|
indication that this problem is present:
|
||
|
.
|
||
|
.Bd -unfilled
|
||
|
FAILURE AND STRANGE DUMP SUMMARY:
|
||
|
hostname wd0e lev 1 FAILED [no backup size line]
|
||
|
.Ed
|
||
|
.
|
||
|
.It Versions affected
|
||
|
2.3.0.4, and most likely earlier versions
|
||
|
.It Workaround/Fix
|
||
|
One of:
|
||
|
.
|
||
|
.Bl -bullet
|
||
|
.It
|
||
|
Apply
|
||
|
.Lk ftp://ftp.netbsd.org/pub/NetBSD/misc/patches/amanda-pre-2.4.patch \
|
||
|
this\~patch
|
||
|
.It
|
||
|
Upgrade to AMANDA 2.4.0 or newer. The side effect of this is
|
||
|
that the network protocol is incompatible with earlier
|
||
|
versions.
|
||
|
.El
|
||
|
.
|
||
|
.El
|
||
|
.
|
||
|
.El
|
||
|
.
|
||
|
.
|
||
|
.Ss "Using online NetBSD documentation"
|
||
|
.Pp
|
||
|
Documentation is available if you first install the manual
|
||
|
distribution set. Traditionally, the
|
||
|
.Dq man pages
|
||
|
(documentation) are denoted by
|
||
|
.Dq Li name(section) .
|
||
|
Some examples of this are
|
||
|
.Pp
|
||
|
.Bl -bullet -compact -offset indent
|
||
|
.It
|
||
|
.Xr intro 1 ,
|
||
|
.It
|
||
|
.Xr man 1 ,
|
||
|
.It
|
||
|
.Xr apropros 1 ,
|
||
|
.It
|
||
|
.Xr passwd 1 ,
|
||
|
and
|
||
|
.It
|
||
|
.Xr passwd 5 .
|
||
|
.El
|
||
|
.Pp
|
||
|
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.
|
||
|
.Pp
|
||
|
.No The Em man
|
||
|
command is used to view the documentation on a topic, and is
|
||
|
started by entering
|
||
|
.Ic man Op Ar section
|
||
|
.Ar topic .
|
||
|
The brackets
|
||
|
.Op \&
|
||
|
around the
|
||
|
section should not be entered, but rather indicate that the section is
|
||
|
optional. If you don't ask for a particular section, the topic with the
|
||
|
lowest numbered section name will be displayed. For instance, after
|
||
|
logging in, enter
|
||
|
.D1 Ic "man passwd
|
||
|
to read the documentation for
|
||
|
.Xr passwd 1 .
|
||
|
To view the documentation for
|
||
|
.Xr passwd 5 m
|
||
|
enter
|
||
|
.D1 Ic man 5 passwd
|
||
|
instead.
|
||
|
.Pp
|
||
|
If you are unsure of what man page you are looking for, enter
|
||
|
.Ic apropos Ar subject-word
|
||
|
.Pp
|
||
|
where
|
||
|
.Ar subject-word
|
||
|
is your topic of interest; a list of possibly
|
||
|
related man pages will be displayed.
|
||
|
.
|
||
|
.Ss 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
|
||
|
.Mt majordomo@NetBSD.ORG .
|
||
|
To get help on using the mailing
|
||
|
list server, send mail to that address with an empty body, and it will
|
||
|
reply with instructions.
|
||
|
.Pp
|
||
|
There are various mailing lists set up to deal with comments and
|
||
|
questions about this release. Please send comments to:
|
||
|
.Mt netbsd-comments@NetBSD.ORG .
|
||
|
.Pp
|
||
|
To report bugs, use the
|
||
|
.Xr send-pr 1
|
||
|
command shipped with
|
||
|
.Nx ,
|
||
|
and fill in as much information about the problem as you can. Good
|
||
|
bug reports include lots of details. Additionally, bug reports can
|
||
|
be sent by mail to:
|
||
|
.Mt netbsd-bugs@NetBSD.ORG .
|
||
|
.Pp
|
||
|
Use of
|
||
|
.Xr send-pr 1
|
||
|
is encouraged, however, because bugs reported with it
|
||
|
are entered into the
|
||
|
.Nx
|
||
|
bugs database, and thus can't slip through
|
||
|
the cracks.
|
||
|
.Pp
|
||
|
There are also port-specific mailing lists, to discuss aspects of
|
||
|
each port of
|
||
|
.Nx .
|
||
|
Use majordomo to find their addresses. 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
|
||
|
below).
|
||
|
.Pp
|
||
|
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:
|
||
|
.Mt netbsd-help@NetBSD.ORG .
|
||
|
.Pp
|
||
|
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 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.
|
||
|
.
|
||
|
.Ss Thanks go to
|
||
|
.
|
||
|
.Bl -bullet
|
||
|
.It
|
||
|
The former members of UCB's Computer Systems Research Group,
|
||
|
including (but not limited to):
|
||
|
.Bd -unfilled -offset indent
|
||
|
Keith Bostic
|
||
|
Ralph Campbell
|
||
|
Mike Karels
|
||
|
Marshall Kirk McKusick
|
||
|
.Ed
|
||
|
.Pp
|
||
|
for their ongoing work on BSD systems, support, and encouragement.
|
||
|
.It
|
||
|
Also, our thanks go to:
|
||
|
.Bd -unfilled -offset indent
|
||
|
Mike Hibler
|
||
|
Rick Macklem
|
||
|
Jan-Simon Pendry
|
||
|
Chris Torek
|
||
|
.Ed
|
||
|
.Pp
|
||
|
for answering lots of questions, fixing bugs, and doing the various work
|
||
|
they've done.
|
||
|
.It
|
||
|
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
|
||
|
.Nx .
|
||
|
.It
|
||
|
Best Internet Communications for hosting the
|
||
|
.Nx
|
||
|
FTP and SUP server.
|
||
|
.It
|
||
|
Cygnus Support for hosting the
|
||
|
.Nx
|
||
|
Mail server.
|
||
|
.It
|
||
|
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.
|
||
|
.It
|
||
|
Dave Burgess
|
||
|
.Mt burgess@cynjut.infonet.net
|
||
|
has been maintaining the
|
||
|
386BSD/NetBSD/FreeBSD FAQ for quite some time, and deserves to be
|
||
|
recognized for it.
|
||
|
.It
|
||
|
The following people (in alphabetical order) have made donations or
|
||
|
loans of hardware and/or money, to support
|
||
|
.Nx
|
||
|
development, and
|
||
|
deserve credit for it:
|
||
|
.so ../common/donations -----------------------------------------------
|
||
|
(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.)
|
||
|
.It
|
||
|
Finally, we thank all of the people who've put sweat and tears into
|
||
|
developing
|
||
|
.Nx
|
||
|
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!)
|
||
|
.El
|
||
|
.
|
||
|
.Ss "We are..."
|
||
|
.
|
||
|
.Pp
|
||
|
(in alphabetical order)
|
||
|
.Pp
|
||
|
.
|
||
|
.
|
||
|
.Bl -column XXxxx Frank\ van\ der\ Lindenxx sakamoto@NetBSD.ORGxx newsmips
|
||
|
.
|
||
|
.br_ne 1i
|
||
|
.It-span Em "The NetBSD core group:"
|
||
|
.It Ta Ta
|
||
|
.It Ta Paul Kranenburg Ta Mt pk@NetBSD.ORG
|
||
|
.It Ta Herb Peyerl Ta Mt hpeyerl@NetBSD.ORG
|
||
|
.It Ta Scott Reynolds Ta Mt scottr@NetBSD.ORG
|
||
|
.It Ta Jason Thorpe Ta Mt thorpej@NetBSD.ORG
|
||
|
.It Ta Christos Zoulas Ta Mt christos@NetBSD.ORG
|
||
|
.It Ta Ta
|
||
|
.br_ne 2i
|
||
|
.It-span Em "The portmasters (and their ports):"
|
||
|
.It Ta Ta
|
||
|
.It Ta Mark Brinicombe Ta Mt mark@NetBSD.ORG Ta Sy arm32
|
||
|
.It Ta Jeremy Cooper Ta Mt jeremy@NetBSD.ORG Ta Sy sun3x
|
||
|
.It Ta Chuck Cranor Ta Mt chuck@NetBSD.ORG Ta Sy mvme68k
|
||
|
.It Ta Ross Harvey Ta Mt ross@NetBSD.ORG Ta Sy alpha
|
||
|
.It Ta Chris Hopps Ta Mt chopps@NetBSD.ORG Ta Sy amiga
|
||
|
.It Ta Eduardo Horvath Ta Mt eeh@NetBSD.ORG Ta Sy sparc64
|
||
|
.It Ta Paul Kranenburg Ta Mt pk@NetBSD.ORG Ta Sy sparc
|
||
|
.It Ta Anders Magnusson Ta Mt ragge@NetBSD.ORG Ta Sy vax
|
||
|
.It Ta Tsubai Masanari Ta Mt tsubai@NetBSD.ORG Ta Sy macppc
|
||
|
.It Ta Tsubai Masanari Ta Mt tsubai@NetBSD.ORG Ta Sy newsmips
|
||
|
.It Ta Phil Nelson Ta Mt phil@NetBSD.ORG Ta Sy pc532
|
||
|
.It Ta Masaru Oki Ta Mt oki@NetBSD.ORG Ta Sy x68k
|
||
|
.It Ta Scott Reynolds Ta Mt scottr@NetBSD.ORG Ta Sy mac68k
|
||
|
.It Ta Gordon Ross Ta Mt gwr@NetBSD.ORG Ta Sy sun3,\ sun3x
|
||
|
.It Ta Kazuki Sakamoto Ta Mt sakamoto@NetBSD.ORG Ta Sy bebox
|
||
|
.It Ta Wolfgang Solfrank Ta Mt ws@NetBSD.ORG Ta Sy powerpc
|
||
|
.It Ta Jonathan Stone Ta Mt jonathan@NetBSD.ORG Ta Sy pmax
|
||
|
.It Ta Jason Thorpe Ta Mt thorpej@NetBSD.ORG Ta Sy hp300
|
||
|
.It Ta "Frank van der Linden" Ta Mt fvdl@NetBSD.ORG Ta Sy i386
|
||
|
.It Ta Leo Weppelman Ta Mt leo@NetBSD.ORG Ta Sy atari
|
||
|
.It Ta Ta
|
||
|
.br_ne 1i
|
||
|
.It-span Em "The NetBSD \*V Release Engineering team:"
|
||
|
.It Ta Ta
|
||
|
.It Ta Chris G. Demetriou Ta Mt cgd@NetBSD.ORG
|
||
|
.It Ta Ted Lemon Ta Mt mellon@NetBSD.ORG
|
||
|
.It Ta Perry Metzger Ta Mt perry@NetBSD.ORG
|
||
|
.It Ta Jason Thorpe Ta Mt thorpej@NetBSD.ORG
|
||
|
.It Ta Ta
|
||
|
.br_ne 2i
|
||
|
.It-span Em "Developers and other contributors:"
|
||
|
.It Ta Ta
|
||
|
.It Ta Steve Allen Ta Mt wormey@NetBSD.ORG
|
||
|
.It Ta Lennart Augustsson Ta Mt augustss@NetBSD.ORG
|
||
|
.It Ta Christoph Badura Ta Mt bad@NetBSD.ORG
|
||
|
.It Ta Manuel Bouyer Ta Mt bouyer@NetBSD.ORG
|
||
|
.It Ta Robert V. Baron Ta Mt rvb@NetBSD.ORG
|
||
|
.It Ta John Brezak Ta Mt brezak@NetBSD.ORG
|
||
|
.It Ta Allen Briggs Ta Mt briggs@NetBSD.ORG
|
||
|
.It Ta Aaron Brown Ta Mt abrown@NetBSD.ORG
|
||
|
.It Ta David Brownlee Ta Mt abs@NetBSD.ORG
|
||
|
.It Ta Simon Burge Ta Mt simonb@NetBSD.ORG
|
||
|
.It Ta Dave Burgess Ta Mt burgess@cynjut.infonet.net
|
||
|
.It Ta Dave Carrel Ta Mt carrel@NetBSD.ORG
|
||
|
.It Ta Bill Coldwell Ta Mt billc@NetBSD.ORG
|
||
|
.It Ta Alistair Crooks Ta Mt agc@NetBSD.ORG
|
||
|
.It Ta Aidan Cully Ta Mt aidan@NetBSD.ORG
|
||
|
.It Ta Rob Deker Ta Mt deker@NetBSD.ORG
|
||
|
.It Ta Chris G. Demetriou Ta Mt cgd@NetBSD.ORG
|
||
|
.It Ta Matthias Drochner Ta Mt drochner@NetBSD.ORG
|
||
|
.It Ta Enami Tsugutomo Ta Mt enami@NetBSD.ORG
|
||
|
.It Ta Bernd Ernesti Ta Mt veego@NetBSD.ORG
|
||
|
.It Ta Erik Fair Ta Mt fair@NetBSD.ORG
|
||
|
.It Ta Hubert Feyrer Ta Mt hubertf@NetBSD.ORG
|
||
|
.It Ta Thorsten Frueauf Ta Mt frueauf@NetBSD.ORG
|
||
|
.It Ta Brian R. Gaeke Ta Mt brg@dgate.org
|
||
|
.It Ta Thomas Gerner Ta Mt thomas@NetBSD.ORG
|
||
|
.It Ta Justin Gibbs Ta Mt gibbs@NetBSD.ORG
|
||
|
.It Ta Adam Glass Ta Mt glass@NetBSD.ORG
|
||
|
.It Ta Michael Graff Ta Mt explorer@NetBSD.ORG
|
||
|
.It Ta Brad Grantham Ta Mt grantham@tenon.com
|
||
|
.It Ta Matthew Green Ta Mt mrg@NetBSD.ORG
|
||
|
.It Ta Juergen Hannken-Illjes Ta Mt hannken@NetBSD.ORG
|
||
|
.It Ta Charles M. Hannum Ta Mt mycroft@NetBSD.ORG
|
||
|
.It Ta Eric Haszlakiewicz Ta Mt erh@NetBSD.ORG
|
||
|
.It Ta Michael L. Hitch Ta Mt osymh@NetBSD.ORG
|
||
|
.It Ta Ken Hornstein Ta Mt kenh@NetBSD.ORG
|
||
|
.It Ta Marc Horowitz Ta Mt marc@NetBSD.ORG
|
||
|
.It Ta ITOH Yasufumi Ta Mt itohy@NetBSD.ORG
|
||
|
.It Ta Matthew Jacob Ta Mt mjacob@NetBSD.ORG
|
||
|
.It Ta Lonhyn T. Jasinskyj Ta Mt lonhyn@NetBSD.ORG
|
||
|
.It Ta Darrin Jewell Ta Mt dbj@NetBSD.ORG
|
||
|
.It Ta Lawrence Kesteloot Ta Mt kesteloo@cs.unc.edu
|
||
|
.It Ta Klaus Klein Ta Mt kleink@NetBSD.ORG
|
||
|
.It Ta John Kohl Ta Mt jtk@NetBSD.ORG
|
||
|
.It Ta Kevin Lahey Ta Mt kml@NetBSD.ORG
|
||
|
.It Ta Ted Lemon Ta Mt mellon@NetBSD.ORG
|
||
|
.It Ta Mike Long Ta Mt mikel@NetBSD.ORG
|
||
|
.It Ta Paul Mackerras Ta Mt paulus@NetBSD.ORG
|
||
|
.It Ta Neil J. McRae Ta Mt neil@NetBSD.ORG
|
||
|
.It Ta Perry Metzger Ta Mt perry@NetBSD.ORG
|
||
|
.It Ta Luke Mewburn Ta Mt lukem@NetBSD.ORG
|
||
|
.It Ta Minoura Makoto Ta Mt minoura@NetBSD.ORG
|
||
|
.It Ta der Mouse Ta Mt mouse@NetBSD.ORG
|
||
|
.It Ta Tohru Nishimura Ta Mt nisimura@NetBSD.ORG
|
||
|
.It Ta Greg Oster Ta Mt oster@NetBSD.ORG
|
||
|
.It Ta Matthias Pfaller Ta Mt matthias@NetBSD.ORG
|
||
|
.It Ta Dante Profeta Ta Mt dante@NetBSD.ORG
|
||
|
.It Ta Chris Provenzano Ta Mt proven@NetBSD.ORG
|
||
|
.It Ta Waldi Ravens Ta Mt waldi@moacs.indiv.nl.net
|
||
|
.It Ta Darren Reed Ta Mt darrenr@NetBSD.ORG
|
||
|
.It Ta Tim Rightnour Ta Mt garbled@NetBSD.ORG
|
||
|
.It Ta Heiko W. Rupp Ta Mt hwr@NetBSD.ORG
|
||
|
.It Ta SAITOH Masanobu Ta Mt msaitoh@NetBSD.ORG
|
||
|
.It Ta Kazuki Sakamoto Ta Mt sakamoto@NetBSD.ORG
|
||
|
.It Ta Curt Sampson Ta Mt cjs@NetBSD.ORG
|
||
|
.It Ta Wilfredo Sanchez Ta Mt wsanchez@NetBSD.ORG
|
||
|
.It Ta Ty Sarna Ta Mt tsarna@NetBSD.ORG
|
||
|
.It Ta Matthias Scheler Ta Mt tron@NetBSD.ORG
|
||
|
.It Ta Karl Schilke (rAT) Ta Mt rat@NetBSD.ORG
|
||
|
.It Ta Tim Shepard Ta Mt shep@NetBSD.ORG
|
||
|
.It Ta Chuck Silvers Ta Mt chs@NetBSD.ORG
|
||
|
.It Ta Thor Lancelot Simon Ta Mt tls@NetBSD.ORG
|
||
|
.It Ta Noriyuki Soda Ta Mt soda@NetBSD.ORG
|
||
|
.It Ta Wolfgang Solfrank Ta Mt ws@NetBSD.ORG
|
||
|
.It Ta Bill Sommerfeld Ta Mt sommerfeld@NetBSD.ORG
|
||
|
.It Ta Ignatios Souvatzis Ta Mt is@NetBSD.ORG
|
||
|
.It Ta Bill Studenmund Ta Mt wrstuden@NetBSD.ORG
|
||
|
.It Ta Kevin Sullivan Ta Mt sullivan@NetBSD.ORG
|
||
|
.It Ta Kimmo Suominen Ta Mt kim@NetBSD.ORG
|
||
|
.It Ta Matt Thomas Ta Mt matt@NetBSD.ORG
|
||
|
.It Ta Christoph Toshok Ta Mt toshok@NetBSD.ORG
|
||
|
.It Ta Todd Vierling Ta Mt tv@NetBSD.ORG
|
||
|
.It Ta Paul Vixie Ta Mt vixie@NetBSD.ORG
|
||
|
.It Ta Krister Walfridsson Ta Mt kristerw@NetBSD.ORG
|
||
|
.It Ta Nathan Williams Ta Mt nathanw@NetBSD.ORG
|
||
|
.It Ta Colin Wood Ta Mt ender@NetBSD.ORG
|
||
|
.It Ta Steve Woodford Ta Mt scw@NetBSD.ORG
|
||
|
.
|
||
|
.El
|
||
|
.
|
||
|
.Ss "Legal Mumbo-Jumbo"
|
||
|
.
|
||
|
The following notices are required to satisfy the license terms of
|
||
|
the software that we have mentioned in this document:
|
||
|
.Pp
|
||
|
.nr save_size \n[.s]
|
||
|
.nr save_vs \n[.v]
|
||
|
.ps 8
|
||
|
.vs 9
|
||
|
.Ht <font size=-1>
|
||
|
.so ../common/legal.common -----------------------------------------------
|
||
|
.so legal -----------------------------------------------
|
||
|
.Ht </font>
|
||
|
.ps
|
||
|
.vs
|