Subject: install/35169: Some install notes fixes
To: None <install-manager@netbsd.org, gnats-admin@netbsd.org,>
From: None <dieter.NetBSD@pandora.be>
List: netbsd-bugs
Date: 12/02/2006 18:15:00
>Number:         35169
>Category:       install
>Synopsis:       Some install notes fixes
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    install-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Dec 02 18:15:00 +0000 2006
>Originator:     dieter roelants
>Release:        NetBSD 4.0
>Organization:
>Environment:
>Description:
	- While reading install/12957 it was suggested
	(http://mail-index.netbsd.org/port-i386/2006/11/27/0000.html)
	that all notes, marked with '[PCMCIA]' should go and be
	replaced with a more generic explanation about removable
	devices.
	- I noticed the HTML output concatenates 'NetBSD' and '4.0',
	which is ugly.
	- The IP addresses for ftp.NetBSD.org are wrong.
>How-To-Repeat:
>Fix:
Index: common/main
===================================================================
RCS file: /cvsroot/src/distrib/notes/common/main,v
retrieving revision 1.320
diff -u -r1.320 main
--- common/main	29 Nov 2006 04:34:37 -0000	1.320
+++ common/main	2 Dec 2006 18:07:15 -0000
@@ -68,8 +68,8 @@
 .Pp
 .
 This document describes the installation procedure for
-.Nx \*V
-on the
+.Nx
+\*V on the
 .Em \*M
 platform.
 It is available in four different formats titled
@@ -109,8 +109,8 @@
 .Pp
 This section contains some brief notes describing what you need to
 install
-.Nx \*V
-on a machine of the \*M architecture.
+.Nx
+\*V on a machine of the \*M architecture.
 .Bl -bullet
 .It
 Fetch the
@@ -401,8 +401,8 @@
 across fifteen distinct CPU families,
 and is being ported to more.
 The
-.Nx \*V
-release contains complete binary releases for many different
+.Nx
+\*V release contains complete binary releases for many different
 system architectures.
 (A few ports are not fully supported at this time 
 and are thus not part of the binary distribution.
@@ -443,8 +443,8 @@
 .Pp
 It is impossible to completely summarize a year of development that
 went into the
-.Nx \*V
-release.
+.Nx
+\*V release.
 Some highlights include:
 .
 .Ss2 Kernel
@@ -611,8 +611,8 @@
 .Pp
 .
 The root directory of the
-.Nx \*V
-release is organized as follows:
+.Nx
+\*V release is organized as follows:
 .ie \n[FOR_RELEASE] \{\
 .Pp
 .Pa .../NetBSD-\*V/
@@ -625,8 +625,8 @@
 Last minute changes.
 .It Li MIRRORS
 A list of sites that mirror the
-.Nx \*V
-distribution.
+.Nx
+\*V distribution.
 .It Li README.files
 README describing the distribution's contents.
 .It Li TODO
@@ -640,8 +640,8 @@
 .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.
+.Nx
+\*V has a binary distribution.
 .Pp
 The source distribution sets can be found in subdirectories of the
 .Pa source
@@ -669,8 +669,8 @@
 .showsize 5 20
 .It Sy src
 This set contains all of the base
-.Nx \*V
-sources which are not in
+.Nx
+\*V sources which are not in
 .Sy gnusrc ,
 .Sy sharesrc ,
 or
@@ -678,8 +678,8 @@
 .showsize 37 176
 .It Sy syssrc
 This set contains the sources to the
-.Nx \*V
-kernel for all architectures;
+.Nx
+\*V kernel for all architectures;
 .Xr config 1 ;
 and
 .Xr dbsym 8 .
@@ -811,7 +811,8 @@
 .Nx
 may wish to bear the
 following problems and compatibility issues in mind when upgrading to
-.Nx \*V .
+.Nx
+\*V .
 .
 .Ss2 Issues affecting an upgrade from NetBSD 1.6
 The following issues can generally be resolved by extracting the
Index: common/sysinst
===================================================================
RCS file: /cvsroot/src/distrib/notes/common/sysinst,v
retrieving revision 1.77
diff -u -r1.77 sysinst
--- common/sysinst	25 Nov 2006 22:53:35 -0000	1.77
+++ common/sysinst	2 Dec 2006 18:07:15 -0000
@@ -33,14 +33,6 @@
 .\"
 .
 .
-.de (pcmcia
-.	Bl -tag -width x[PCMCIA]x
-.It [ Tn PCMCIA ]
-..
-.de pcmcia)
-.	El
-..
-.
 .
 .\" Define strings for partition references:
 .\"	\*[part_raw]	`raw' partition (usually `c' or `d')
@@ -95,197 +87,18 @@
 .
 .if !\n[acorn26]:\n[acorn32]\n[atari]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k] \{\
 .It
-.To 2 "Possible PCMCIA issues"
-.Em Possible Tn PCMCIA Em issues
-.Pp
-Machines with
-.Tn PCMCIA
-slots may have problems during installation.
-If you do not have
-.Tn PCMCIA
-on your machine
-.Tn ( PCMCIA
-is only really used on laptop machines),
-you can skip this section, and ignore the
-.Dq Bq Tn PCMCIA
-notes.
-If you do have
-.Tn PCMCIA
-in your machine, you can safely ignore this section and the
-.Dq Bq Tn PCMCIA
-the first time, as you are likely to not have problems.
-Should troubles
-occur during floppy boot, they may be
-.Tn PCMCIA
-specific.
-You should then re-read this section and try again,
-following the instructions in the
-.Dq Bq Tn PCMCIA
-notes.
-.Pp
-This section explains how to work around the installation problem.
-.Pp
-The kernel keeps careful track of what interrupts
-and I/O ports are in use during autoconfiguration.
-It then allows the
-.Tn PCMCIA
-devices to pick unused interrupts and I/O ports.
-Unfortunately, the
-.Tn Li INSTALL
-kernel may not detect all devices in your system.
-This may be because the
-.Tn Li INSTALL
-kernel only supports the minimum set of devices to install
-.Nx
-on your system, or it may be that
-.Nx
-does not have support for the device causing the conflict.
-.Pp
-For example, suppose your laptop has a
-soundblaster device built in; the
-.Tn Li INSTALL
-kernel has no sound support.
-The
-.Tn PCMCIA
-code might allocate your soundblaster's
-.Tn IRQ
-and I/O ports to
-.Tn PCMCIA
-devices, causing them not to work, or to lock up the system.
-This is especially bad if one of the devices in question is your ethernet card.
-.Pp
-The kernel attempts to probe for available interrupts that are
-usable by the
-.Tn PCIC
-.Tn ( PCMCIA
-interrupt controller), which 
-should alleviate interrupt conflicts;
-however, I/O port conflicts are still possible.
-.Pp
-This problem will impact some, but not all, users of
-.Tn PCMCIA .
-If this problem is affecting you, watch the
-.Dq Bq Tn PCMCIA
-notes that will appear in this document.
-.if \n[i386] \{\
-.Pp
-It can be difficult to distinguish an interrupt conflict from
-an I/O space conflict.
-There are no hard-and-fast rules, but
-interrupt conflicts are more likely to lock up the machine,
-and I/O space conflicts are more likely to result in misbehavior
-(e.g. a network card that cannot send or receive packets).
-.Pp
-The kernel selects a free interrupt according to a mask of allowable
-interrupts, stored in the kernel global variable
-.Va pcic_isa_intr_alloc_mask .
-This mask is a logical-or of power-of-2s of allowable interrupts:
-.(disp
-IRQ  Val     IRQ  Val     IRQ  Val      IRQ  Val
-  0  0x0001    4  0x0010    8  0x0100    12  0x1000
-  1  0x0002    5  0x0020    9  0x0200    13  0x2000
-  2  0x0004    6  0x0040   10  0x0400    14  0x4000
-  3  0x0008    7  0x0080   11  0x0800    15  0x8000
-.disp)
-.Pp
-For example, 0x0a00 allows both IRQ 9 and IRQ 11.
-By default, the
-.Tn Li INSTALL
-kernel permits all IRQs other than IRQs 5 and 7, so the corresponding
-mask is 0xff5f.
-The
-.Tn Li GENERIC
-kernel, however, allows all IRQs.
-(The presumption here is that IRQ 10 may be assigned to a device that the
-.Tn Li GENERIC
-kernel
-supports, but that the
-.Tn Li INSTALL
-does not.)
-Because of support for interrupt probing, it is no
-longer necessary to exclude IRQs 3 and 5 explicitly; if they are
-in use, they should not be assigned to
-.Tn PCMCIA .
-.Pp
-The kernel selects IO space by assigning cards IO space within a
-predefined range.
-The range is specified as a base and size,
-specified by the kernel global variables
-.Va pcic_isa_alloc_iobase
-and
-.Va pcic_isa_alloc_iosize .
-For systems with 12-bit addressing (most systems), the kernel defaults to a
-base of 0x400 and a size of 0xbff (a range of 0x400-0xfff).
-For systems with 10-bit addressing, the kernel defaults to a
-base of 0x300 and a size of 0xff (range of 0x300-0x3ff).
-.Pp
-Unfortunately, these ranges may conflict with some devices.
-In the event of a conflict, try a base of 0x330 with a size of 0x0bf (range
-of 0x330-0x3ff).
-.Pp
-In order to work around this at installation time, you may
-interrupt the 5 second countdown when booting the
-.Tn Li INSTALL
-kernel, and use
-.Ic boot Fl d ,
-in order to enter
-.Xr ddb 4
-(the in-kernel debugger), and then use the
-.Ic write
-command to alter the variable values:
-.Pp
-.Dl db\*> Ic "write pcic_isa_intr_alloc_mask 0x0a00"
-.Dl "pcic_isa_intr_alloc_mask            0xff5f = 0xa00"
-.Dl db\*> Ic "write pcic_isa_alloc_iobase 0x330"
-.Dl "pcic_isa_alloc_iobase               0x400 = 0x330"
-.Dl db\*> Ic "write pcic_isa_alloc_iosize 0x0bf"
-.Dl "pcic_isa_alloc_iosize               0xbff = 0xbf"
-.Dl db\*> Ic "continue"
-.Pp
-Note that, since some floppy images may not have symbol information in
-the kernel, you may have to consult the matching
-.Pa .symbols
-file in the
-.Pa binary/kernel
-directory in the installation tree.
-Find the pcic_ symbols used above,
-look at the hexadecimal value in the first column, and write, for
-example (if
-.Va pcic_isa_intr_alloc_mask
-is equal to c0513e3c):
+.To 2 "Possible hardware problems"
+.Em Possible hardware problems
 .Pp
-.Dl db\*> Ic "write 0xc0513e3c 0x0a00"
-.Pp
-.
-After installation, this value can be permanently written to the kernel image
-directly with:
-.Pp
-.Dl # Ic "cp /netbsd /netbsd.bak"
-.Dl # Ic "gdb --write /netbsd"
-.Dl (gdb) Ic "set pcic_isa_intr_alloc_mask=0x0a00"
-.Dl (gdb) Ic "set pcic_isa_alloc_iobase=0x330"
-.Dl (gdb) Ic "set pcic_isa_alloc_iosize=0x0bf"
-.Dl (gdb) Ic "quit"
-.Dl #
-.Pp
-or you could specify these value when configuring your kernel, e.g.:
-.(disp
-options PCIC_ISA_INTR_ALLOC_MASK=0x0a00
-options PCIC_ISA_ALLOC_IOBASE=0x330
-options PCIC_ISA_ALLOC_IOSIZE=0x0bf
-.disp)
-.Pp
-If you can
-get your
-.Tn PCMCIA
-card to work using this hack, you may also ignore the
-.Bq Tn PCMCIA
-notes later in this document.
-.Pp
-We hope to provide a more elegant solution to this problem in a future
-.Nx
-release.
-.\} \" \n[i386]
+Should you encounter hardware problems during installation, try
+rebooting after unplugging removable devices you don't need for
+installation.
+Non-removable devices can be disabled with
+.Ic userconf
+(use
+.Ic boot
+.Fl c
+to enter it).
 .\} \" !\n[acorn26]:\n[atari]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k]
 .if \n[mac68k] \{\
 .It
@@ -729,14 +542,6 @@
 .To 2 "Booting NetBSD"
 .Em Booting NetBSD
 .
-.if !\n[acorn26]:\n[acorn32]\n[atari]:\n[cats]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k] \{\
-.(pcmcia
-Unplug your
-.Tn PCMCIA
-devices, so that they won't be found by
-.Nx .
-.pcmcia)
-.\} \" !\n[acorn26]:\n[atari]:\n[cats]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k]
 .ie \n[mac68k] \{\
 .Pp
 Prior to attempting to boot
@@ -933,12 +738,6 @@
 .It
 .To 2 "Network configuration"
 .Em Network configuration
-.if !\n[acorn26]:\n[acorn32]:\n[atari]:\n[cats]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k] \{\
-.(pcmcia
-You can skip this section, as you will only get data
-from floppy in the first part of the install.
-.pcmcia)
-.\} \" !\n[acorn26]:\n[atari]:\n[cats]:\n[mac68k]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[sparc64]:\n[x68k]
 .Pp
 If you will not use network operation during the installation,
 but you do want your machine to be configured for networking once
@@ -1685,46 +1484,6 @@
 .It
 .To 2 "Getting the distribution sets"
 .Em Getting the distribution sets
-.if \n[i386] \{\
-.(pcmcia
-.
-Load a kernel tar file (i.e. the
-.Pa kern-GENERIC.tgz
-set file)
-on to your hard disk, for example by mounting the
-hard disk first, copying the
-.Pa kern-GENERIC.tgz
-file from floppy and unpacking it.
-Example:
-.Pp
-.Dl # Ic "mount /dev/wd0a /mnt"
-.Dl # Ic "cd /mnt"
-.Pp
-.D1 Em "repeat the following 3 steps until all kern.* files are there"
-.Dl # Ic "mount -t msdos /dev/fd0a /mnt2"
-.Dl # Ic "cp /mnt2/kern.* ."
-.Dl # Ic "umount /mnt2"
-.Dl # Ic "cat kern.* \&| tar zxpvf -"
-.Pp
-Then halt the machine using the
-.Ic halt
-command.
-Power the machine down, and re-insert all the
-.Tn PCMCIA
-devices.
-Remove any floppy from the floppy drive.
-Start the machine up.
-After booting
-.Nx ,
-you will
-be presented with the main
-.Ic sysinst
-menu.
-Choose the option to re-install sets.
-Wait for the file system checks that it will do to finish, and then proceed
-as described below.
-.pcmcia)
-.\}
 .Pp
 The
 .Nx
@@ -1988,7 +1747,8 @@
 .Em Finalizing your installation
 .Pp
 Congratulations, you have successfully installed
-.Nx \*V .
+.Nx
+\*V .
 .if \n[cats] \{\
 .Pp
 To finalize the installation of
Index: common/xfer
===================================================================
RCS file: /cvsroot/src/distrib/notes/common/xfer,v
retrieving revision 1.53
diff -u -r1.53 xfer
--- common/xfer	25 Nov 2006 21:07:32 -0000	1.53
+++ common/xfer	2 Dec 2006 18:07:15 -0000
@@ -708,10 +708,10 @@
 installation, the IPv4 address of
 .Sy ftp.NetBSD.org
 is
-.Li 204.152.184.75
+.Li 204.152.184.36
 and the IPv6 address is
-.Li 2001:4f8:4:7:2e0:81ff:fe21:6563
-(as of June, 2004).
+.Li 2001:4f8:1:c:230:48ff:fe31:43f2
+(as of December, 2006).
 .Pp
 Once you have this information, you can proceed to the next
 step in the installation or upgrade process.