Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/distrib/notes Add walnut installation notes.
details: https://anonhg.NetBSD.org/src/rev/09e6c03421f2
branches: trunk
changeset: 532837:09e6c03421f2
user: wiz <wiz%NetBSD.org@localhost>
date: Sun Jun 16 00:38:33 2002 +0000
description:
Add walnut installation notes.
Information to fill them mostly provided by eeh and simonb.
Fix some random buglets I stumbled over.
diffstat:
distrib/notes/Makefile | 3 +-
distrib/notes/common/contents | 42 ++++++++++++-
distrib/notes/common/main | 7 +-
distrib/notes/common/netboot | 94 ++++++++++++++++++++++++++-----
distrib/notes/common/sysinst | 45 ++++++--------
distrib/notes/common/xfer | 20 +++---
distrib/notes/walnut/Makefile | 5 +
distrib/notes/walnut/hardware | 126 ++++++++++++++++++++++++++++++++++++++++++
distrib/notes/walnut/install | 25 ++++++++
distrib/notes/walnut/legal | 25 ++++++++
distrib/notes/walnut/prep | 15 +++++
distrib/notes/walnut/upgrade | 5 +
distrib/notes/walnut/whatis | 4 +
distrib/notes/walnut/xfer | 3 +
14 files changed, 361 insertions(+), 58 deletions(-)
diffs (truncated from 851 to 300 lines):
diff -r 8a985d88b3d5 -r 09e6c03421f2 distrib/notes/Makefile
--- a/distrib/notes/Makefile Sun Jun 16 00:30:23 2002 +0000
+++ b/distrib/notes/Makefile Sun Jun 16 00:38:33 2002 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.27 2002/06/15 21:34:19 itojun Exp $
+# $NetBSD: Makefile,v 1.28 2002/06/16 00:38:33 wiz Exp $
#
TARGETS+= release
@@ -38,6 +38,7 @@
SUBDIR+= sun2
SUBDIR+= sun3
SUBDIR+= vax
+SUBDIR+= walnut
SUBDIR+= x68k
.endif
diff -r 8a985d88b3d5 -r 09e6c03421f2 distrib/notes/common/contents
--- a/distrib/notes/common/contents Sun Jun 16 00:30:23 2002 +0000
+++ b/distrib/notes/common/contents Sun Jun 16 00:38:33 2002 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: contents,v 1.59 2002/06/15 16:48:36 tsutsui Exp $
+.\" $NetBSD: contents,v 1.60 2002/06/16 00:38:33 wiz Exp $
.\"
.\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -53,7 +53,7 @@
. (tag kernel/ -compact
. It Pa kernel/
. (tag netbsd.gz -compact
-.if !r_atari \{\
+.if !\n[atari]:\n[walnut] \{\
. It Pa netbsd-GENERIC.gz
A gzipped
.Nx
@@ -175,6 +175,23 @@
GENERIC targeted for being bootable on Indigo 2 and similar machines.
.\}
.
+.if r_walnut \{\
+. It Pa netbsd-WALNUT.gz
+A gzipped
+.Nx
+kernel (in ELF format) containing code for everything supported
+in this release.
+. It Pa netbsd.img-WALNUT.gz
+Same as the above, but in the format expected by the firmware.
+. It Pa netbsd.INSTALL.gz
+A gzipped
+.Nx
+kernel (ELF format) containing code for everything supported in this
+release. It also includes a RAM-disk installer with sysinst.
+. It Pa netbsd.INSTALL.img.gz
+Same as the above, but in the format expected by the firmware.
+.\}
+.
. tag)
. It Pa sets/
\*M binary distribution sets;
@@ -219,7 +236,7 @@
\*M miniroot file system image; see below.
.\}
.
-.if !\n[mvme68k]:\n[macppc]:\n[sgimips] \{\
+.if !\n[mvme68k]:\n[macppc]:\n[sgimips]:\n[walnut] \{\
. It Pa misc/
.
.if r_alpha \{\
@@ -404,6 +421,7 @@
.if r_sun2 .Em 51.9 MB gzipped, 116.0 MB uncompressed
.if r_sun3 .Em 14.5 MB gzipped, 38.1 MB uncompressed
.if r_vax .Em 15.5 MB gzipped, 36.0 MB uncompressed
+.if r_walnut .Em 19.7 MB gzipped, ??.? MB uncompressed
.if r_x68k .Em 12.5 MB gzipped, 34.0 MB uncompressed
.
.It Sy comp
@@ -438,6 +456,7 @@
.if r_sun2 .Em 12.5 MB gzipped, 45.1 MB uncompressed
.if r_sun3 .Em 9.5 MB gzipped, 32.5 MB uncompressed
.if r_vax .Em 11.9 MB gzipped, 37.9 MB uncompressed
+.if r_walnut .Em 16.9 MB gzipped, ??.? MB uncompressed
.if r_x68k .Em 9.4 MB gzipped, 31.8 MB uncompressed
.
.It Sy etc
@@ -471,7 +490,7 @@
.if r_sun2 .Em 5.4 MB gzipped, 12.2 MB uncompressed
.if r_vax .Em 2.9 MB gzipped, 7.1 MB uncompressed
.
-.if !r_atari \{\
+.if !\n[atari]:\n[walnut] \{\
.It Sy kern-GENERIC
This set contains a
.Nx*M
@@ -512,6 +531,21 @@
install the kernel that matches your hardware.
.br
.\}
+.if r_walnut \{\
+.It Sy kern-WALNUT
+This set contains a
+.Nx*M
+\*V
+kernel in ELF format named
+.Pa /netbsd
+and the same kernel in the format needed by the bootloader as
+.Pa /netbsd.img .
+You
+.Em must
+install this distribution set.
+.br
+.Em 3.3 MB gzipped, 7.6 MB uncompressed
+.\}
.
.It Sy man
This set includes all of the manual pages for the
diff -r 8a985d88b3d5 -r 09e6c03421f2 distrib/notes/common/main
--- a/distrib/notes/common/main Sun Jun 16 00:30:23 2002 +0000
+++ b/distrib/notes/common/main Sun Jun 16 00:38:33 2002 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: main,v 1.185 2002/06/15 16:48:37 tsutsui Exp $
+.\" $NetBSD: main,v 1.186 2002/06/16 00:38:33 wiz Exp $
.\"
.\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -583,8 +583,9 @@
news68k,
newsmips,
sgimips,
+sparc64,
and
-sparc64.
+walnut.
.It
Improved performance and stability of the UVM virtual memory subsystem.
.It
@@ -1513,7 +1514,7 @@
.br_ne 2i
.It-span Em "Developers and other contributors:"
.It Ta Ta
-.It Ta Nathan Ahlstrom Ta Mt nra%NetBSD.org@localhost
+.It Ta Nathan Ahlstrom Ta Mt nra%netbsd.org@localhost
.It Ta Steve Allen Ta Mt wormey%netbsd.org@localhost
.It Ta Julian Assange Ta Mt proff%netbsd.org@localhost
.It Ta Lennart Augustsson Ta Mt augustss%netbsd.org@localhost
diff -r 8a985d88b3d5 -r 09e6c03421f2 distrib/notes/common/netboot
--- a/distrib/notes/common/netboot Sun Jun 16 00:30:23 2002 +0000
+++ b/distrib/notes/common/netboot Sun Jun 16 00:38:33 2002 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: netboot,v 1.7 2002/06/14 11:27:59 wiz Exp $
+.\" $NetBSD: netboot,v 1.8 2002/06/16 00:38:34 wiz Exp $
.\"
.\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -55,6 +55,7 @@
attached disk, or you may run your system entirely over the network.
.\}
.Pp
+.ie !\n[walnut] \{\
Briefly, the netboot
process involves discovery, bootstrap, kernel and filesystem stages.
In the first stage, the client discovers information
@@ -64,6 +65,14 @@
where the kernel is located.
The bootstrap program tries to mount the NFS share containing the kernel.
Once the kernel is loaded, it starts executing.
+.\}
+.el \{\
+Briefly, the netboot
+process involves discovery, kernel and filesystem stages.
+In the first stage, the client discovers information
+about where to find the kernel image.
+Once the kernel is loaded, it starts executing.
+.\}
.ie !\n[next68k] \{\
For RAM disk kernels, it mounts the RAM disk filesystem and begins
executing the installer from the RAM disk. For normal
@@ -80,7 +89,7 @@
daemon) for the first discovery stage and bootstrap download stages. The
bootstrap program uses DHCP for its discovery stage.
.\}
-.el .ie \n[macppc]:\n[next68k] \{\
+.el .ie \n[macppc]:\n[next68k]:\n[walnut] \{\
All \*M systems use BOOTP for the discovery stage.
.\}
.el .ie \n[sparc] \{\
@@ -88,21 +97,38 @@
In the past, these systems used RARP and BOOTPARAMS.
.\}
.if !\n[hp300] \{\
-TFTP is used in the bootstrap phase to download the bootstrap program,
+TFTP is used in the bootstrap phase to download
.ie \n[macppc] \{\
+the bootstrap program,
.Pa ofwboot.xcf .
.\}
.el .ie \n[next68k] \{\
+the bootstrap program,
.Pa boot .
.\}
.el .ie \n[sparc] \{\
+the bootstrap program,
.Pa boot.net ,
which has been linked to a file name appropriate to the client's
architecture and IP address as described in the TFTP section below.
.\}
+.el .ie \n[walnut] \{\
+the kernel via the on-board Ethernet card by the firmware.
+Thus,
+.Nx
+support for the on-board card is not needed in this step.
+For NFS mounting a filesystem on the other hand,
+.Nx
+support for the Ethernet card is needed, and the on-board one
+will not suffice; you have to provide a second Ethernet card
+supported by
+.Nx "" .
+.\}
.\} \" ! !\n[hp300]
+.if !\n[walnut] \{\
NFS is used in both the kernel and filesystem stages to download the
kernel, and to access files on the file server.
+.\} \" !\n[walnut]
.Pp
We will use
.Sq Li "CC:CC:CC:CC:CC:CC"
@@ -161,7 +187,7 @@
.Pp
.It
.\} \" ! \n[hp300]
-.if \n[hp300]:\n[macppc]:\n[next68k]:\n[sparc] \{\
+.if \n[hp300]:\n[macppc]:\n[next68k]:\n[sparc]:\n[walnut] \{\
.ie !\n[hp300] \{\
.Xr dhcpd 8
in
@@ -216,7 +242,17 @@
#
option host-name "client";
.if !\n[hp300] \{\
-.if !\n[sparc] \{\
+.ie \n[walnut] \{\
+
+ #
+ # Name of the kernel image to download via tftp.
+ # Note: Plain (ELF) kernels won't work, you
+ # have to use the corresponding *.img file.
+ #
+ filename "netbsd.INSTALL.img"
+.\}
+.el .if !\n[sparc] \{\
+
#
# Name of the bootloader or kernel
# to download via tftp.
@@ -224,16 +260,16 @@
.ie \n[macppc] \{\
filename "ofwboot.xcf";
.\}
-.el .ie \n[next68k] \{\
+.el .if \n[next68k] \{\
filename "boot";
-.\}
-.\}
-.\}
+.\} \" \n[next68k]
+.\} \" !\n[hp300]
#
# The path on the NFS server.
#
option root-path "/export/client/root";
.if \n[next68k] \{\
+
#
#next68k machines require non-RFC1048 BOOTP
#
@@ -264,7 +300,7 @@
.No # Ic "/etc/rc.d/dhcpd restart"
.disp)
.Pp
-.\} \" ! \n[hp300]:\n[macppc]:\n[next68k]:\n[sparc]
+.\} \" ! \n[hp300]:\n[macppc]:\n[next68k]:\n[sparc]:\n[walnut]
.if \n[sparc] \{\
.Pp
.It
@@ -304,7 +340,7 @@
.It
.Xr tftpd 8
.Pp
-The deafult configuration of the TFTP server is to run in a
+The default configuration of the TFTP server is to run in a
.Xr chroot 8
environment in the
.Pa /tftpboot
@@ -312,12 +348,14 @@
.(disp
.No # Ic "mkdir -p /tftpboot"
.disp)
+.Pp
Next, edit
.Pa /etc/inetd.conf
and uncomment the line with the TFTP daemon:
Home |
Main Index |
Thread Index |
Old Index