457 lines
16 KiB
Plaintext
457 lines
16 KiB
Plaintext
.\" $NetBSD: contents,v 1.10 1999/05/24 07:03:17 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.
|
|
.\"
|
|
.ds m \*[MACHINE]
|
|
.Ss2 NetBSD/\*m Subdirectory Structure
|
|
The \*m-specific portion of the
|
|
.Nx \*V
|
|
release is found in the
|
|
.Pa \*m
|
|
subdirectory of the distribution:
|
|
.ie \n[_FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*m/
|
|
.el .Pa Pf \&.../arch/\*m/snapshot/ Ar yyyymmdd/
|
|
.Bl -tag -compact -width INSTALL.html
|
|
. It Pa INSTALL.html
|
|
. It Pa INSTALL.ps
|
|
. It Pa INSTALL.txt
|
|
. It Pa INSTALL.more
|
|
Installation notes; this file. The
|
|
.Pa \&.more No file contains underlined text using the
|
|
.Xr more 1
|
|
conventions for indicating italic and bold display.
|
|
. It Pa binary/
|
|
. Bl -tag -compact -width diskimage/
|
|
. It Pa sets/
|
|
\*m binary distribution sets;
|
|
see below.
|
|
. It Pa security/
|
|
\*m security distribution; see below.
|
|
. El
|
|
. It Pa installation/
|
|
.\" BTW, .Bl ... .El is not allowed unless there is at least one .It.
|
|
.
|
|
.\"============================================ ALPHA INSTALLATION SUBTREE
|
|
.
|
|
.Bl -tag -compact -width diskimage/
|
|
. It Pa floppy/
|
|
\*m boot and installation floppies; see below.
|
|
. It Pa diskimage/
|
|
. It Pa tapeimage/
|
|
.No \&an image file Pa cdhdtape
|
|
is included for the case where the installer is written to
|
|
a CD, hard drive, or tape.
|
|
This image file is the same for the CD, HD, and tape cases,
|
|
.No but a separate Pa tapeimage/
|
|
directory exists to hold a copy of the
|
|
.Tn README No file and to meet the
|
|
.Nx
|
|
.Xr release 7
|
|
standard.
|
|
. It Pa instkernel/
|
|
.No contains a Pa netbsd.gz
|
|
installation kernel; this is the same installer kernel as in all the
|
|
other install
|
|
images, but without the various boot program and filesystem wrappers.
|
|
It can be netbooted or diskbooted from a previous installation. Note: there is
|
|
no need to ungzip this image.
|
|
|
|
. It Pa misc/
|
|
contains
|
|
.Pa GENERIC.fs ,
|
|
.No a Tn GENERIC
|
|
kernel in a bootable filesystem image. This is used in some unusual
|
|
installations as described in the next section.
|
|
.El
|
|
.
|
|
.
|
|
.El
|
|
.
|
|
.
|
|
.
|
|
.Ss2 Bootable installation/upgrade floppies:
|
|
.Pp
|
|
There are three bootable images in the
|
|
.Nx
|
|
\*m distribution.
|
|
One is for a dual-floppy boot and is split into two separate files.
|
|
The other is a single-file image containing the same install kernel,
|
|
but intended to be written to a CD, tape, or hard drive. The third
|
|
image is a
|
|
.Tn GENERIC
|
|
kernel intended for production use in unusual cases.
|
|
This can be useful at some sites when:
|
|
.Bl -bullet
|
|
.It
|
|
You want to run diskless but SRM bugs prevent the firmware from
|
|
netbooting. You can work around this problem by always booting the generic
|
|
kernel from the floppy.
|
|
.It
|
|
SRM doesn't recognize your (hard) disk controller but
|
|
.Nx
|
|
does. This
|
|
happens more frequently than you might think. SRM will usually only boot
|
|
from
|
|
.Xr ncr 4
|
|
or
|
|
.Xr isp 4
|
|
SCSI devices, and on most platforms will not
|
|
boot from an IDE drive.
|
|
.Nx
|
|
will happily operate
|
|
with almost any SCSI root or an IDE root; the solution here is to netboot
|
|
a kernel or always boot from floppy.
|
|
.El
|
|
.
|
|
.
|
|
.Ss2 Binary Distribution Sets
|
|
The
|
|
.Nx
|
|
\*m
|
|
binary distribution sets contain the binaries which
|
|
comprise the
|
|
.Nx \*V
|
|
release for the \*m. There are eight binary distribution
|
|
.ie r_pc532 sets.
|
|
.el .No sets and the Em security No distribution set.
|
|
The binary distribution sets can be found in the
|
|
.Pa \*m/binary/sets
|
|
subdirectory
|
|
of the
|
|
.Nx \*V
|
|
distribution tree, and are as follows:
|
|
.Bl -tag -width mmmmmmmmmmm -compact
|
|
.Pp
|
|
.It Sy base
|
|
The
|
|
.Nx \*V
|
|
.No \*m Sy base No binary distribution. You
|
|
.Em must
|
|
install this distribution set. It contains the base
|
|
.Nx
|
|
utilities that are necessary for the
|
|
system to run and be minimally functional. It
|
|
includes shared library support, and excludes
|
|
everything described below.
|
|
.br
|
|
.if r_alpha .Em 14.5M gzipped, 38.9M uncompressed
|
|
.if r_amiga .Em 10.3M gzipped, 28.9M uncompressed
|
|
.if r_arm32 .Em 13.1M gzipped, 33.5M uncompressed
|
|
.if r_atari .Em 10.3M gzipped, 29.0M uncompressed
|
|
.if r_i386 .Em 11.2M gzipped, 28.2M uncompressed
|
|
.if r_mac68k .Em 10.2M gzipped, 28.9M uncompressed
|
|
.if r_macppc .Em 11.1M gzipped, 30.5M uncompressed
|
|
.if r_next68k .Em 12.9M gzipped, 40.1M uncompressed
|
|
.if r_pc532 .Em 10.4M gzipped, 26.2M uncompressed
|
|
.if r_pmax .Em 12.8M gzipped, 40.6M uncompressed
|
|
.if r_sparc .Em 11.9M gzipped, 33.4M uncompressed
|
|
.if r_vax .Em 10.1M gzipped, 24.8M uncompressed
|
|
.if r_x68k .Em 10.2M gzipped, 28.8M uncompressed
|
|
.Pp
|
|
.It Sy comp
|
|
Things needed for compiling programs. This set
|
|
includes the system include files
|
|
.Pq Pa /usr/include
|
|
and the various system libraries (except the shared
|
|
libraries, which are included as part of the
|
|
.Sy 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.
|
|
.br
|
|
.if r_alpha .Em 11.6M gzipped, 48.7M uncompressed
|
|
.if r_amiga .Em 8.3M gzipped, 28.5M uncompressed
|
|
.if r_arm32 .Em 9.2M gzipped, 30.5M uncompressed
|
|
.if r_atari .Em 8.1M gzipped, 27.2M uncompressed
|
|
.if r_i386 .Em 8.7M gzipped, 28.2M uncompressed
|
|
.if r_mac68k .Em 8.1M gzipped, 26.6M uncompressed
|
|
.if r_macppc .Em 8.5M gzipped, 32.3M uncompressed
|
|
.if r_next68k .Em 13M gzipped, 50M uncompressed
|
|
.if r_pc532 .Em 8.3M gzipped, 27.5M uncompressed
|
|
.if r_pmax .Em 11.3M gzipped, 48.7M uncompressed
|
|
.if r_sparc .Em 9.6M gzipped, 31.8M uncompressed
|
|
.if r_vax .Em 8.1M gzipped, 27.3M uncompressed
|
|
.if r_x68k .Em 8.1M gzipped, 27.3M uncompressed
|
|
.Pp
|
|
.It Sy etc
|
|
This distribution set contains the system
|
|
configuration files that reside in
|
|
.Pa /etc
|
|
and in several other places. This set
|
|
.Em must
|
|
be installed if you are installing the system from scratch, but should
|
|
.Em not
|
|
be used if you are upgrading. (If you are upgrading,
|
|
it's recommended that you get a copy of this set and
|
|
.Em carefully
|
|
upgrade your configuration files by hand.)
|
|
.br
|
|
.if r_alpha .Em 56K gzipped, 330K uncompressed
|
|
.if r_amiga .Em 57K gzipped, 330K uncompressed
|
|
.if r_arm32 .Em 57K gzipped, 330K uncompressed
|
|
.if r_atari .Em 56K gzipped, 330K uncompressed
|
|
.if r_i386 .Em 57K gzipped, 340K uncompressed
|
|
.if r_mac68k .Em 57K gzipped, 319K uncompressed
|
|
.if r_macppc .Em 56K gzipped, 330K uncompressed
|
|
.if r_next68k .Em 56K gzipped, 330K uncompressed
|
|
.if r_pc532 .Em 56K gzipped, 330K uncompressed
|
|
.if r_pmax .Em 58K gzipped, 340K uncompressed
|
|
.if r_sparc .Em 60K gzipped, 350K uncompressed
|
|
.if r_vax .Em 60K gzipped, 350K uncompressed
|
|
.if r_x68k .Em 57K gzipped, 340K uncompressed
|
|
.Pp
|
|
.It Sy games
|
|
This set includes the games and their manual pages.
|
|
.br
|
|
.if r_alpha .Em 3M gzipped, 7.4M uncompressed
|
|
.if r_amiga .Em 2.8M gzipped, 7.1M uncompressed
|
|
.if r_arm32 .Em 2.9M gzipped, 7.1M uncompressed
|
|
.if r_atari .Em 2.8M gzipped, 7M uncompressed
|
|
.if r_i386 .Em 2.8M gzipped, 6.9M uncompressed
|
|
.if r_mac68k .Em 2.8M gzipped, 7.1M uncompressed
|
|
.if r_macppc .Em 2.8M gzipped, 6.9M uncompressed
|
|
.if r_next68k .Em 2.8M gzipped, 7M uncompressed
|
|
.if r_pc532 .Em 2.8M gzipped, 6.8M uncompressed
|
|
.if r_pmax .Em 2.9M gzipped, 7.7M uncompressed
|
|
.if r_sparc .Em 2.9M gzipped, 7.3M uncompressed
|
|
.if r_vax .Em 2.8M gzipped, 6.8M uncompressed
|
|
.if r_x68k .Em 2.8M gzipped, 7M uncompressed
|
|
.
|
|
.\" garden variety kern set description
|
|
.
|
|
.if !\n[arm32]:\n[atari]:\n[mac68k]:\n[sun3] \{\
|
|
.Pp
|
|
.It Sy kern
|
|
This set contains a NetBSD/\*m \*V
|
|
.Tn GENERIC No kernel, named Pa /netbsd .
|
|
.No You Em must
|
|
install this distribution set.
|
|
.br
|
|
.if r_alpha .Em 1.3M gzipped, 3M uncompressed
|
|
.if r_amiga .Em 894k gzipped, 1.9M uncompressed
|
|
.if r_arm32 .Em 857k gzipped, 1.8M uncompressed
|
|
.if r_i386 .Em 1.5M gzipped, 3M uncompressed
|
|
.if r_macppc .Em 846k gzipped, 1.9M uncompressed
|
|
.if r_next68k .Em 532k gzipped, 1.1M uncompressed
|
|
.if r_pc532 .Em 457k gzipped, 910k uncompressed
|
|
.if r_pmax .Em 792k gzipped, 2.1M uncompressed
|
|
.if r_sparc .Em 2.9M gzipped, 6.7M uncompressed
|
|
.if r_vax .Em 517k gzipped, 1M uncompressed
|
|
.if r_x68k .Em 627k gzipped, 1.4M uncompressed
|
|
.\}
|
|
.Pp
|
|
.It Sy man
|
|
This set includes all of the manual pages for the
|
|
binaries and other software contained in the
|
|
.Sy base
|
|
set.
|
|
Note that it does not include any of the manual pages
|
|
that are included in the other sets.
|
|
.br
|
|
.\" Contrary to popular belief, these aren't MI yet....
|
|
.\" .Em 4.0M gzipped, 15.9M uncompressed
|
|
.if r_alpha .Em 4M gzipped, 15.9M uncompressed
|
|
.if r_amiga .Em 4.2M gzipped, 17M uncompressed
|
|
.if r_arm32 .Em 4M gzipped, 15.9M uncompressed
|
|
.if r_atari .Em 4M gzipped, 15.9M uncompressed
|
|
.if r_i386 .Em 4M gzipped, 16.2M uncompressed
|
|
.if r_macppc .Em 3.8M gzipped, 15.2M uncompressed
|
|
.if r_next68k .Em 3.9M gzipped, 15.6M uncompressed
|
|
.if r_pc532 .Em 4.1M gzipped, 16.8M uncompressed
|
|
.if r_pmax .Em 4M gzipped, 15.9M uncompressed
|
|
.if r_sparc .Em 4M gzipped, 16.0M uncompressed
|
|
.if r_vax .Em 4.2M gzipped, 17.2M uncompressed
|
|
.if r_x68k .Em 4M gzipped, 15.9M uncompressed
|
|
.Pp
|
|
.It Sy misc
|
|
This set includes the (rather large) system dictionaries,
|
|
the typesettable document set, and other files from
|
|
.Pa /usr/share .
|
|
.br
|
|
.\" Contrary to popular belief, these aren't (quite!) MI yet....
|
|
.\" .Em 2.1M gzipped, 8.5M uncompressed
|
|
.if r_alpha .Em 2.2M gzipped, 8.5M uncompressed
|
|
.if r_amiga .Em 2.2M gzipped, 8.4M uncompressed
|
|
.if r_arm32 .Em 2.2M gzipped, 8.4M uncompressed
|
|
.if r_atari .Em 2.2M gzipped, 8.4M uncompressed
|
|
.if r_i386 .Em 2.1M gzipped, 8.1M uncompressed
|
|
.if r_macppc .Em 2.2M gzipped, 8.5M uncompressed
|
|
.if r_next68k .Em 2.2M gzipped, 8.5M uncompressed
|
|
.if r_pc532 .Em 2.2M gzipped, 8.5M uncompressed
|
|
.if r_pmax .Em 2.2M gzipped, 8.5M uncompressed
|
|
.if r_sparc .Em 2.2M gzipped, 8.4M uncompressed
|
|
.if r_vax .Em 2.1M gzipped, 8.1M uncompressed
|
|
.if r_x68k .Em 2.2M gzipped, 8.4M uncompressed
|
|
.Pp
|
|
.It Sy text
|
|
This set includes NetBSD's text processing tools,
|
|
including
|
|
.Xr groff 1 ,
|
|
all related programs, and their manual pages.
|
|
.br
|
|
.if r_alpha .Em 1.3M gzipped, 4.9M uncompressed
|
|
.if r_amiga .Em 1.3M gzipped, 4.6M uncompressed
|
|
.if r_arm32 .Em 1.3M gzipped, 4.6M uncompressed
|
|
.if r_atari .Em 1.3M gzipped, 4.5M uncompressed
|
|
.if r_i386 .Em 1.3M gzipped, 4.4M uncompressed
|
|
.if r_mac68k .Em 1M gzipped, 4M uncompressed
|
|
.if r_macppc .Em 1.2M gzipped, 4.4M uncompressed
|
|
.if r_next68k .Em 1.3M gzipped, 4.5M uncompressed
|
|
.if r_pc532 .Em 1.3M gzipped, 4.4M uncompressed
|
|
.if r_pmax .Em 1.3M gzipped, 5.1M uncompressed
|
|
.if r_sparc .Em 1.4M gzipped, 4.8M uncompressed
|
|
.if r_vax .Em 1.2M gzipped, 4.3M uncompressed
|
|
.if r_x68k .Em 1.3M gzipped, 4.5M uncompressed
|
|
.El
|
|
.
|
|
.
|
|
.Pp
|
|
The \*m security distribution set is named
|
|
.Sy secr No and can be found in the
|
|
.D1 Pa \*m/binary/security
|
|
subdirectory of the
|
|
.Nx \*V
|
|
distribution tree. It contains security-related binaries
|
|
which depend on cryptographic source code. You do not need this
|
|
distribution set to use encrypted passwords in your password file; the
|
|
.Sy base
|
|
distribution includes a crypt library which can perform
|
|
only the one-way encryption function. The security distribution
|
|
includes a version of the Kerberos IV network security system, and
|
|
a Kerberized version of
|
|
.Xr telnet 1
|
|
.No program. The Sy secr
|
|
distribution set can be found only on those sites which carry the complete
|
|
.Nx
|
|
distribution and which can legally obtain it. Because
|
|
of United States law, it may not be legal to distribute this set
|
|
to locations outside of the United States and Canada.
|
|
.br
|
|
.if r_alpha .Em 1M gzipped, 3M uncompressed
|
|
.if r_i386 . Em 798K gzipped, 2.4M uncompressed
|
|
.
|
|
.
|
|
.Pp
|
|
.Nx
|
|
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.3.1.
|
|
Binary sets for the X Window system are distributed with
|
|
.Nx .
|
|
The sets are:
|
|
.Bl -tag -width xcontribmmm
|
|
.It Sy xbase
|
|
The basic files needed for a complete X
|
|
client environment. This does not include
|
|
the X servers.
|
|
.br
|
|
.if r_alpha .Em 3.4M gzipped 12.9M uncompressed
|
|
.if r_amiga .Em 2.4M gzipped 7.7M uncompressed
|
|
.if r_arm32 .Em 2.9M gzipped 8.6M uncompressed
|
|
.if r_atari .Em 2.5M gzipped 7.9M uncompressed
|
|
.if r_hp300 .Em 2.5M gzipped, 7.6M uncompressed
|
|
.if r_i386 .Em 2.6M gzipped, 7.8M uncompressed
|
|
.if r_mac68k .Em 2.4M gzipped, 7.7M uncompressed
|
|
.if r_macppc .Em 2.8M gzipped, 8.3M uncompressed
|
|
.if r_pmax .Em 3.1M gzipped, 11M uncompressed
|
|
.if r_sparc .Em 2.7M gzipped, 8.6M uncompressed
|
|
.if r_x68k .Em 2.4M gzippeed, 7.7M uncompressed
|
|
.It Sy xcomp
|
|
The extra libraries and include files needed to compile X source code.
|
|
.br
|
|
.if r_alpha .Em 2.4M gzipped, 13.1M uncompressed
|
|
.if r_amiga .Em 1.6M gzipped, 6.8M uncompressed
|
|
.if r_arm32 .Em 1.9M gzipped, 7.7M uncompressed
|
|
.if r_atari .Em 1.6M gzipped, 6.8M uncompressed
|
|
.if r_hp300 .Em 1.7M gzipped, 7.1M uncompressed
|
|
.if r_i386 .Em 1.7M gzipped, 7M uncompressed
|
|
.if r_mac68k .Em 1.6M gzipped, 6.4M uncompressed
|
|
.if r_macppc .Em 1.9M gzipped, 8.2M uncompressed
|
|
.if r_pmax .Em 2.1M gzipped, 9.8M uncompressed
|
|
.if r_sparc .Em 1.7M gzipped, 7.4M uncompressed
|
|
.if r_x68k .Em 1.6M gzipped, 6.8M uncompressed
|
|
.It Sy xcontrib
|
|
Programs that were contributed to X.
|
|
.br
|
|
.if r_alpha .Em 228k gzipped, 820k uncompressed
|
|
.if r_amiga .Em 179k gzipped, 670k uncompressed
|
|
.if r_arm32 .Em 202k gzipped, 660k uncompressed
|
|
.if r_atari .Em 179k gzipped, 670k uncompressed
|
|
.if r_hp300 .Em 183k gzipped, 686k uncompressed
|
|
.if r_i386 .Em 184k gzipped, 600k uncompressed
|
|
.if r_mac68k .Em 178k gzipped, 664k uncompressed
|
|
.if r_macppc .Em 188k gzipped, 580k uncompressed
|
|
.if r_pmax .Em 206k gzipped, 770k uncompressed
|
|
.if r_sparc .Em 205k gzipped, 750k uncompressed
|
|
.if r_x68k .Em 179k gzipped, 670k uncompressed
|
|
.It Sy xfont
|
|
Fonts needed by X.
|
|
.br
|
|
.\" Contrary to popular belief, these aren't MI yet....
|
|
.\" .Em 5.5M gzipped, 6.8M uncompressed
|
|
.if r_alpha .Em 5.8M gzipped, 6.8M uncompressed
|
|
.if r_amiga .Em 5.7M gzipped, 7.0M uncompressed
|
|
.if r_arm32 .Em 5.7M gzipped, 7.0M uncompressed
|
|
.if r_atari .Em 5.7M gzipped, 7.0M uncompressed
|
|
.if r_i386 .Em 5.9M gzipped, 7.1M uncompressed
|
|
.if r_macppc .Em 5.7M gzipped, 7.0M uncompressed
|
|
.if r_pmax .Em 5.5M gzipped, 6.7M uncompressed
|
|
.if r_sparc .Em 5.7M gzipped, 7.0M uncompressed
|
|
.if r_x68k .Em 5.7M gzipped, 7.0M uncompressed
|
|
.
|
|
.El
|
|
.
|
|
.\"============================ MI DISCUSSION OF BINARY SETS
|
|
.
|
|
.Pp
|
|
The \*m binary distribution sets are distributed as gzipped tar files
|
|
named with the extension
|
|
.Sy .tgz , No e.g.
|
|
.Pa base.tgz .
|
|
.
|
|
.
|
|
.\" contrary to most old INSTALL docs, only i386 has Split/ sets
|
|
.
|
|
.
|
|
.Pp
|
|
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
|
|
.Em 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
|
|
.Ic tar xfp
|
|
command from /.
|