Fri Apr 1 21:53:35 2022 UTC ()
Remove floppy installation instructions from sparc documentation.

Floppy generation was disabled before NetBSD 6.0 release due to size
constraints and unlikely to be restored soon or at all. PR port-sparc/56776.
ok martin.


(andvar)
diff -r1.568 -r1.569 src/distrib/notes/common/main
diff -r1.27 -r1.28 src/distrib/notes/sparc/contents
diff -r1.60 -r1.61 src/distrib/notes/sparc/install

cvs diff -r1.568 -r1.569 src/distrib/notes/common/main (expand / switch to unified diff)

--- src/distrib/notes/common/main 2022/02/06 07:37:29 1.568
+++ src/distrib/notes/common/main 2022/04/01 21:53:35 1.569
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: main,v 1.568 2022/02/06 07:37:29 nia Exp $ 1.\" $NetBSD: main,v 1.569 2022/04/01 21:53:35 andvar Exp $
2.\" 2.\"
3.\" Copyright (c) 1999-2012 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1999-2012 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
@@ -196,55 +196,53 @@ fetch the pair of boot floppy images @@ -196,55 +196,53 @@ fetch the pair of boot floppy images
196and 196and
197.Pa macppc/installation/floppy/boot2.fs , 197.Pa macppc/installation/floppy/boot2.fs ,
198which include the bootloader and installation kernel. 198which include the bootloader and installation kernel.
199For systems without floppy drives (most are Open Firmware 3), fetch the 199For systems without floppy drives (most are Open Firmware 3), fetch the
200bootloader 200bootloader
201.Pa macppc/installation/ofwboot.xcf 201.Pa macppc/installation/ofwboot.xcf
202and the installation kernel 202and the installation kernel
203.Pa macppc/binary/kernel/netbsd-GENERIC_MD.gz . 203.Pa macppc/binary/kernel/netbsd-GENERIC_MD.gz .
204If you have a CD-R, you can fetch the CD image, 204If you have a CD-R, you can fetch the CD image,
205.Pa NetBSD-\*V-macppc.iso . 205.Pa NetBSD-\*V-macppc.iso .
206.\} 206.\}
207.if \n[sparc] \{\ 207.if \n[sparc] \{\
208Fetch a CD image, 208Fetch a CD image,
209.Pa NetBSD-\*V-sparc.iso 209.Pa NetBSD-\*V-sparc.iso .
210or the floppy disk images, 210You need the CD to boot your system.
211.Pa sparc/install/floppy/disk1.gz No and Pa sparc/install/floppy/disk2 . 
212You need either the pair of floppies or the CD to boot your system. 
213.\} 211.\}
214.if \n[sparc64] \{\ 212.if \n[sparc64] \{\
215This is either a CD image 213This is either a CD image
216.Pq Pa NetBSD-\*V-sparc64.iso 214.Pq Pa NetBSD-\*V-sparc64.iso
217which can be booted directly, or the installation kernel and bootloader 215which can be booted directly, or the installation kernel and bootloader
218.Pq Pa sparc64/binary/kernel/netbsd-INSTALL.gz No and Pa sparc64/installation/misc/ofwboot 216.Pq Pa sparc64/binary/kernel/netbsd-INSTALL.gz No and Pa sparc64/installation/misc/ofwboot
219which can be booted from a 217which can be booted from a
220.Tn Solaris 218.Tn Solaris
221or 219or
222.Nx 220.Nx
223partition. 221partition.
224.\} 222.\}
225.if \n[macppc]:\n[sparc]:\n[sparc64] \{\ 223.if \n[macppc]:\n[sparc]:\n[sparc64] \{\
226Alternatively, you may netboot the installation kernel. This process is 224Alternatively, you may netboot the installation kernel. This process is
227covered below, in detail. 225covered below, in detail.
228.\} 226.\}
229.It 227.It
230The actual binary distribution is in the 228The actual binary distribution is in the
231.Pa \*M/binary/sets/ 229.Pa \*M/binary/sets/
232directory. 230directory.
233When you boot the install 231When you boot the install
234.if \n[amd64] image or CD-ROM, 232.if \n[amd64] image or CD-ROM,
235.if \n[i386] image, CD-ROM or floppies, 233.if \n[i386] image, CD-ROM or floppies,
236.if \n[macppc] kernel from floppies, hard drive, or CD-ROM, 234.if \n[macppc] kernel from floppies, hard drive, or CD-ROM,
237.if \n[sparc] floppies or CD-ROM, 235.if \n[sparc] CD-ROM,
238.if \n[sparc64] CD-ROM or installation kernel, 236.if \n[sparc64] CD-ROM or installation kernel,
239the installation program 237the installation program
240can fetch these files for you (using, e.g., ftp) 238can fetch these files for you (using, e.g., ftp)
241if you have a network connection. 239if you have a network connection.
242There are several other methods to get the binary sets onto 240There are several other methods to get the binary sets onto
243your machine. 241your machine.
244.Pp 242.Pp
245You will at a minimum need 243You will at a minimum need
246.ie \n[i386]:\n[amd64] \{\ 244.ie \n[i386]:\n[amd64] \{\
247one of the kernel sets, typically 245one of the kernel sets, typically
248.Pa kern-GENERIC.\*[setsuffix] , 246.Pa kern-GENERIC.\*[setsuffix] ,
249as well as 247as well as
250.\} 248.\}
@@ -302,28 +300,26 @@ If your \*M has a floppy drive, create t @@ -302,28 +300,26 @@ If your \*M has a floppy drive, create t
302(Windows), or 300(Windows), or
303.Ic dd 301.Ic dd
304(any 302(any
305.Ul 303.Ul
306system with floppy support). If your system has Open Firmware 3, drag 304system with floppy support). If your system has Open Firmware 3, drag
307.Pa ofwboot.xcf No and Pa netbsd-GENERIC_MD.gz 305.Pa ofwboot.xcf No and Pa netbsd-GENERIC_MD.gz
308to your hard drive icon (the top level of the drive, not the desktop). 306to your hard drive icon (the top level of the drive, not the desktop).
309If you are using the CD image, burn it now. 307If you are using the CD image, burn it now.
310.\} 308.\}
311.if \n[sparc] \{\ 309.if \n[sparc] \{\
312.It 310.It
313Make sure your sparc's CD-ROM drive is bootable. 311Make sure your sparc's CD-ROM drive is bootable.
314Burn the CD. 312Burn the CD.
315Otherwise, write the floppy images directly to a pair of floppies 
316(after uncompressing disk1.gz). 
317.\} 313.\}
318.if \n[sparc64] \{\ 314.if \n[sparc64] \{\
319.It 315.It
320Burn the CD or put the installation kernel and bootloader 316Burn the CD or put the installation kernel and bootloader
321at the root level of a bootable 317at the root level of a bootable
322.Tn Solaris 318.Tn Solaris
323or 319or
324.Nx 320.Nx
325partition. 321partition.
326.\} 322.\}
327.Pp 323.Pp
328The media you just prepared will be used to boot the installation 324The media you just prepared will be used to boot the installation
329kernel, which contains all the tools required to install 325kernel, which contains all the tools required to install
@@ -434,33 +430,26 @@ press the @@ -434,33 +430,26 @@ press the
434keys, or send a BREAK if you're on a serial console. 430keys, or send a BREAK if you're on a serial console.
435At the 431At the
436.Dq Ic "ok" 432.Dq Ic "ok"
437prompt, type the command to boot your system into 433prompt, type the command to boot your system into
438.Nx . 434.Nx .
439.\} 435.\}
440.if \n[sparc] \{\ 436.if \n[sparc] \{\
441The command to boot from CD is one of the following commands (depending on 437The command to boot from CD is one of the following commands (depending on
442your model): 438your model):
443.Dq Ic b sd(,30,) , 439.Dq Ic b sd(,30,) ,
444.Dq Ic boot sd(,30,) , 440.Dq Ic boot sd(,30,) ,
445or 441or
446.Dq Ic boot cdrom . 442.Dq Ic boot cdrom .
447.Pp 
448The command to boot from floppy is either 
449.Dq Ic boot fd(,,1) 
450or 
451.Dq Ic boot floppy . 
452The installer will prompt you to insert the second floppy when it is ready 
453for it. 
454.\} 443.\}
455.if \n[sparc64] \{\ 444.if \n[sparc64] \{\
456The command to boot from CD is: 445The command to boot from CD is:
457.Dq Ic boot cdrom . 446.Dq Ic boot cdrom .
458The command to boot the 447The command to boot the
459.Nx 448.Nx
460kernel from a 449kernel from a
461.Tn Solaris 450.Tn Solaris
462or 451or
463.Nx 452.Nx
464partition depends on which disk and partition it is on. 453partition depends on which disk and partition it is on.
465To boot from the first partition of the first (primary) disk: 454To boot from the first partition of the first (primary) disk:
466.Dq Ic "boot disk:a /ofwboot -a" . 455.Dq Ic "boot disk:a /ofwboot -a" .

cvs diff -r1.27 -r1.28 src/distrib/notes/sparc/contents (expand / switch to unified diff)

--- src/distrib/notes/sparc/contents 2020/08/07 00:43:51 1.27
+++ src/distrib/notes/sparc/contents 2022/04/01 21:53:35 1.28
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: contents,v 1.27 2020/08/07 00:43:51 snj Exp $ 1.\" $NetBSD: contents,v 1.28 2022/04/01 21:53:35 andvar Exp $
2.\" 2.\"
3.\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
@@ -99,30 +99,26 @@ hardware. @@ -99,30 +99,26 @@ hardware.
99\*M binary distribution sets; 99\*M binary distribution sets;
100see below. 100see below.
101. 101.
102. tag) \" binary/ 102. tag) \" binary/
103. 103.
104. It Pa installation/ 104. It Pa installation/
105. 105.
106. (tag miniroot/ -compact \" installation/ 106. (tag miniroot/ -compact \" installation/
107. 107.
108. It Pa bootfs/ 108. It Pa bootfs/
109. 109.
110Netbootable RAM disk kernel and the file system in the RAM disk; see below. 110Netbootable RAM disk kernel and the file system in the RAM disk; see below.
111. 111.
112. It Pa floppy/ 
113. 
114\*M boot and installation floppies; see below. 
115. 
116. It Pa miniroot/ 112. It Pa miniroot/
117. 113.
118\*M miniroot file system image; see below. 114\*M miniroot file system image; see below.
119. 115.
120. It Pa netboot/ 116. It Pa netboot/
121. 117.
122Netboot bootloader and root filesystem with install tools; see below. 118Netboot bootloader and root filesystem with install tools; see below.
123. 119.
124. It Pa tape/ 120. It Pa tape/
125. 121.
126\*M boot and installation tapes; see below. 122\*M boot and installation tapes; see below.
127. 123.
128. tag) \" installation/ 124. tag) \" installation/

cvs diff -r1.60 -r1.61 src/distrib/notes/sparc/install (expand / switch to unified diff)

--- src/distrib/notes/sparc/install 2021/12/08 12:54:15 1.60
+++ src/distrib/notes/sparc/install 2022/04/01 21:53:35 1.61
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: install,v 1.60 2021/12/08 12:54:15 uwe Exp $ 1.\" $NetBSD: install,v 1.61 2022/04/01 21:53:35 andvar Exp $
2.\" 2.\"
3.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
@@ -29,28 +29,26 @@ Installing @@ -29,28 +29,26 @@ Installing
29.Nx 29.Nx
30is a relatively complex process, but if you have 30is a relatively complex process, but if you have
31this document in hand it shouldn't be too much trouble. 31this document in hand it shouldn't be too much trouble.
32.Pp 32.Pp
33There are several ways to install 33There are several ways to install
34.Nx 34.Nx
35onto your system. 35onto your system.
36The easiest way is to use the 36The easiest way is to use the
37.Pa miniroot.fs 37.Pa miniroot.fs
38image copied to your local disk's swap partition or a scratch drive. 38image copied to your local disk's swap partition or a scratch drive.
39If your Sparc is hooked up in a network, you may configure another 39If your Sparc is hooked up in a network, you may configure another
40.Ul 40.Ul
41machine as a netboot server for your Sparc. 41machine as a netboot server for your Sparc.
42Alternatively, there is a pair 
43of floppy images that will boot your system and run the installer. 
44.Pp 42.Pp
45For more information on the commands and variables available in 43For more information on the commands and variables available in
46the OpenBoot PROM (present in all sun4c and sun4m machines), go to 44the OpenBoot PROM (present in all sun4c and sun4m machines), go to
47.Lk http://docs.sun.com 45.Lk http://docs.sun.com
48and search for 46and search for
49.Dq openboot reference 47.Dq openboot reference
50(without quotes). 48(without quotes).
51. 49.
52.Ss2 Installing NetBSD by placing a bootable file system on a partitioned hard drive 50.Ss2 Installing NetBSD by placing a bootable file system on a partitioned hard drive
53. 51.
54.Pa installation/miniroot/miniroot.fs.gz 52.Pa installation/miniroot/miniroot.fs.gz
55is a compressed, self-contained 53is a compressed, self-contained
56.Nx 54.Nx
@@ -169,132 +167,26 @@ Boot the installer by typing the appropr @@ -169,132 +167,26 @@ Boot the installer by typing the appropr
169.disp) 167.disp)
170.It OpenBoot PROM 2 168.It OpenBoot PROM 2
171.(disp 169.(disp
172.No ok Ic "boot cdrom" 170.No ok Ic "boot cdrom"
173.disp) 171.disp)
174.tag) 172.tag)
175.Pp 173.Pp
176After the initial probe messages you'll be asked to start the 174After the initial probe messages you'll be asked to start the
177install or upgrade procedure. 175install or upgrade procedure.
178Proceed to the section 176Proceed to the section
179.Sx Running the installation scripts. 177.Sx Running the installation scripts.
180below. 178below.
181. 179.
182.Ss2 Installing NetBSD by using the bootable floppies 
183. 
184The 
185.Nx 
186install floppies only work on the sun4c and sun4m machines. 
187Making the install floppies is fairly straightforward. 
188.Pp 
189.Nx 
190and SunOS use the same commands. 
191First, get two 1.44 MB floppy disks and format them either using the 
192.Xr fdformat 8 
193command or a PC. 
194.Pp 
195.(disp 
196.No # Ic "fdformat" 
197.disp) 
198.Pp 
199Be sure that the `fdformat' command completes successfully before proceeding; 
200on 
201.Nx 
202success is a string of all 
203.Sq Li V 's , 
204and on 
205.Tn SunOS 
206success is a string of 
207.Sq Li \&. 's . 
208.Pp 
209Next, transfer the two floppy images 
210.Pq Pa installation/floppy/disk1.gz No and Pa installation/floppy/disk2 
211to the disks you just formatted. 
212You can do this step from 
213.Nx , 
214.Tn SunOS , 
215or a 
216.Tn Windows 
217machine using 
218.Nm rawrite.exe 
219(available in the 
220.Nx Ns / Ns i386 
221distribution). 
222Insert the first floppy and run the following commands: 
223.Pp 
224.(disp 
225.No # Ic "gunzip disk1.gz" 
226.No # Ic "dd if=disk1 of=/dev/rfd0a bs=36k" 
227.No # Ic "eject floppy" 
228.disp) 
229.Pp 
230Insert the second floppy and run the following commands: 
231.Pp 
232.(disp 
233.No # Ic "dd if=disk2 of=/dev/rfd0a bs=36k" 
234.No # Ic "eject floppy" 
235.disp) 
236.Pp 
237Note that disk2 may be a symlink to .\*[setsuffix] file; do not uncompress it, 
238just follow the instructions above, verbatim. 
239After writing the two floppies, 
240be sure to label them so you can later identify them. 
241.Pp 
242Insert the floppy made from 
243.Pa disk1 
244into your Sparc. 
245From the OpenBoot prompt, boot the floppy with the following command: 
246.Pp 
247.(tag OpenBoot\ PROM\ 2\ (alternate) -offset indent -compact 
248.It OpenBoot PROM 1 
249.(disp 
250.No ok Ic "boot fd(,,1)" 
251.disp) 
252.It OpenBoot PROM 1 (alternate) 
253.(disp 
254.No ok Ic "boot /fd" 
255.disp) 
256.It OpenBoot PROM 2 
257.(disp 
258.No ok Ic "boot floppy" 
259.disp) 
260.tag) 
261.Pp 
262After the initial probe messages you'll be asked to insert the floppy 
263labeled 
264.Dq NetBSD disk2 . 
265If the floppy is not automatically ejected, you can either use a 
266straightened paperclip to eject the disk or do the following: 
267.Pp 
268Press the 
269.Key STOP 
270key (sometimes called the 
271.Key L1 
272key, found on the left side of your keyboard) and the 
273.Key a 
274key, which will halt your system and give you a PROM prompt. 
275.(disp 
276.No ok Ic "eject" 
277.No ok Ic "go" 
278.disp) 
279.Pp 
280Now, insert the floppy labeled 
281.Li disk2 . 
282After the installation tools have been loaded, 
283you'll be asked to start the install or upgrade procedure. 
284Proceed to the section 
285.Sx Running the installation scripts. 
286below. 
287. 
288.Ss2 Installing NetBSD by using a netboot setup 180.Ss2 Installing NetBSD by using a netboot setup
289. 181.
290.so ../common/netboot 182.so ../common/netboot
291.Pp 183.Pp
292Now, netboot your Sparc from the server by entering the appropriate 184Now, netboot your Sparc from the server by entering the appropriate
293.Ic boot 185.Ic boot
294command at the monitor prompt. 186command at the monitor prompt.
295Depending on the PROM version in your machine, this command takes one 187Depending on the PROM version in your machine, this command takes one
296of the following forms: 188of the following forms:
297.(tag OpenBoot\ PROM\ 2 -offset indent -compact 189.(tag OpenBoot\ PROM\ 2 -offset indent -compact
298.It sunmon 190.It sunmon
299.(disp 191.(disp
300.No \*[Gt] Ic "b le()netbsd" 192.No \*[Gt] Ic "b le()netbsd"