Subject: install/21708: INSTALL.ps, especially for sparc, formats with far too much courier font
To: None <gnats-bugs@gnats.netbsd.org>
From: Greg A. Woods <woods@weird.com>
List: netbsd-bugs
Date: 05/28/2003 22:50:23
>Number: 21708
>Category: install
>Synopsis: INSTALL.ps, especially for sparc, formats with far too much courier font
>Confidential: no
>Severity: serious
>Priority: medium
>Responsible: install-manager
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Thu May 29 02:51:00 UTC 2003
>Closed-Date:
>Last-Modified:
>Originator: Greg A. Woods
>Release: netbsd-1-6 2003/05/27
>Organization:
Planix, Inc.; Toronto, Ontario; Canada
>Environment:
System: NetBSD 1.6.1_STABLE
Architecture: sparc
Machine: sparc
>Description:
.No is used where .Dl should be used causing troff to be left in
the wrong font most of the time.
Also it seems .(disp and .disp) are abused too much in the
INSTALL document.
A few other very minor bugs are also fixed...
>How-To-Repeat:
print INSTALL.ps or view with GhostScript, etc.
>Fix:
These diffs are against netbsd-1-6 but the same bugs exist in
-current, and probably in other arch subdirs as well.....
Index: notes/sparc/xfer
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/sparc/xfer,v
retrieving revision 1.7
diff -u -r1.7 xfer
--- notes/sparc/xfer 10 Oct 2000 12:55:22 -0000 1.7
+++ notes/sparc/xfer 29 May 2003 02:00:11 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: xfer,v 1.7 2000/10/10 12:55:22 lukem Exp $
.
.so ../common/xfer
Index: notes/sparc/whatis
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/sparc/whatis,v
retrieving revision 1.13.2.1
diff -u -r1.13.2.1 whatis
--- notes/sparc/whatis 9 Jul 2002 06:16:24 -0000 1.13.2.1
+++ notes/sparc/whatis 29 May 2003 02:00:03 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: whatis,v 1.13.2.1 2002/07/09 06:16:24 lukem Exp $
.
.Nx \*V
Index: notes/sparc/upgrade
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/sparc/upgrade,v
retrieving revision 1.14.2.1
diff -u -r1.14.2.1 upgrade
--- notes/sparc/upgrade 2 Jul 2002 04:20:17 -0000 1.14.2.1
+++ notes/sparc/upgrade 29 May 2003 01:59:52 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: upgrade,v 1.14.2.1 2002/07/02 04:20:17 lukem Exp $
.
.so ../common/upgrade
Index: notes/sparc/prep
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/sparc/prep,v
retrieving revision 1.18.2.2
diff -u -r1.18.2.2 prep
--- notes/sparc/prep 11 Jul 2002 18:41:51 -0000 1.18.2.2
+++ notes/sparc/prep 29 May 2003 01:58:43 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: prep,v 1.18.2.2 2002/07/11 18:41:51 thorpej Exp $
.
.Ss2 Configuring your PROM
@@ -47,20 +48,16 @@
If your machine gives you a `\*>' prompt instead of an `ok' prompt,
type:
.Pp
-.(disp
-.No \*> Ic n
-.No ok Ic "setenv sunmon-compat? false"
-.No ok
-.disp)
+.Dl \*> Ic n
+.Dl ok Ic "setenv sunmon-compat? false"
+.Dl ok
.Pp
Next, if you are using any security features of OpenBoot PROM, you should
turn them off \(em
.Nx
can't deal well with this.
.Pp
-.(disp
-.No ok Ic "setenv security-mode none"
-.disp)
+.Dl ok Ic "setenv security-mode none"
.Pp
The OpenBoot PROM 1 machines (SPARCstation/server 1, SPARCstation/server 1+,
IPC, and SLC) have an odd SCSI quirk you should be aware of.
@@ -137,9 +134,7 @@
.Sq unit
numbers the same as the SCSI target IDs, you need to run this command:
.Pp
-.(disp
-.No ok Ic "setenv sd-targets 01234567"
-.disp)
+.Dl ok Ic "setenv sd-targets 01234567"
.Pp
This may, however, cause problems if you were to later attempt to use
.Tn SunOS
@@ -238,16 +233,12 @@
Therefore, to boot from the swap partition on the internal hard drive
(first SCSI bus, target 0, lun 0, partition 1), one would use:
.Pp
-.(disp
-.No ok Ic "boot sd(0,0,1)"
-.disp)
+.Dl ok Ic "boot sd(0,0,1)"
.Pp
To boot from a CD-ROM (first SCSI bus, target 6,
lun 0, partition dynamically determined), one would use:
.Pp
-.(disp
-.No ok Ic "boot sd(0,30,)"
-.disp)
+.Dl ok Ic "boot sd(0,30,)"
.Pp
And, to boot from a kernel named
.Li netbsd-GENERIC
@@ -258,9 +249,7 @@
partition) on an external hard drive (first SCSI bus, target 2, lun 0,
partition 3), one would use:
.Pp
-.(disp
-.No ok Ic "boot sd(0,10,3)netbsd-GENERIC"
-.disp)
+.Dl ok Ic "boot sd(0,10,3)netbsd-GENERIC"
.Pp
Now, for OpenBoot PROM 2, SCSI devices are specified by an OpenBOOT
.Ic devalias
@@ -273,16 +262,12 @@
(OpenBoot PROM 2 assumes the internal hard drive is at target 3), one would
use:
.Pp
-.(disp
-.No ok Ic "boot disk:b"
-.disp)
+.Dl ok Ic "boot disk:b"
.Pp
To boot from a CD-ROM (OpenBoot PROM 2 assumes the CD-ROM is at target 6),
one would use:
.Pp
-.(disp
-.No ok Ic "boot cdrom"
-.disp)
+.Dl ok Ic "boot cdrom"
.Pp
And, to boot from a kernel named
.Li netbsd-GENERIC
@@ -292,9 +277,7 @@
.Pa /usr
partition) on an external hard drive (target 2, partition 3), one would use:
.Pp
-.(disp
-.No ok Ic "boot disk2:d netbsd-GENERIC"
-.disp)
+.Dl ok Ic "boot disk2:d netbsd-GENERIC"
.Pp
The full device path specifier for OpenBoot PROM 2 depends on how OpenBoot
PROM 2 recognizes
@@ -312,96 +295,96 @@
at the `ok' prompt. First `cd' to the top of the device tree and list the
nodes there. The following is the procedure to boot from an HME card in a
SPARC Classic.
-.(disp
-.No ok Ic "cd /"
-.No ok Ic "ls"
-ffd3b790 TI,TMS390S10@0,f8fffffc
-ffd2d254 virtual-memory@0,0
-ffd2d198 memory@0,0
-ffd2b65c obio
-ffd2b310 iommu@0,10000000
-ffd2b2a0 openprom
-ffd24af0 aliases
-ffd24abc options
-ffd24a88 packages
-.disp)
+.Pp
+.Dl ok Ic "cd /"
+.Dl ok Ic "ls"
+.Dl ffd3b790 TI,TMS390S10@0,f8fffffc
+.Dl ffd2d254 virtual-memory@0,0
+.Dl ffd2d198 memory@0,0
+.Dl ffd2b65c obio
+.Dl ffd2b310 iommu@0,10000000
+.Dl ffd2b2a0 openprom
+.Dl ffd24af0 aliases
+.Dl ffd24abc options
+.Dl ffd24a88 packages
+.Pp
Usually, you can simply type in the name before the at (@) sign and the
OpenBoot PROM will fill in the rest.
-.(disp
-.No ok Ic "cd iommu"
-.No ok Ic "ls"
-ffd2b454 sbus@0,10001000
-.No ok Ic "cd sbus"
-.No ok Ic "ls"
-ffd467e8 cgthree@3,0
-ffd42a1c SUNW,hme@1,8c00000
-ffd4297c le@0,c00000
-ffd40d28 ledma@4,8400010
-ffd40c9c SUNW,bpp@4,c800000
-ffd40c00 audio@4,1300000
-ffd3dc68 espdma@4,8400000
-.No ok Ic "cd SUNW,hme"
-.No ok Ic "ls"
-.No ok Ic "pwd"
-/iommu@0,10000000/sbus@0,10001000/SUNW,hme@1,8c00000
-.disp)
+.Pp
+.Dl ok Ic "cd iommu"
+.Dl ok Ic "ls"
+.Dl ffd2b454 sbus@0,10001000
+.Dl ok Ic "cd sbus"
+.Dl ok Ic "ls"
+.Dl ffd467e8 cgthree@3,0
+.Dl ffd42a1c SUNW,hme@1,8c00000
+.Dl ffd4297c le@0,c00000
+.Dl ffd40d28 ledma@4,8400010
+.Dl ffd40c9c SUNW,bpp@4,c800000
+.Dl ffd40c00 audio@4,1300000
+.Dl ffd3dc68 espdma@4,8400000
+.Dl ok Ic "cd SUNW,hme"
+.Dl ok Ic "ls"
+.Dl ok Ic "pwd"
+.Dl /iommu@0,10000000/sbus@0,10001000/SUNW,hme@1,8c00000
+.Pp
OK, now we know the path to the HME device in this example. Now, we need
to determine if it's capable of booting. If it is, it will have the
.Ic word
`open'.
-.(disp
-.No ok Ic "words"
-reset seek load open close
-watch-net selftest obp-selftest write read
-preamble-32 enable-link-pulse disable-link-pulse
-force-speeds reset-transceiver use-bit-bang-mode
-use-frame-mode dump-phys transfer-speed=10
-transfer-speed=100 mii-write mii-read
-create-rev-id
-.disp)
+.Pp
+.Dl ok Ic "words"
+.Dl "reset seek load open close"
+.Dl "watch-net selftest obp-selftest write read"
+.Dl "preamble-32 enable-link-pulse disable-link-pulse"
+.Dl "force-speeds reset-transceiver use-bit-bang-mode"
+.Dl "use-frame-mode dump-phys transfer-speed=10"
+.Dl "transfer-speed=100 mii-write mii-read"
+.Dl create-rev-id
+.Pp
Great!
Also, in case you're interested in further details about your
hardware, you can use the `.attributes' command.
-.(disp
-.No ok Ic ".attributes"
-hm-rev 00000022
-version 1.18
-model SUNW,501-2919
-device_type network
-intr 00000037 00000000
-interrupts 00000004
-address-bits 00000030
-max-frame-size 00004000
-reg 00000001 08c00000 00000108
- 00000001 08c02000 00002000
- 00000001 08c04000 00002000
- 00000001 08c06000 00002000
- 00000001 08c07000 00000020
-name SUNW,hme
-ok
-.disp)
+.Pp
+.Dl ok Ic ".attributes"
+.Dl "hm-rev 00000022"
+.Dl "version 1.18"
+.Dl "model SUNW,501-2919"
+.Dl "device_type network"
+.Dl "intr 00000037 00000000"
+.Dl "interrupts 00000004"
+.Dl "address-bits 00000030"
+.Dl "max-frame-size 00004000"
+.Dl "reg 00000001 08c00000 00000108"
+.Dl "\& 00000001 08c02000 00002000"
+.Dl "\& 00000001 08c04000 00002000"
+.Dl "\& 00000001 08c06000 00002000"
+.Dl "\& 00000001 08c07000 00000020"
+.Dl "name SUNW,hme"
+.Dl ok
+.Pp
So, when it's time to type in a boot command, use the shortened version of the
.Ic pwd
command. In this example, you'd type:
-.(disp
-.No ok Ic "boot /iommu/sbus/SUNW,hme"
-.disp)
+.Pp
+.Dl ok Ic "boot /iommu/sbus/SUNW,hme"
+.Pp
And when the kernel is done booting, it may not automatically use your
card as the root device -- you may need to type in the
.Nx*M
name for
that device:
-.(disp
-root on sd0a dumps on sd0b
-no file system for sd0 (dev 0x700)
-cannot mount root, error = 79
-.No "root device (default sd0a):" Ic "?"
-use one of: fd0[a-h] le0 le1 hme0 sd0[a-h] halt
-.No "root device (default sd0a):" Ic "hme0"
-.No "dump device:" Ic "hme0"
-.No "file system (default generic):" Ic "nfs"
-root on hme0
-.disp)
+.Pp
+.Dl root on sd0a dumps on sd0b
+.Dl no file system for sd0 (dev 0x700)
+.Dl cannot mount root, error = 79
+.Dl "root device (default sd0a):" Ic "?"
+.Dl use one of: fd0[a-h] le0 le1 hme0 sd0[a-h] halt
+.Dl "root device (default sd0a):" Ic "hme0"
+.Dl "dump device:" Ic "hme0"
+.Dl "file system (default generic):" Ic "nfs"
+.Dl root on hme0
+.Pp
.
.Ss2 Deciding on partition sizes
.
Index: notes/sparc/legal
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/sparc/legal,v
retrieving revision 1.7
diff -u -r1.7 legal
--- notes/sparc/legal 20 May 2002 23:48:49 -0000 1.7
+++ notes/sparc/legal 29 May 2003 01:59:40 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: legal,v 1.7 2002/05/20 23:48:49 itojun Exp $
.
.\" NOTE: This file is shared between the sparc and the sparc64
Index: notes/sparc/install
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/sparc/install,v
retrieving revision 1.47.2.2
diff -u -r1.47.2.2 install
--- notes/sparc/install 11 Jul 2002 18:41:50 -0000 1.47.2.2
+++ notes/sparc/install 29 May 2003 02:18:47 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: install,v 1.47.2.2 2002/07/11 18:41:50 thorpej Exp $
.\"
.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
@@ -92,10 +93,8 @@
.Nx
or SunOS the commands are:
.Pp
-.(disp
-.No # Ic "gunzip miniroot.fs.gz"
-.No # Ic "dd if=miniroot.fs of=/dev/rsd0b bs=4k conv=sync"
-.disp)
+.Dl # Ic "gunzip miniroot.fs.gz"
+.Dl # Ic "dd if=miniroot.fs of=/dev/rsd0b bs=4k conv=sync"
.Pp
Here,
.Li /dev/rsd0b
@@ -107,26 +106,18 @@
.Pp
After transferring the file system to disk, bring the system down by:
.Pp
-.(disp
-.No # Ic halt
-.disp)
+.Dl # Ic halt
.Pp
Then boot the installer by typing the appropriate
command at the PROM prompt (this example is for the swap partition):
.Pp
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It sunmon
-.(disp
-.No \*> Ic "b sd(,,1)netbsd -s"
-.disp)
+.Dl \*> Ic "b sd(,,1)netbsd -s"
.It OpenBoot PROM 1
-.(disp
-.No ok Ic "boot sd(,,1)netbsd -s"
-.disp)
+.Dl ok Ic "boot sd(,,1)netbsd -s"
.It OpenBoot PROM 2
-.(disp
-.No ok Ic "boot disk:b netbsd -s"
-.disp)
+.Dl ok Ic "boot disk:b netbsd -s"
.tag)
.Pp
The monitor boot command will load the
@@ -167,17 +158,11 @@
.Pp
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It sunmon
-.(disp
-.No \*> Ic b "sd(,30,)"
-.disp)
+.Dl \*> Ic b "sd(,30,)"
.It OpenBoot PROM 1
-.(disp
-.No ok Ic "boot sd(,30,)"
-.disp)
+.Dl ok Ic "boot sd(,30,)"
.It OpenBoot PROM 2
-.(disp
-.No ok Ic "boot cdrom"
-.disp)
+.Dl ok Ic "boot cdrom"
.tag)
.Pp
After the initial probe messages you'll be asked to start the
@@ -199,9 +184,7 @@
.Xr fdformat 8
command or a PC.
.Pp
-.(disp
-.No # Ic "fdformat"
-.disp)
+.Dl # Ic "fdformat"
.Pp
Be sure that the `fdformat' command completes successfully before proceeding;
on
@@ -228,18 +211,14 @@
distribution).
Insert the first floppy and run the following commands:
.Pp
-.(disp
-.No # Ic "gunzip disk1.gz"
-.No # Ic "dd if=disk1 of=/dev/rfd0a bs=36k"
-.No # Ic "eject floppy"
-.disp)
+.Dl # Ic "gunzip disk1.gz"
+.Dl # Ic "dd if=disk1 of=/dev/rfd0a bs=36k"
+.Dl # Ic "eject floppy"
.Pp
Insert the second floppy and run the following commands:
.Pp
-.(disp
-.No # Ic "dd if=disk2 of=/dev/rfd0a bs=36k conv=sync"
-.No # Ic "eject floppy"
-.disp)
+.Dl # Ic "dd if=disk2 of=/dev/rfd0a bs=36k conv=sync"
+.Dl # Ic "eject floppy"
.Pp
Note that disk2 may be a symlink to .tgz file; do not uncompress it,
just follow the instructions above, verbatim.
@@ -253,17 +232,11 @@
.Pp
.(tag OpenBoot\ PROM\ 2\ (alternate) -offset indent -compact
.It OpenBoot PROM 1
-.(disp
-.No ok Ic "boot fd(,,1)"
-.disp)
+.Dl ok Ic "boot fd(,,1)"
.It OpenBoot PROM 1 (alternate)
-.(disp
-.No ok Ic "boot /fd"
-.disp)
+.Dl ok Ic "boot /fd"
.It OpenBoot PROM 2
-.(disp
-.No ok Ic "boot floppy"
-.disp)
+.Dl ok Ic "boot floppy"
.tag)
.Pp
After the initial probe messages you'll be asked to insert the floppy
@@ -279,10 +252,9 @@
key, found on the left side of your keyboard) and the
.Key a
key, which will halt your system and give you a PROM prompt.
-.(disp
-.No ok Ic "eject"
-.No ok Ic "go"
-.disp)
+.Pp
+.Dl ok Ic "eject"
+.Dl ok Ic "go"
.Pp
Now, insert the floppy labeled
.Li disk2 .
@@ -303,17 +275,11 @@
of the following forms:
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It sunmon
-.(disp
-.No \*> Ic "b le()netbsd"
-.disp)
+.Dl \*> Ic "b le()netbsd"
.It OpenBoot PROM 1
-.(disp
-.No ok Ic "b le()netbsd"
-.disp)
+.Dl ok Ic "b le()netbsd"
.It OpenBoot PROM 2
-.(disp
-.No ok Ic "boot net netbsd"
-.disp)
+.Dl ok Ic "boot net netbsd"
.tag)
.Pp
After the initial probe messages you'll be asked to start the
@@ -327,29 +293,23 @@
Sun sets their tape drives to SCSI ID 4.
We recommend you do the same.
.Pp
-Get the tape images
-.Pq Pa installation/tape/tapefile1.gz No and Pa installation/tape/tapefile2
-and transfer them to a tape.
+Get the two tape image files unzipped and and transfered to a tape one
+after the other.
Make sure you use the
.Sq no rewind scsi tape
device.
Run the following commands:
.Pp
-.(disp
-.No # Ic "gunzip tapefile1.gz"
-.No # Ic "mt -f /dev/nrst0 rew"
-.No # Ic "dd if=tapefile1 of=/dev/nrst0 bs=4k"
-.No # Ic "dd if=tapefile2 of=/dev/nrst0 bs=4k"
-.disp)
+.Dl # Ic "mt -f /dev/nrst0 rew"
+.Dl # Ic "gunzip \*< installation/tape/tapefile1.gz | dd of=/dev/nrst0 bs=4k"
+.Dl # Ic "gunzip \*< installation/tape/tapefile2.gz | dd of=/dev/nrst0 bs=4k"
.Pp
Now you can transfer the
.Nx \*V.
distribution sets from
.Pq Pa binary/sets
to the tape by using a series of additional
-.(disp
-.No # Ic "dd if=\*<aset\*>.tgz of=/dev/nrst0 bs=4k"
-.disp)
+.Dl # Ic "dd if=\*<aset\*>.tgz of=/dev/nrst0 bs=4k"
commands.
See also the section
.Sx Getting the NetBSD System on to Useful Media.
@@ -361,17 +321,11 @@
.Pp
.(tag OpenBoot\ PROM\ 2\ (alternate) -offset indent -compact
.It sunmon
-.(disp
-.No \*> Ic "b st()"
-.disp)
+.Dl \*> Ic "b st()"
.It OpenBoot PROM 1
-.(disp
-.No ok Ic "boot st()"
-.disp)
+.Dl ok Ic "boot st()"
.It OpenBoot PROM 2
-.(disp
-.No ok Ic "boot tape"
-.disp)
+.Dl ok Ic "boot tape"
.tag)
.Pp
After the initial probe messages you'll be asked to confirm the tape
@@ -458,9 +412,7 @@
.Nx
incantation to make the root file system writable is
.Pp
-.(disp
-.No # Ic "mount -u /dev/sd0a /"
-.disp)
+.Dl # Ic "mount -u /dev/sd0a /"
.Pp
Your PROM might have been setup to instruct the boot program to load
a file called
@@ -471,14 +423,10 @@
.Pp
.(tag OpenBoot\ PROM\ 2 -offset indent -compact
.It OpenBoot PROM 1
-.(disp
-.No ok Ic setenv boot-from sd(0,0,0)netbsd
-.disp)
+.Dl ok Ic setenv boot-from sd(0,0,0)netbsd
.It OpenBoot PROM 2
-.(disp
-.No ok Ic setenv boot-file netbsd
-.No ok Ic setenv boot-device disk:a
-.disp)
+.Dl ok Ic setenv boot-file netbsd
+.Dl ok Ic setenv boot-device disk:a
.tag)
.Pp
.Em Congratulations ,
Index: notes/sparc/hardware
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/sparc/hardware,v
retrieving revision 1.18.2.5
diff -u -r1.18.2.5 hardware
--- notes/sparc/hardware 30 Sep 2002 13:00:59 -0000 1.18.2.5
+++ notes/sparc/hardware 29 May 2003 01:59:14 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: hardware,v 1.18.2.5 2002/09/30 13:00:59 lukem Exp $
.
.Ss2 Supported machines
Index: notes/common/postinstall
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/common/postinstall,v
retrieving revision 1.33.2.13
diff -u -r1.33.2.13 postinstall
--- notes/common/postinstall 29 Jul 2002 14:11:41 -0000 1.33.2.13
+++ notes/common/postinstall 29 May 2003 01:57:13 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: postinstall,v 1.33.2.13 2002/07/29 14:11:41 lukem Exp $
.\"
.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
@@ -295,14 +296,14 @@
.Nx*M
FAQ entry on X11.
.br
-.Lk http://www.netbsd.org/Ports/faq.html#x11
+.D1 Lk http://www.netbsd.org/Ports/faq.html#x11
.\}
.if \n[macppc] \{\
Also, you may want to read through the
.Nx*M
X11R6 FAQ.
.br
-.Lk http://www.netbsd.org/Ports/macppc/x11.html
+.D1 Lk http://www.netbsd.org/Ports/macppc/x11.html
.\}
.\} \" ! !\n[next68k]
.if \n[i386]:\n[shark] \{\
@@ -326,7 +327,7 @@
.tag)
.\}
See
-.Lk http://www.xfree86.org/
+.D1 Lk http://www.xfree86.org/
and the XFree86 manual page for more information.
.\}
.Pp
@@ -349,17 +350,17 @@
from source and precompiled binaries.
.Pp
.(bullet
-More information on the package system is at
-.Lk http://www.netbsd.org/Documentation/software/packages.html
+More information on the package system is at:
+.D1 Lk http://www.netbsd.org/Documentation/software/packages.html
.It
-A list of available packages suitable for browsing is at
-.Lk ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/README.html
+A list of available packages suitable for browsing is at:
+.D1 Lk ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/README.html
.It
-Precompiled binaries can be found at
-.Lk ftp://ftp.netbsd.org/pub/NetBSD/packages ,
+Precompiled binaries can be found at:
+.D1 Lk ftp://ftp.netbsd.org/pub/NetBSD/packages ,
usually in the
.Pa \*V/\*M/All
-subdir.
+subdirectory.
You can install them with the following commands:
.Pp
.Bd -unfilled
@@ -377,8 +378,8 @@
depend on.
.It
Package sources for compiling packages on your own can be obtained by
-retrieving the file
-.Lk ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/tar_files/pkgsrc.tar.gz
+retrieving the following file:
+.D1 Lk ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/tar_files/pkgsrc.tar.gz
They are typically extracted into
.Pa /usr/pkgsrc
(though other locations work fine), with the commands:
Index: notes/common/netboot
===================================================================
RCS file: /cvs/master/m-NetBSD/main/src/distrib/notes/common/netboot,v
retrieving revision 1.4.2.7
diff -u -r1.4.2.7 netboot
--- notes/common/netboot 22 Jul 2002 17:12:49 -0000 1.4.2.7
+++ notes/common/netboot 29 May 2003 02:36:38 -0000
@@ -1,3 +1,4 @@
+.\" -*-nroff-*-
.\" $NetBSD: netboot,v 1.4.2.7 2002/07/22 17:12:49 lukem Exp $
.\"
.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
@@ -162,18 +163,15 @@
.Pa installation/misc
directory of the distribution.
.Pp
-.(disp
-.No # Ic "mkdir -p /usr/mdec/rbootd"
-.No # Ic "cp SYS_UBOOT /usr/mdec/rbootd"
-.No # Ic "chmod -R a+rX /usr/mdec/rbootd"
-.disp)
+.Dl # Ic "mkdir -p /usr/mdec/rbootd"
+.Dl # Ic "cp SYS_UBOOT /usr/mdec/rbootd"
+.Dl # Ic "chmod -R a+rX /usr/mdec/rbootd"
.Pp
Create
.Pa /etc/rbootd.conf
with the following line:
-.(disp
-CC:CC:CC:CC:CC:CC SYS_UBOOT
-.disp)
+.Pp
+.Dl CC:CC:CC:CC:CC:CC SYS_UBOOT
.Pp
You will need to start the
.Ic rbootd .
@@ -183,9 +181,7 @@
.Nx 1.5
or later, you can achieve this with:
.Pp
-.(disp
-.No # Ic "/etc/rc.d/rbootd restart"
-.disp)
+.Dl # Ic "/etc/rc.d/rbootd restart"
.Pp
.It
.\} \" ! \n[hp300]
@@ -287,9 +283,7 @@
.Pa dhcpd.leases
file exists.
.Pp
-.(disp
-.No # Ic "touch /var/db/dhcpd.leases"
-.disp)
+.Dl # Ic "touch /var/db/dhcpd.leases"
.Pp
You will need to start the
.Ic dhcpd .
@@ -299,9 +293,7 @@
.Nx 1.5
or later, you can achieve this with:
.Pp
-.(disp
-.No # Ic "/etc/rc.d/dhcpd restart"
-.disp)
+.Dl # Ic "/etc/rc.d/dhcpd restart"
.Pp
.\} \" ! \n[hp300]:\n[macppc]:\n[next68k]:\n[sparc]:\n[walnut]
.if \n[sparc] \{\
@@ -313,17 +305,13 @@
.Pa /etc/ethers
file with the following line:
.Pp
-.(disp
-CC:CC:CC:CC:CC:CC client
-.disp)
+.Dl "CC:CC:CC:CC:CC:CC client"
.Pp
Add your client to the server's
.Pa /etc/hosts
file:
.Pp
-.(disp
-192.168.1.10 client
-.disp)
+.Dl 192.168.1.10 client
.Pp
You will need to start the
.Ic rarpd .
@@ -333,9 +321,7 @@
.Nx 1.5
or later, you can achieve this with:
.Pp
-.(disp
-.No # Ic "/etc/rc.d/rarpd restart"
-.disp)
+.Dl # Ic "/etc/rc.d/rarpd restart"
.Pp
.\} \" ! \n[sparc]
.if !\n[hp300] \{\
@@ -349,16 +335,14 @@
.Pa /tftpboot
directory.
Thus, the first order of business is to create this directory:
-.(disp
-.No # Ic "mkdir -p /tftpboot"
-.disp)
+.Pp
+.Dl # Ic "mkdir -p /tftpboot"
.Pp
Next, edit
.Pa /etc/inetd.conf
and uncomment the line with the TFTP daemon:
-.(disp
-tftp dgram udp wait root /usr/libexec/tftpd tftpd -l -s /tftpboot
-.disp)
+.Pp
+.Dl "tftp dgram udp wait root /usr/libexec/tftpd tftpd -l -s /tftpboot"
.Pp
Now, restart
.Xr inetd 8 .
@@ -366,9 +350,7 @@
.Nx 1.5
or later, you can achieve this with:
.Pp
-.(disp
-.No # Ic "/etc/rc.d/inetd restart"
-.disp)
+.Dl # Ic "/etc/rc.d/inetd restart"
.Pp
.ie \n[walnut] Now, you need to copy the kernel for your \*M machine to
.el Now, you need to copy the bootloader for your \*M machine to
@@ -379,9 +361,9 @@
from the
.Pa installation
directory of the distribution.
-.(disp
-.No # Ic "cp ofwboot.xcf /tftpboot"
-.disp)
+.Pp
+.Dl # Ic "cp ofwboot.xcf /tftpboot"
+.Pp
.\}
.if \n[next68k] \{\
Get
@@ -391,10 +373,9 @@
directory of the distribution and extract
.Pa boot
from it.
-.(disp
-.No # Ic "tar -xpzf /path/to/files/base.tgz ./usr/mdec/boot"
-.No # Ic "cp usr/mdec/boot /tftpboot"
-.disp)
+.Pp
+.Dl # Ic "tar -xpzf /path/to/files/base.tgz ./usr/mdec/boot"
+.Dl # Ic "cp usr/mdec/boot /tftpboot"
.\}
.if \n[sparc] \{\
Get
@@ -402,9 +383,8 @@
from the
.Pa installation/netboot
directory of the distribution.
-.(disp
-.No # Ic "cp boot.net /tftpboot"
-.disp)
+.Pp
+.Dl # Ic "cp boot.net /tftpboot"
.Pp
Now, you need to link
.Pa boot.net
@@ -419,27 +399,24 @@
You can use
.Xr bc 1
to help calculate the filename:
-.(disp
-.No # Ic bc
-.Ic obase=16
-.Ic 192
-C0
-.Ic 168
-A8
-.Ic 1
-1
-.Ic 10
-A
-.Ic quit
-.No # Ic "cd /tftpboot"
-.No # Ic "ln -s boot.net C0A8010A.SUN4C"
-.disp)
+.Dl # Ic bc
+.Dl Ic obase=16
+.Dl Ic 192
+.Dl C0
+.Dl Ic 168
+.Dl A8
+.Dl Ic 1
+.Dl 1
+.Dl Ic 10
+.Dl A
+.Dl Ic quit
+.Dl # Ic "cd /tftpboot"
+.Dl # Ic "ln -s boot.net C0A8010A.SUN4C"
.Pp
.\} \" \n[sparc]
Just to be sure, let's make everything readable.
-.(disp
-.No # Ic "chmod -R a+rX /tftpboot"
-.disp)
+.Pp
+.Dl # Ic "chmod -R a+rX /tftpboot"
.Pp
Sometimes, the
.Xr arp 8
@@ -453,9 +430,9 @@
.Sq Li "tftpd: write: Host is down" .
If this is the case, you may need to force the server to map your client's
ethernet address to its IP address:
-.(disp
-.No # Ic "arp -s client CC:CC:CC:CC:CC:CC"
-.disp)
+.Pp
+.Dl # Ic "arp -s client CC:CC:CC:CC:CC:CC"
+.Pp
.\} \" ! !\n[hp300]
.Pp
.It
@@ -477,17 +454,13 @@
Let's set up the NFS server.
Create the directory you are exporting for the netboot client:
.Pp
-.(disp
-.No # Ic "mkdir -p /export/client/root"
-.disp)
+.Dl # Ic "mkdir -p /export/client/root"
.Pp
Put the following line in
.Pa /etc/exports
to enable NFS sharing:
.Pp
-.(disp
-.No "/export/client/root -maproot=root client.test.net"
-.disp)
+.Dl "/export/client/root -maproot=root client.test.net"
.Pp
If your server is currently running an NFS server, you only need to
restart
@@ -500,11 +473,9 @@
.Nx 1.5
or later, you can achieve this with:
.Pp
-.(disp
-.No # Ic "/etc/rc.d/rpcbind start"
-.No # Ic "/etc/rc.d/nfsd start"
-.No # Ic "/etc/rc.d/mountd restart"
-.disp)
+.Dl # Ic "/etc/rc.d/rpcbind start"
+.Dl # Ic "/etc/rc.d/nfsd start"
+.Dl # Ic "/etc/rc.d/mountd restart"
.Pp
.It
.Nx
@@ -535,15 +506,13 @@
for the distribution files, as they won't fit inside the miniroot
file system.
.Pp
-.(disp
-.No # Ic "gunzip miniroot.fs.gz"
-.No # Ic "vnconfig -c /dev/vnd0c /path/to/miniroot.fs"
-.No # Ic "mount -o ro /dev/vnd0c /export/client/root"
-.No # Ic "ls /export/client/root"
- .profile dist/ install.md mnt/ sbin/ usr/
- bin/ etc/ install.sub mnt2/ tmp/ var/
- dev/ install* kern/ netbsd* upgrade*
-.disp)
+.Dl # Ic "gunzip miniroot.fs.gz"
+.Dl # Ic "vnconfig -c /dev/vnd0c /path/to/miniroot.fs"
+.Dl # Ic "mount -o ro /dev/vnd0c /export/client/root"
+.Dl # Ic "ls /export/client/root"
+.Dl " .profile dist/ install.md mnt/ sbin/ usr/"
+.Dl " bin/ etc/ install.sub mnt2/ tmp/ var/"
+.Dl " dev/ install* kern/ netbsd* upgrade*"
.Pp
If there are no files present in your exported directory, then
something is wrong.
@@ -551,11 +520,9 @@
To use the RAM disk-based installer, uncompress and rename the kernel.
Also, copy the distribution files to the client's root directory.
.Pp
-.(disp
-.No # Ic "cp *tgz /export/client/root"
-.No # Ic "gunzip netbsd.RAMDISK.gz"
-.No # Ic "mv netbsd.RAMDISK /export/client/root/netbsd"
-.disp)
+.Dl # Ic "cp *tgz /export/client/root"
+.Dl # Ic "gunzip netbsd.RAMDISK.gz"
+.Dl # Ic "mv netbsd.RAMDISK /export/client/root/netbsd"
.Pp
If you are running your \*M diskless, simply use
.Pa binary/kernel/netbsd-GENERIC.gz .
@@ -566,11 +533,9 @@
(this has the installation tools in a RAM disk).
Also, copy the distribution files to the client's root directory.
.Pp
-.(disp
-.No # Ic "cp *tgz /export/client/root"
-.No # Ic "gunzip netbsd.GENERIC_MD.gz"
-.No # Ic "mv netbsd.GENERIC_MD /export/client/root/netbsd"
-.disp)
+.Dl # Ic "cp *tgz /export/client/root"
+.Dl # Ic "gunzip netbsd.GENERIC_MD.gz"
+.Dl # Ic "mv netbsd.GENERIC_MD /export/client/root/netbsd"
.Pp
If you are running your \*M diskless, simply use
.Pa binary/kernel/netbsd-GENERIC.gz .
@@ -579,29 +544,23 @@
Use
.Pa binary/kernel/netbsd.GENERIC.gz .
.Pp
-.(disp
-.No # Ic "gunzip netbsd.GENERIC.gz"
-.No # Ic "mv netbsd.GENERIC /export/client/root/netbsd"
-.disp)
+.Dl # Ic "gunzip netbsd.GENERIC.gz"
+.Dl # Ic "mv netbsd.GENERIC /export/client/root/netbsd"
.\}
.if \n[sparc] \{\
Use
.Pa binary/kernel/netbsd-GENERIC.gz ) .
.Pp
-.(disp
-.No # Ic "gunzip netbsd-GENERIC.gz"
-.No # Ic "mv netbsd-GENERIC /export/client/root/netbsd"
-.disp)
+.Dl # Ic "gunzip netbsd-GENERIC.gz"
+.Dl # Ic "mv netbsd-GENERIC /export/client/root/netbsd"
.Pp
If you are netbooting the installer, copy the distribution files to
the client's root directory and extract the tools from
.Pa installation/netboot/rootfs.tgz .
.Pp
-.(disp
-.No # Ic "cp *tgz /export/client/root"
-.No # Ic "cd /export/client/root"
-.No # Ic "tar -xpzf rootfs.tgz"
-.disp)
+.Dl # Ic "cp *tgz /export/client/root"
+.Dl # Ic "cd /export/client/root"
+.Dl # Ic "tar -xpzf rootfs.tgz"
.\}
.if \n[walnut] \{\
If you are netbooting the installer, use
@@ -609,11 +568,9 @@
(this has the installation tools in a RAM disk).
Also, copy the distribution files to the client's root directory.
.Pp
-.(disp
-.No # Ic "cp *tgz /export/client/root"
-.No # Ic "gunzip netbsd.INSTALL.img.gz"
-.No # Ic "mv netbsd.INSTALL.img /export/client/root/netbsd"
-.disp)
+.Dl # Ic "cp *tgz /export/client/root"
+.Dl # Ic "gunzip netbsd.INSTALL.img.gz"
+.Dl # Ic "mv netbsd.INSTALL.img /export/client/root/netbsd"
.Pp
If you are running your \*M diskless, simply use
.Pa binary/kernel/netbsd.img-WALNUT.gz .
@@ -635,32 +592,26 @@
.(bullet -compact
Extracting distribution sets
.Pp
-.(disp
-.No # Ic "cd /export/client/root"
-.No # Ic "tar -xpzf /path/to/files/base.tgz"
-.No # Ic "tar -xpzf /path/to/files/etc.tgz"
-.disp)
+.Dl # Ic "cd /export/client/root"
+.Dl # Ic "tar -xpzf /path/to/files/base.tgz"
+.Dl # Ic "tar -xpzf /path/to/files/etc.tgz"
.Pp
Continue with the other non-essential distribution sets if desired.
.Pp
.It
Set up swap
.Pp
-.(disp
-.No # Ic "mkdir /export/client/root/swap"
-.No # Ic "dd if=/dev/zero of=/export/client/swap bs=4k count=4k"
-.No # Ic "echo '/export/client/swap -maproot=root:wheel client.test.net' | cat \*>\*> /etc/exports"
-.No # Ic "/etc/rc.d/mountd restart"
-.disp)
+.Dl # Ic "mkdir /export/client/root/swap"
+.Dl # Ic "dd if=/dev/zero of=/export/client/swap bs=4k count=4k"
+.Dl # Ic "echo '/export/client/swap -maproot=root client.test.net' \*>\*> /etc/exports"
+.Dl # Ic "/etc/rc.d/mountd restart"
This creates a 16 MB swap file and exports it to the client.
.Pp
.It
Create device nodes
.Pp
-.(disp
-.No # Ic "cd /export/client/root/dev"
-.No # Ic "./MAKEDEV all"
-.disp)
+.Dl # Ic "cd /export/client/root/dev"
+.Dl # Ic "./MAKEDEV all"
.Pp
This procedure only works on
.Nx
>Release-Note:
>Audit-Trail:
>Unformatted: