Final round of INSTALL cleanups for 5.0.
This commit is contained in:
snj
parent
79a49ca39e
commit
54a18014ee
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: hardware,v 1.16 2009/04/25 10:34:42 snj Exp $
|
||||
.\" $NetBSD: hardware,v 1.17 2009/04/25 21:21:47 snj Exp $
|
||||
.
|
||||
.Nx*M
|
||||
\*V runs on most of the
|
||||
|
|
@ -23,12 +23,12 @@ only one type of console loaded at any one time.
|
|||
If your system comes up with the ARC firmware, it may be possible
|
||||
to switch it to SRM with a menu or
|
||||
to download SRM from
|
||||
.Lk ftp://gatekeeper.dec.com/pub/Digital/Alpha/firmware/index.html .
|
||||
.Lk ftp://gatekeeper.dec.com/pub/Digital/Alpha/firmware/index.html
|
||||
You may want to buy a firmware update CD from Compaq Computer Corporation.
|
||||
.Pp
|
||||
More information on supported platforms and devices can be found on the
|
||||
\*M port web pages at
|
||||
.Lk http://www.NetBSD.org/ .
|
||||
.Lk http://www.NetBSD.org/
|
||||
.Pp
|
||||
A basic system will fit on a 200 MB disk (including swap) without too
|
||||
much difficulty, but you will probably want at least 500 MB of disk
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: install,v 1.36 2009/04/25 10:34:42 snj Exp $
|
||||
.\" $NetBSD: install,v 1.37 2009/04/25 21:21:47 snj Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
|
||||
.\" All rights reserved.
|
||||
|
|
@ -238,7 +238,7 @@ Make sure you put a kernel there as well, and create the device nodes in
|
|||
with
|
||||
.Ic sh ./MAKEDEV all .
|
||||
Detailed instructions on netbooting can be found by visiting
|
||||
.Lk http://www.NetBSD.org/docs/network/netboot/ .
|
||||
.Lk http://www.NetBSD.org/docs/network/netboot/
|
||||
.Pp
|
||||
You'll want to map root to
|
||||
.Li root
|
||||
|
|
|
|||
|
|
@ -1,2 +1,15 @@
|
|||
.\"$NetBSD: prep,v 1.1 2005/08/21 18:35:26 riz Exp $
|
||||
.\"$NetBSD: prep,v 1.2 2009/04/25 21:21:48 snj Exp $
|
||||
.
|
||||
.Pp
|
||||
It is strongly recommended that as part of the installation procedure, you
|
||||
upgrade your system's BIOS to the latest version available from your system
|
||||
vendor.
|
||||
Later BIOSes often contain workarounds for CPU and chipset bugs,
|
||||
workarounds that cannot be provided by the operating system.
|
||||
.Pp
|
||||
In the past, bugs fixed this way have been known to cause unpredictable
|
||||
behaviour and frequent system crashes with
|
||||
.Nx
|
||||
and other
|
||||
.Ul
|
||||
operating systems on x86 hardware.
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: contents,v 1.154 2009/04/25 10:34:43 snj Exp $
|
||||
.\" $NetBSD: contents,v 1.155 2009/04/25 21:21:48 snj Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
|
||||
.\" All rights reserved.
|
||||
|
|
@ -34,7 +34,7 @@ subdirectory of the distribution:
|
|||
.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
|
||||
It contains the following files and directories:
|
||||
.Pp
|
||||
.(tag INSTALL.html -compact
|
||||
.(tag INSTALL.html -compact \" top level
|
||||
. It Pa INSTALL.html
|
||||
. It Pa INSTALL.ps
|
||||
. It Pa INSTALL.txt
|
||||
|
|
@ -46,9 +46,9 @@ file contains underlined text using the
|
|||
.Xr more 1
|
||||
conventions for indicating italic and bold display.
|
||||
. It Pa binary/
|
||||
. (tag kernel/ -compact
|
||||
. (tag kernel/ -compact \" binary/
|
||||
. It Pa kernel/
|
||||
. (tag netbsd.gz -compact
|
||||
. (tag netbsd.gz -compact \" binary/kernel
|
||||
.if !\n[atari]:\n[mac68k]:\n[sgimips]:\n[evbppc] \{\
|
||||
. It Pa netbsd-GENERIC.gz
|
||||
A gzipped
|
||||
|
|
@ -231,14 +231,14 @@ It also includes a RAM-disk installer with
|
|||
Same as the above, but in the format expected by the firmware.
|
||||
.\}
|
||||
.
|
||||
. tag)
|
||||
. tag) \" binary/kernel/
|
||||
. It Pa sets/
|
||||
\*M binary distribution sets;
|
||||
see below.
|
||||
. tag)
|
||||
. tag) \" binary/
|
||||
. It Pa installation/
|
||||
.
|
||||
. (tag kernel/ -compact
|
||||
. (tag miniroot/ -compact \" installation/
|
||||
.
|
||||
.if \n[i386]:\n[amd64] \{\
|
||||
. It Pa cdrom/
|
||||
|
|
@ -363,9 +363,9 @@ Two programs needed to boot \*M kernels over the network.
|
|||
Tape boot programs, and a RAMDISK kernel.
|
||||
.\}
|
||||
.
|
||||
. tag)
|
||||
. tag) \" installation/
|
||||
.
|
||||
.tag)
|
||||
.tag) \" top level
|
||||
.
|
||||
.
|
||||
.if \n[alpha] \{\
|
||||
|
|
@ -469,7 +469,7 @@ procedure, not the sparc instructions.
|
|||
Most people will want the 64-bit \*M distribution tree:
|
||||
.\}
|
||||
.el distribution tree, and are as follows:
|
||||
.(tag xserver
|
||||
.(tag xserver \" sets
|
||||
.
|
||||
.It Sy base
|
||||
The
|
||||
|
|
@ -1048,7 +1048,7 @@ all related programs, and their manual pages.
|
|||
.if \n[x68k] .setsize 3 10
|
||||
.showsize
|
||||
.
|
||||
.tag)
|
||||
.tag) \" sets
|
||||
.
|
||||
.
|
||||
.\" ---------------------------- X SETS
|
||||
|
|
@ -1071,7 +1071,7 @@ XFree86 4.5.0.
|
|||
Binary sets for the X Window System are distributed with
|
||||
.Nx .
|
||||
The sets are:
|
||||
.(tag xserver
|
||||
.(tag xserver \" x sets
|
||||
.
|
||||
.It Sy xbase
|
||||
The basic files needed for a complete X
|
||||
|
|
@ -1269,6 +1269,7 @@ This includes the Xpmax server with man page.
|
|||
.\}
|
||||
.if \n[shark] \{\
|
||||
This includes the modular Xorg and Xvfb servers.
|
||||
.\}
|
||||
.if \n[sparc] \{\
|
||||
This includes Xsun, Xsun24, XsunMono and Xvfb servers with man pages.
|
||||
.\}
|
||||
|
|
@ -1331,7 +1332,7 @@ servers with man pages and the runtime configuration file.
|
|||
.if \n[x68k] .setsize 4 11
|
||||
.showsize
|
||||
.
|
||||
.tag)
|
||||
.tag) \" x sets
|
||||
.
|
||||
.\} \" !\n[sun2]
|
||||
.
|
||||
|
|
@ -1405,7 +1406,7 @@ There are gzipped versions of each available, for easier downloading.
|
|||
(The gzipped versions have the
|
||||
.Pa \&.gz
|
||||
extension added to their names.)
|
||||
.(tag indent
|
||||
.(tag indent \" atari
|
||||
.It Em Bootable\ Kernel\ floppies
|
||||
These
|
||||
.Tn TOS
|
||||
|
|
@ -1459,7 +1460,7 @@ and
|
|||
.Pa miniroot.fs.2 .
|
||||
There is also an image for an 1.44 MB disk:
|
||||
.Pa miniroot.fs .
|
||||
.tag)
|
||||
.tag) \" atari
|
||||
.Pp
|
||||
There are also
|
||||
.Tn TOS
|
||||
|
|
@ -1810,7 +1811,7 @@ to it and make the disk bootable.
|
|||
This must be the third file written to the tape.
|
||||
. tag)
|
||||
.tag)
|
||||
.\}
|
||||
.\} \" \n[mvme68k]
|
||||
.
|
||||
.
|
||||
.if \n[sgimips] \{\
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: main,v 1.445 2009/04/25 10:34:43 snj Exp $
|
||||
.\" $NetBSD: main,v 1.446 2009/04/25 21:21:48 snj Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1999-2008 The NetBSD Foundation, Inc.
|
||||
.\" All rights reserved.
|
||||
|
|
@ -155,10 +155,9 @@ boot prompt.
|
|||
Type
|
||||
.Ic boot -2
|
||||
to boot with ACPI disabled.
|
||||
.\}
|
||||
.\} \" amd64:i386
|
||||
.if \n[macppc] \{\
|
||||
Fetch files necessary to boot your system.
|
||||
The files depend on what model you
|
||||
The files depend on which model you
|
||||
are using and how you plan to boot your machine.
|
||||
For systems with built-in floppy drives (Open Firmware 1 or 2),
|
||||
fetch the pair of boot floppy images
|
||||
|
|
@ -362,7 +361,7 @@ You will need to get to the
|
|||
.if \n[sparc64] OpenFirmware
|
||||
.Dq Ic "ok"
|
||||
prompt.
|
||||
After your system first powers on, and displays some initial information,
|
||||
After your system first powers on and displays some initial information,
|
||||
press the
|
||||
.Key STOP-A
|
||||
keys, or send a BREAK if you're on a serial console.
|
||||
|
|
@ -1513,7 +1512,7 @@ Converted to shared powerpc major numbers.
|
|||
.It
|
||||
sgimips:
|
||||
.(bullet
|
||||
Added support for SGI O2 PS/2 controller
|
||||
Added support for the SGI O2 PS/2 controller
|
||||
.Xr macekbc 4 ,
|
||||
onboard display adapter
|
||||
.Xr crmfb 4 ,
|
||||
|
|
@ -2063,6 +2062,21 @@ Workaround: generate a core file from the program using
|
|||
and pass the core to gdb, instead of debugging the running program.
|
||||
.Pp
|
||||
Statically linked binaries using pthreads are currently broken.
|
||||
.Pp
|
||||
Certain early revision AMD Opteron and Athlon 64 processors contain a bug
|
||||
that may cause system instability when running with more than one CPU core
|
||||
active.
|
||||
An OS-level workaround for this issue has been prepared but was not ready
|
||||
in time for inclusion in
|
||||
.Nx
|
||||
5.0.
|
||||
It will be available as part of a later release in the 5.0 series.
|
||||
.Pp
|
||||
Large filesystems
|
||||
.Pq over 2TB
|
||||
may sometimes falsely claim to be out of space.
|
||||
A fix for this is available, but was not made in time for 5.0.
|
||||
It will be available as part of a later release in the 5.0 series.
|
||||
.
|
||||
.\} \" \n[FOR_RELEASE]
|
||||
.
|
||||
|
|
@ -2117,14 +2131,14 @@ worldwide.
|
|||
More information on the
|
||||
.Nx
|
||||
Foundation, its composition, aims, and work can be found at:
|
||||
.Lk http://www.NetBSD.org/foundation/ .
|
||||
.Lk http://www.NetBSD.org/foundation/
|
||||
.br_ne 10P
|
||||
.
|
||||
.Ss "Sources of NetBSD"
|
||||
.Pp
|
||||
.
|
||||
Refer to
|
||||
.Lk http://www.NetBSD.org/mirrors/ .
|
||||
.Lk http://www.NetBSD.org/mirrors/
|
||||
.br_ne 10P
|
||||
.
|
||||
.Ss "NetBSD \*V Release Contents
|
||||
|
|
@ -2444,7 +2458,7 @@ A number of things were removed in the
|
|||
release, including: the evbsh5 port, the Fortran 77 compiler (g77), NETCCITT,
|
||||
NETNS, Sendmail, Sushi, UUCP, and Vinum. If you were using any of these,
|
||||
please see the "Components removed from NetBSD" at
|
||||
.Lk http://www.NetBSD.org/releases/formal-4/NetBSD-4.0.html#removals .
|
||||
.Lk http://www.NetBSD.org/releases/formal-4/NetBSD-4.0.html#removals
|
||||
.It
|
||||
The replacement of Sendmail by Postfix can be handled automatically by
|
||||
.Em postinstall
|
||||
|
|
@ -2648,13 +2662,14 @@ and fill in as much information about the problem as you can.
|
|||
Good bug reports include lots of details.
|
||||
.Pp
|
||||
Bugs also can be submitted and queried with the web interface at
|
||||
.Lk http://www.NetBSD.org/support/send-pr.html .
|
||||
.Lk http://www.NetBSD.org/support/send-pr.html
|
||||
.Pp
|
||||
There are also port-specific mailing lists, to discuss aspects of
|
||||
each port of
|
||||
.Nx .
|
||||
Use majordomo to find their addresses, or visit
|
||||
.Lk http://www.NetBSD.org/mailinglists/ .
|
||||
.Lk http://www.NetBSD.org/mailinglists/
|
||||
.Pp
|
||||
If
|
||||
you're interested in doing a serious amount of work on a specific
|
||||
port, you probably should contact the
|
||||
|
|
@ -2718,7 +2733,7 @@ We list the individuals and organizations
|
|||
that have made donations or loans of hardware and/or money, to support
|
||||
.Nx
|
||||
development, and deserve credit for it at
|
||||
.Lk http://www.NetBSD.org/donations/ .
|
||||
.Lk http://www.NetBSD.org/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.)
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: postinstall,v 1.73 2009/04/25 01:33:12 snj Exp $
|
||||
.\" $NetBSD: postinstall,v 1.74 2009/04/25 21:21:48 snj Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
|
||||
.\" All rights reserved.
|
||||
|
|
@ -397,7 +397,7 @@ for more information about NetBSD's release numbering scheme.
|
|||
.It
|
||||
The framework for compiling packages can be obtained by
|
||||
retrieving the file
|
||||
.Lk ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc.tar.gz .
|
||||
.Lk ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc.tar.gz
|
||||
It is typically extracted into
|
||||
.Pa /usr/pkgsrc
|
||||
(though other locations work fine) with the commands:
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: xfer,v 1.65 2009/04/25 10:34:43 snj Exp $
|
||||
.\" $NetBSD: xfer,v 1.66 2009/04/25 21:21:48 snj Exp $
|
||||
.\"
|
||||
.\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
|
||||
.\" All rights reserved.
|
||||
|
|
@ -229,7 +229,7 @@ diskless.
|
|||
No file transfer is needed, and all you have to do is to prepare files on
|
||||
the server.
|
||||
More information about diskless setups can be found at
|
||||
.Lk http://www.NetBSD.org/docs/network/netboot/ .
|
||||
.Lk http://www.NetBSD.org/docs/network/netboot/
|
||||
.Pp
|
||||
.if \n[ews4800mips] \{\
|
||||
The PROM uses the ordinary tftp protocol, so
|
||||
|
|
|
|||
|
|
@ -1,10 +1,11 @@
|
|||
.\" $NetBSD: prep,v 1.13 2002/06/29 22:45:30 lukem Exp $
|
||||
.\" $NetBSD: prep,v 1.14 2009/04/25 21:21:48 snj Exp $
|
||||
.
|
||||
First and foremost, before beginning the installation process,
|
||||
.Em make sure you have a reliable backup
|
||||
of any data on your hard disk that you
|
||||
wish to keep.
|
||||
Mistakes in partitioning your hard disk may lead to data loss.
|
||||
.so ../amd64/prep
|
||||
.Pp
|
||||
Before you begin, you should be aware of the geometry issues that may
|
||||
arise in relation to your hard disk.
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: prep,v 1.43 2009/04/23 01:56:49 snj Exp $
|
||||
.\" $NetBSD: prep,v 1.44 2009/04/25 21:21:49 snj Exp $
|
||||
.
|
||||
.Ss2 Prepare yourself
|
||||
.
|
||||
|
|
@ -51,7 +51,7 @@ stress this enough times).
|
|||
Spend about 15 minutes and read through this document from this point onward.
|
||||
There will be many pages of instructions that apply to Open Firmware versions
|
||||
that you do not have. Throw them out. Do not read them \(em at best you
|
||||
will be confused, at worst you may damage your system requiring repairs.
|
||||
will be confused, at worst you may damage your system, requiring repairs.
|
||||
.Pp
|
||||
.It
|
||||
Now create your bootable media and media for the distribution sets.
|
||||
|
|
@ -62,12 +62,12 @@ Prepare your machine, depending on the instructions for your model
|
|||
up a serial console).
|
||||
.Pp
|
||||
.It
|
||||
Boot into Open Firmware, and verify that it has the version of Open
|
||||
Boot into Open Firmware and verify that it has the version of Open
|
||||
Firmware you think it does.
|
||||
Also make sure that the other variables are set correctly.
|
||||
.Pp
|
||||
.It
|
||||
Figure out the correct boot command, and boot your machine from the
|
||||
Figure out the correct boot command and boot your machine from the
|
||||
bootable media you just created.
|
||||
If you're having trouble, be sure to read the section on
|
||||
.Sx "Common Problems and Error Messages"
|
||||
|
|
@ -80,7 +80,7 @@ whatever turns your fancy.
|
|||
.Pp
|
||||
.It
|
||||
Now use the installer to install the distribution sets onto your system
|
||||
and do some initial configurations.
|
||||
and do some initial configuration.
|
||||
.Pp
|
||||
.It
|
||||
Figure out how to boot from the installed partition.
|
||||
|
|
@ -109,7 +109,8 @@ it will make more sense.
|
|||
.(Note
|
||||
If the instructions in a subsection below do not apply to
|
||||
.Em all
|
||||
versions of Open Firmware, there will be a line listing which versions of
|
||||
versions of Open Firmware.
|
||||
There will be a line listing which versions of
|
||||
Open Firmware they apply to, such as:
|
||||
.br
|
||||
(Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x, Open
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: prep.OPENFIRMWARE,v 1.12 2009/04/23 01:56:49 snj Exp $
|
||||
.\" $NetBSD: prep.OPENFIRMWARE,v 1.13 2009/04/25 21:21:49 snj Exp $
|
||||
.if \*[OF_VERSION_3] \{\
|
||||
.
|
||||
.Ss2 Updating your BootROM
|
||||
|
|
@ -15,9 +15,9 @@ The BootROM is what is first executed when you power on or reset your system.
|
|||
The BootROM then loads Open Firmware, which boots your operating system.
|
||||
.Pp
|
||||
Go to the
|
||||
.Sq "Apple Software Downloads"
|
||||
.Sq "Apple Support Downloads"
|
||||
web site at
|
||||
.Lk http://www.info.apple.com/support/downloads.html
|
||||
.Lk http://support.apple.com/downloads/
|
||||
and search for
|
||||
.Sq firmware
|
||||
and install the most recent version for your model. For most G3 and G4
|
||||
|
|
@ -717,7 +717,7 @@ and MS-DOS FAT). Unfortunately, Open Firmware is
|
|||
able to directly boot from the
|
||||
.Nx
|
||||
file system (FFS) or Apple's
|
||||
.if \*[OF_VERSION_3] new BSD-based file system (UFS),
|
||||
.if \*[OF_VERSION_3] BSD-based file system (UFS),
|
||||
.if \*[OF_VERSION_12] file systems (HFS, HFS+, or UFS),
|
||||
so we must put the bootloader in a location that Open Firmware is capable
|
||||
of understanding.
|
||||
|
|
@ -890,13 +890,13 @@ In theory, Open Firmware 2.4 systems should be able to load the
|
|||
bootloader from an HFS or HFS+ partition or a hybrid CD-R, but users have
|
||||
reported that it doesn't work.
|
||||
.Pp
|
||||
The boot floppy images provided with the distribution sets have a
|
||||
The boot floppy images provided have a
|
||||
.Sq "partition zero"
|
||||
bootloader and a
|
||||
.Nx
|
||||
file system with an installation kernel.
|
||||
.\}
|
||||
The boot CD-R images provided with the distribution sets has both a
|
||||
The boot CD image provided has both a
|
||||
.Sq "partition zero"
|
||||
bootloader and
|
||||
.Pa ofwboot.xcf
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
.\" $NetBSD: xfer,v 1.3 2006/04/20 03:44:01 uwe Exp $
|
||||
.\" $NetBSD: xfer,v 1.4 2009/04/25 21:21:49 snj Exp $
|
||||
.
|
||||
.(tag instop
|
||||
.It Em "Domain-0 / privileged" installation
|
||||
|
|
@ -12,7 +12,7 @@ party packages in the
|
|||
installation notes).
|
||||
.It
|
||||
download the Xen binary from:
|
||||
.Lk ftp://ftp.NetBSD.org/pub/NetBSD/arch/xen/misc/xen-1.2-fixed.gz .
|
||||
.Lk ftp://ftp.NetBSD.org/pub/NetBSD/arch/xen/misc/xen-1.2-fixed.gz
|
||||
.It
|
||||
get a copy of the xen12load kernel loader from the
|
||||
.Nx \*V
|
||||
|
|
|
|||
Loading…
Reference in New Issue