[src/netbsd-1-4]: src/distrib/notes/pmax pullup 1.5->1.6 (simonb)

[perry <perry%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c978479c0fec
branches:  netbsd-1-4
changeset: 468650:c978479c0fec
user:      perry <perry%NetBSD.org@localhost>
date:      Wed May 05 01:20:24 1999 +0000

description:
pullup 1.5->1.6 (simonb)

diffstat:

 distrib/notes/pmax/whatis |   78 ++++++++++++------------
 distrib/notes/pmax/xfer   |  142 +++++++++++++++++++++------------------------
 2 files changed, 105 insertions(+), 115 deletions(-)

diffs (266 lines):

diff -r ae685e79e21c -r c978479c0fec distrib/notes/pmax/whatis
--- a/distrib/notes/pmax/whatis Wed May 05 01:19:48 1999 +0000
+++ b/distrib/notes/pmax/whatis Wed May 05 01:20:24 1999 +0000
@@ -1,38 +1,40 @@
-       $NetBSD: whatis,v 1.5 1998/01/09 18:47:16 perry Exp $   
-
-This is the third public release of NetBSD for the DECstation and
-DECsystem family of computers.  
-
-This release includes support for either mips1 (r2000, r3000) and
-mips3 (r4000, r4400, r4600) CPUs. mips1 and mips3 support can be
-configured into a single kernel.  NetBSD 1.3 can be installed onto
-DECstation 5000/50, 5000/150, 5000/260, or 5900 models, as well as all
-previously-supported hardware.
-
-Though stable NetBSD/pmax snapshots with shared-library support have
-been available for over a year, this is the first full NetBSD/pmax
-release to ship with ELF shared libraries.  Much of the user-space
-support for this is due to work by Per Fogelstrom (pefo%OpenBSD.ORG@localhost)
-and ported to NetBSD by Manuel Bouyer.
-
-Ultrix emulation for Internet applications is improved over NetBSD
-1.2.  The Ultrix `ifconfig' command and multicast applications now
-work in Ultrix compatibility mode.  A ecoff-format NetBSD kernel in an
-Ultrix root filesystem should boot multi-user, though this is not
-recommended as an installation method.
-
-A bug in mips interrupt handling from 4.4BSD, which could cause
-`remrunque' panics under heavy load in both NetBSD prior to 1.2E and
-OpenBSD, is fixed in this release.
-
-There are yet more enhancements for the 4.4bsd-Lite/pmax SCSI drivers,
-which now correctly probes newer, faster, SCSI-2 disks, and handles
-large transfers (up to 64K) on 3100s.  Intermediate copies of disk I/O
-on IOASIC-based machines are eliminated, yielding a modest improvement
-on old disks like the rz25, and a bigger improvement on faster disks.
-
-Kernel performance tuning includes lower system call overhead, a
-faster bcopy() routine, faster IP checksumming code, and other
-imrprovemnts. These combine to show a dramatic (e.g., 1.5x-2.5x)
-improvement on microbenchmarks like the lmbench suite, and a modest
-improvement on larger benchmarks like kernel builds.
+.\"    $NetBSD: whatis,v 1.5.2.1 1999/05/05 01:20:24 perry Exp $       
+This is the fourth public major release of NetBSD for the DECstation
+and DECsystem family of computers.  Significantly, this is the first
+release for the pmax that builds completely from in-tree source code.
+Some other pmax-specific changes from the 1.3 release include:
+.Bl -bullet
+.It
+A much easier-to-use ramdisk-based install procedure.
+.It
+New two-stage disk bootblocks that can load a.out, ECOFF
+and ELF kernels.
+.It
+a.out kernels are no longer built.  ELF is the preferred format
+for kernels loaded off disk, and ECOFF kernels are still required
+for netbooting.  a.out kernels will still boot.
+.It
+Better support for SFB graphics cards running at
+different resolutions.
+.It
+NetBSD/pmax now uses the X11R6 Xserver.
+.It
+Mouse problems in X on 5000/xx machines have been significantly
+reduced.
+.It
+Some improvements in the SCSI driver for the 5000/200 (although
+some problems are still thought to exist).
+.It
+scc serial driver will work up to 115.2k bps on some
+systems.
+.It
+Reworked model-dependent code, including support for 5100 (but not
+recently tested on this machine).
+.It
+Crash dumps now work.
+.It
+Switched to in-tree ld.elf_so.
+.It
+Breakpoints in gdb work more reliably for R3000 systems (although
+there still may be some problems with R4X00 systems).
+.El
diff -r ae685e79e21c -r c978479c0fec distrib/notes/pmax/xfer
--- a/distrib/notes/pmax/xfer   Wed May 05 01:19:48 1999 +0000
+++ b/distrib/notes/pmax/xfer   Wed May 05 01:20:24 1999 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: xfer,v 1.5 1999/01/13 07:30:08 ross Exp $      
+.\"    $NetBSD: xfer,v 1.5.2.1 1999/05/05 01:20:51 perry Exp $ 
 .
 First-time installation on a bare machine is not supported, because most
 DECstations do not have any suitable load device. Some versions of
@@ -9,19 +9,17 @@
 and bootp; still other versions are buggy and do not boot via
 .Tn MOP .
 .Pp
-The only DECstation with a floppy-disk drive is the Personal Decstation,
+The only DECstation with a floppy-disk drive is the Personal DECstation,
 and that device is not supported as a boot device.
 .Pp
-The recommended installation procedure is to boot a miniroot via
+The recommended installation procedure is to boot an install kernel
+via
 .Tn TFTP ,
 or to use a
 .Dq helper
-system to write a miniroot onto a disk, move that
+system to write a miniroot diskimage onto a disk, move that
 disk to the target installation system, and then boot the miniroot.
 .Pp
-Once the miniroot is booted, a disklabel should be written.
-At that point, 
-.Pp
 Installation is supported from several media types, including:
 .Bl -bullet -compact
 .It
@@ -35,90 +33,80 @@
 .El
 .Pp
 The steps necessary to prepare the distribution sets
-for installation depend on which method of installation
-you choose.  The various methods are explained below.
-.
-.Ss2 To\ prepare\ for\ installing\ via\ an\ NFS\ partition:
-.
+for installation depend on which installation medium you choose.
+The steps for the various media are outlined below.
 .Pp
-Place the NetBSD software you wish to install into
-a directory on an NFS server, and make that directory
-mountable by the machine which you will be installing
-NetBSD on.  This will probably require modifying the
-/etc/exports file of the NFS server, and resetting
-mountd. Both these actions  will require superuser
-privileges on the NFS server.  Note the numeric IP address
-of the NFS server.   If the NFS server is not on a network
-which is directly attached to the NetBSD machine, you must
-also note the numeric address of the router closest to the the
-new NetBSD machine.
+.Bl -tag -width NFS\ Installation
+.
+.It Em NFS Installation
+Place the NetBSD distribution sets you wish to install into 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
+.Pa /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.
 .Pp
-If you are using a diskless setup to install NetBSD on
-your machine, you can take advantage of the fact that
-the above has already been done on your machine's server.
-So, you can conveniently put the NetBSD filesets in your
-machine's root filesystem on the server where the install
+You will need to know the IP address of your nameserver or of your 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 IP address of the closest router . Finally, you need to know the IP
+address of the NetBSD machine itself. The install program will ask you
+to provide this information to be able to access the sets via NFS.
+.Pp
+If you are using a diskless setup to install NetBSD on your machine,
+you can take advantage of the fact that the above has already been done
+on your machine's server.  So, you can conveniently put the NetBSD file
+sets in your machine's root filesystem on the server where the install
 program can find them.
 .Pp
-Once you have done this, you can proceed to the next
-step in the installation process, preparing your
-system for NetBSD installation.
+Once the NFS server is set up properly and you have the information
+mentioned above, you can start the actual installation process.
 .
-.Ss2 To\ prepare\ for\ installing\ via\ FTP:
+.It Em FTP Installation
+Determine an FTP site from which you can retrieve the NetBSD
+distribution when you're about to install. You will need to know the
+IP address of your nameserver or of your ftp 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 IP address of the closest
+router.  Finally, you need to know the IP address of the NetBSD machine
+itself. The install program will ask you to provide this information to
+be able to access the sets via ftp.
+.Pp
+Once you have this information, you can proceed to the actual
+installation.
 .
+.It Em Tape Installation
+To install NetBSD from a tape, you need to somehow get the NetBSD
+filesets you wish to install on your system on to the appropriate kind
+of tape, in tar format.
 .(Note
-this method of installation is recommended
-only for those already familiar with using
-the BSD network-manipulation commands and
-interfaces.  If you aren't, this documentation
-should help, but is not intended to be
-all-encompassing.
+the tape devices with which NetBSD/pmax is believed to work is the DEC
+TK-50. This is a very slow device.  Installation via disk or network is
+recommended if at all possible.
 .Note)
 .Pp
-The preparations for this method of installation
-are easy: all you have to do is make sure that
-there's some FTP site from which you can retrieve
-the NetBSD installation when it's time to do
-the install.  You should know the numeric IP
-address of that site, the numeric IP address of
-your nearest router if one is necessary
-.Pp
-Once you have done this, you can proceed to the next
-step in the installation process, preparing your
-system for NetBSD installation.
-.
-.Ss2 To\ prepare\ for\ installing\ via\ a\ tape:
-.
-To install NetBSD from a tape, you need to somehow
-get the NetBSD filesets you wish to install on
-your system on to the appropriate kind of tape,
-in tar format.
-.(Note
-the tape devices with which NetBSD/pmax is
-believed to work is the DEC TK-50. This is a very slow
-device.  Installation via disk or network is recommended
-if at all possible.
-.Note)
-.Pp
-If you're making the tape on a UN*X system, the easiest
-way to do so is:
+If you're making the tape on a UN*X system, the easiest way to do so is:
 .Dl tar cvf Ar tape_device files
 .No where Ar tape_device
-is the name of the tape device
-that describes the tape drive you're using (possibly
-something like
+is the name of the tape device that describes the tape drive you're
+using (possibly something like
 .Pa /dev/nrst0 ,
-but we make no guarantees 8-).
-Under SunOS 5.x, this would be something like
+but we make no guarantees 8-).  Under SunOS 5.x, this would be
+something like
 .Pa /dev/rmt/0mbn.
-Again, your mileage may vary.  If you can't figure it out,
-ask your system administrator.
+Again, your mileage may vary.  If you can't figure it out, ask your
+system administrator.
 .Ar files No are the names
 of the
 .Ar set_name.nnn
-files which you want to be placed
-on the tape.
+files which you want to be placed on the tape.
 .Pp
-Once you have done this, you can proceed to the next
-step in the installation process, preparing your 
-system for NetBSD installation.
+Once you have done this, you can proceed to the next step in the
+installation process, preparing your system for NetBSD installation.
+.
+.It Em CD-ROM Installation
+If you are installing from a CD-ROM, the distribution sets are
+already in the proper format and no special handling is required.
+.El