Sync usage with man page.
[netbsd-mini2440.git] / distrib / notes / common / contents
blob3caf93f38a57e0288ed9536eb9ee8f5be85c3046
1 .\"     $NetBSD: contents,v 1.158 2009/10/01 11:51:03 tron Exp $
2 .\"
3 .\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
4 .\" All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\"    notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\"    notice, this list of conditions and the following disclaimer in the
13 .\"    documentation and/or other materials provided with the distribution.
14 .\"
15 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25 .\" POSSIBILITY OF SUCH DAMAGE.
26 .\"
27 .Ss2 NetBSD/\*M subdirectory structure
28 The \*M-specific portion of the
29 .Nx
30 \*V release is found in the
31 .Pa \*M
32 subdirectory of the distribution:
33 .ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
34 .el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
35 It contains the following files and directories:
36 .Pp
37 .(tag INSTALL.html -compact \" top level
38 .       It Pa INSTALL.html
39 .       It Pa INSTALL.ps
40 .       It Pa INSTALL.txt
41 .       It Pa INSTALL.more
42 Installation notes in various file formats, including this file.
43 The
44 .Pa \&.more
45 file contains underlined text using the
46 .Xr more 1
47 conventions for indicating italic and bold display.
48 .       It Pa binary/
49 .       (tag kernel/ -compact \" binary/
50 .               It Pa kernel/
51 .               (tag netbsd.gz -compact \" binary/kernel
52 .if !\n[atari]:\n[mac68k]:\n[sgimips]:\n[evbppc] \{\
53 .                       It Pa netbsd-GENERIC.gz
54 A gzipped
55 .Nx
56 kernel containing code for everything supported in this release.
57 .if \n[amd64] \{\
58 .                       It Pa netbsd-INSTALL.gz
59 The installation kernel.
60 .                       It Pa netbsd-INSTALL_XEN3_DOMU.gz
61 .                       It Pa netbsd-XEN3_DOM0.gz
62 .                       It Pa netbsd-XEN3_DOMU.gz
63 .\} \" amd64
64 .if \n[hpcmips] \{\
65 This kernel runs on Vr41xx and TX3922 CPUs only.
66 .\} \" hpcmips
67 .\} \" !atari/mac68k/sgimips/evgppc
68 .if \n[alpha]:\n[macppc]:\n[sparc]:\n[sparc64]:\n[vax] \{\
69 .                       It Pa netbsd-GENERIC.MP.gz
70 A gzipped
71 .Nx
72 kernel containing code for everything supported in this release.  This 
73 kernel supports SMP on systems with more than one CPU.
74 .\}
76 .if \n[hp300] \{\
77 .                       It Pa netbsd-RAMDISK.gz
78 A gzipped
79 .Nx
80 kernel containing code for all of the hardware supported in this release
81 with an embedded ramdisk-based installer.  This is the same kernel
82 that is present on the miniroot filesystem, but uses a newer more 
83 user-friendly installation program.
84 .                       It Pa netbsd-RAMDISK.symbols.gz
85 Symbols for
86 .Pa netbsd-RAMDISK.gz .
87 .\}
89 .if \n[i386] \{\
90 .                       It Pa netbsd-MONOLITHIC.gz
91 The monolithic kernel which doesn't use kernel modules.
92 .                       It Pa netbsd-INSTALL.gz
93 The installation kernel.
95 .                       It Pa netbsd-INSTALL_FLOPPY.gz
96 A version of
97 .Li INSTALL
98 for older machines without CD-ROM drives.
99 .                       It Pa netbsd-INSTALL_XEN2_DOMU.gz
100 .                       It Pa netbsd-INSTALL_XEN3PAE_DOMU.gz
101 .                       It Pa netbsd-INSTALL_XEN3_DOMU.gz
102 .                       It Pa netbsd-XEN2_DOM0.gz
103 .                       It Pa netbsd-XEN2_DOMU.gz
104 .                       It Pa netbsd-XEN3PAE_DOMU.gz
105 .                       It Pa netbsd-XEN3_DOM0.gz
106 .                       It Pa netbsd-XEN3_DOMU.gz
108 .if \n[mac68k] \{\
109 .                       It Pa netbsd-GENERIC.gz
110 A kernel containing code for everything supported in this release using
111 the standard SCSI driver.
112 .                       It Pa netbsd-GENERICSBC.gz
113 A kernel containing code for everything supported in this release using
114 the SBC variant of the SCSI driver.
116 .if \n[macppc] \{\
117 .                       It Pa netbsd-GENERIC_MD.gz
118 A gzipped
120 kernel containing code for everything supported in this release.
121 It also has a RAM-disk installer.
122 This is the kernel you should use when you want to install via
123 netboot, from a CD-R, or an HFS partition on Open Firmware 3 systems.
124 .                       It Pa netbsd-INSTALL.gz
125 A gzipped
127 kernel containing code only for Open Firmware 1.0.5, 1.1.22, 2.0.x,
128 and 2.4 systems (i.e. those that have floppy drives).
129 It has a RAM-disk installer.
132 .if \n[acorn26] \{\
133 .                       It Pa netbsd-FOURMEG.gz
134 A somewhat smaller kernel, intended to be usable on systems with
135 four megabytes of RAM.
138 .if \n[acorn32] \{\
139 .                       It Pa netbsd-NC.gz
140 A kernel intended for Acorn Network Computers.
143 .if \n[atari] \{\
144 .                       It Pa netbsd-SMALL030.gz
145 A kernel for memory-tight 68030 Falcon and TT030 machines.
146 This is the kernel supplied on the boot.fs floppy.
147 .                       It Pa netbsd-ATARITT.gz
148 A kernel for the Atari TT030.
149 .                       It Pa netbsd-FALCON.gz
150 A kernel for the Atari Falcon, including support for 68060
151 processor cards.
152 .                       It Pa netbsd-HADES.gz
153 A kernel for 68040 or 68060 Hades.
154 .                       It Pa netbsd-MILAN-ISAIDE.gz
155 A kernel for 68040 or 68060 MILAN using IDE in ISA mode - for
156 use with disks not marked byteswapped by HDDRIVER.
157 .                       It Pa netbsd-MILAN-PCIIDE.gz
158 A kernel for 68040 or 68060 MILAN using IDE in PCI mode - for
159 use with disks marked byteswapped by HDDRIVER.
162 .if \n[hpcmips] \{\
163 .                       It Pa netbsd-TX3912.gz
164 A kernel for TX3912 machines.
167 .if \n[mvme68k] \{\
168 .                       It Pa netbsd-VME147.gz
169 A kernel for MVME147 boards.
170 .                       It Pa netbsd-VME162.gz
171 A kernel for MVME162 boards.
172 .                       It Pa netbsd-VME167.gz
173 A kernel for MVME167 boards.
174 .                       It Pa netbsd-VME172.gz
175 A kernel for MVME172 boards.
176 .                       It Pa netbsd-VME177.gz
177 A kernel for MVME177 boards.
179 .if \n[sparc] \{\
180 .                       It Pa netbsd-GENERIC_SCSI3.gz
181 A kernel with SCSI ID 3 explicitly mapped to 
182 .Li sd0 .
183 .                       It Pa netbsd-KRUPS.gz
184 A kernel for JavaStation-NC (Krups) machines.
185 .                       It Pa netbsd-MRCOFFEE.gz
186 A kernel for JavaStation-1 (Mr. Coffee) machines using Open Boot Prom firmware.
187 .                       It Pa netbsd-MRCOFFEE_OFW.gz
188 A kernel for JavaStation-1 (Mr. Coffee) machines using OpenFirmware.
189 .                       It Pa netbsd-GENERIC_SUN4U.gz
190 A kernel which supports sparc64 hardware in 32-bit mode only.  See the 
191 sparc64 INSTALL notes for help installing this kernel on your sparc64 
192 hardware.
194 .if \n[sparc64] \{\
195 .                       It Pa netbsd-INSTALL.gz
196 The install kernel.
199 .if \n[sgimips] \{\
200 .                       It Pa netbsd-GENERIC32_IP12.gz
201 A kernel suitable for booting on R3000 Indigo, IRIS 4D/3x and similar machines.
202 .                       It Pa netbsd.ecoff-GENERIC32_IP12.gz
203 GENERIC32_IP2x targeted for being bootable on the above machines
204 with PROMs that do not understand the ELF binary format.
205 .                       It Pa netbsd-GENERIC32_IP2x.gz
206 A kernel suitable for booting on Indy, Indigo 2 and similar machines.
207 .                       It Pa netbsd.ecoff-GENERIC32_IP2x.gz
208 GENERIC32_IP2x targeted for being bootable on older Indigo 2 and possibly
209 Indy machines with PROMs that do not understand the ELF binary format.
210 .                       It Pa netbsd-GENERIC32_IP3x.gz
211 A kernel suitable for booting on O2.
214 .if \n[evbppc] \{\
215 .                       It Pa netbsd-EV64260.gz
216 A gzipped kernel (in ELF format) for the Marvell EV-64260.
217 .                       It Pa netbsd.img-EV64260.gz
218 Same as the above, but in the format expected by the firmware.
219 .                       It Pa netbsd-EXPLORA451.gz
220 A gzipped kernel (in ELF format) for the NCD Explora451 NC.
221 .                       It Pa netbsd.img-EXPLORA451.gz
222 Same as the above, but in the format expected by the firmware.
223 .                       It Pa netbsd-INSTALL_OPENBLOCKS266.gz
224 A gzipped install kernel (in ELF format) for the Plat'Home OpenBlockS266
225 microserver.
226 .                       It Pa netbsd-INSTALL_OPENBLOCKS266.img.gz
227 Same as the above, but in the format expected by the firmware.
228 .                       It Pa netbsd-INSTALL_OPENBLOCKS266.symbols.gz
229 Symbols for
230 .Pa netbsd-INSTALL_OPENBLOCKS266.gz .
231 .                       It Pa netbsd-INSTALL_WALNUT.gz
232 A gzipped install kernel (in ELF format) for the IBM PowerPC 405GP Walnut
233 evaluation board.
234 .                       It Pa netbsd-INSTALL_WALNUT.img.gz
235 Same as the above, but in the format expected by the firmware.
236 .                       It Pa netbsd-INSTALL_WALNUT.symbols.gz
237 Symbols for
238 .Pa netbsd-INSTALL_WALNUT.gz .
239 .                       It Pa netbsd-OPENBLOCKS200.gz
240 A gzipped kernel (in ELF format) for the Plat'Home OpenBlockS200.
241 .                       It Pa netbsd.img-OPENBLOCKS200.gz
242 Same as the above, but in the format expected by the firmware.
243 .                       It Pa netbsd-OPENBLOCKS266.gz
244 A gzipped kernel (in ELF format) for the Plat'Home OpenBlockS266 microserver.
245 .                       It Pa netbsd.img-OPENBLOCKS266.gz
246 Same as the above, but in the format expected by the firmware.
247 .                       It Pa netbsd-PMPPC.gz
248 A gzipped kernel (in ELF format) for Artesyn PM/PPC boards.
249 .                       It Pa netbsd-WALNUT.gz
250 A gzipped kernel (in ELF format) for the IBM PowerPC 405GP Walnut
251 evaluation board.
252 .                       It Pa netbsd.img-WALNUT.gz
253 Same as the above, but in the format expected by the firmware.
256 .               tag) \" binary/kernel/
257 .               It Pa sets/
258 \*M binary distribution sets;
259 see below.
260 .       tag) \" binary/
261 .       It Pa installation/
263 .       (tag miniroot/ -compact \" installation/
265 .if \n[i386]:\n[amd64] \{\
266 .               It Pa cdrom/
267 \*M bootable cdrom images; see below.
269 .if \n[sparc] \{\
270 .               It Pa bootfs/
271 Netbootable RAM disk kernel and the file system in the RAM disk; see below.
273 .if \n[alpha]:\n[amd64]:\n[amiga]:\n[atari]:\n[bebox]:\n[ews4800mips]:\
274 \n[i386]:\n[news68k]:\n[newsmips]:\n[sparc]:\n[x68k]:\n[prep]:\
275 \n[sandpoint] \{\
276 .               It Pa floppy/
277 \*M boot and installation floppies; see below.
280 .if \n[alpha] \{\
281 .               It Pa diskimage/
282 an image file
283 .Pa cdhdtape
284 is included for the case where the installer is written to
285 a CD, hard drive, or tape.
286 This image file is the same for the CD, HD, and tape cases.
287 .               It Pa instkernel/
288 contains a
289 .Pa netbsd.gz
290 installation kernel; this is the same installer kernel as in all the
291 other install
292 images, but without the various boot program and file system wrappers.
293 It can be netbooted or diskbooted from a previous installation.
294 no need to
295 .Ic gunzip
296 this image.
299 .if \n[cats] \{\
300 .               It Pa kernel/
301 \*M installation kernels.
304 .if \n[mac68k] \{\
305 .               It Pa instkernel/
306 \*M boot and installation kernels; see installation section (Sysinst
307 Method), below.
309 .if \n[amiga]:\n[atari]:\n[hp300]:\n[mvme68k]:\n[sparc]:\n[sparc64]:\n[sun2]:\n[sun3] \{\
310 .               It Pa miniroot/
311 \*M miniroot file system image; see below.
314 .if !\n[alpha]:\n[cats]:\n[evbppc]:\n[mvme68k]:\n[macppc]:\n[sgimips]:\n[sparc]:\n[xen] \{\
315 .               It Pa misc/
317 Miscellaneous \*M installation utilities; see
318 .if \n[mac68k] \{\
319 the Traditional method
321 installation section below.
324 .if \n[hp300] \{\
325 .       (tag HP-IB.geometry
326 .       It Pa HP-IB.geometry
327 A file containing geometry for some HB-IB disk drives.
328 .       It Pa SYS_INST.gz
329 A gzipped copy of the SYS_INST miniroot installation program.  This is 
330 only necessary if you can't use the RAMDISK based installer.
331 .       It Pa SYS_UBOOT.gz
332 A gzipped copy of the universal boot block.
333 Supports Network, tape and disk booting.
334 This is useful if you are installing a diskless
335 .Nx*M
336 system.
337 .       tag)
340 .if \n[macppc] \{\
341 .               It Pa floppy/boot1.fs
342 .               It Pa floppy/boot2.fs
343 \*M boot and installation floppy images.  The first is the bootloader and
344 kernel.  The second image has the installation tools.
345 Only usable on models that ship with a floppy drive (pre-Open Firmware 3);
346 see below.
347 .               It Pa ofwboot.xcf
348 \*M bootloader; see below.
351 .if \n[mvme68k] \{\
352 .               It Pa netboot/
353 Two programs needed to boot \*M kernels over the network; see below.
354 .               It Pa tapeimage/
355 Tape boot programs, and a RAMDISK kernel; see below.
358 .if \n[sgimips] \{\
359 .               It Pa netboot/
360 NFS-root images
363 .if \n[sparc] \{\
364 .               It Pa netboot/
365 Netboot bootloader and root filesystem with install tools; see below.
366 .               It Pa tape/
367 \*M boot and installation tapes; see below.
369 .if \n[sparc64] \{\
370 .               It Pa netboot/
371 Netboot bootloader; see below.
374 .if \n[sun2] \{\
375 .               It Pa netboot/
376 Two programs needed to boot \*M kernels over the network.
377 .               It Pa tapeimage/
378 Tape boot program, and two shell scripts used to prepare tapes.
381 .if \n[sun3] \{\
382 .               It Pa netboot/
383 Two programs needed to boot \*M kernels over the network.
384 .               It Pa tapeimage/
385 Tape boot programs, and a RAMDISK kernel.
388 .       tag) \" installation/
390 .tag) \" top level
393 .if \n[alpha] \{\
394 .Ss2 Bootable installation/upgrade floppies
396 There are three bootable images in the
398 \*M distribution.
399 One is for a floppy boot and is split into three separate files.
400 The other is a single-file image containing the same install kernel,
401 but intended to be written to a CD, tape, or hard drive.
402 The third image is a
403 .Li GENERIC
404 kernel intended for production use in unusual cases.
405 This can be useful at some sites when:
406 .(bullet
407 You want to run diskless but SRM bugs prevent the firmware from
408 netbooting.
409 You can work around this problem by always booting the generic
410 kernel from the floppy.
412 SRM doesn't recognize your (hard) disk controller but
414 does.
415 This happens more frequently than you might think.
416 SRM will usually only boot from
417 .Xr siop 4
419 .Xr isp 4
420 SCSI devices, and on most platforms will not
421 boot from an IDE drive.
423 will happily operate
424 with almost any SCSI root or an IDE root; the solution here is to netboot
425 a kernel or always boot from floppy.
426 .bullet)
430 .if \n[amiga] \{\
431 .Ss2 Miniroot file system
432 The Amiga now uses a single miniroot file system for both an initial
433 installation and for an upgrade.
434 A gzipped version is available, for easier downloading.
435 (The gzipped version has the
436 .Sy \&.gz
437 extension added to
438 their names.)
439 .(tag miniroot.fs
440 .It Pa miniroot.fs
441 This file contains a
443 root file system setup to help you
444 install the rest of
446 or to upgrade a previous version of
447 .Nx .
448 This includes formatting and mounting your
449 .Pa /
450 (root) and
451 .Pa /usr
452 partitions and getting ready to extract (and possibly first
453 fetching) the distribution sets.
454 There is enough on this file system to allow you to make a SLIP or
455 PPP connection, configure an Ethernet, mount an NFS file system or ftp.
456 You can also load distribution sets from a SCSI tape or from one of
457 your existing
458 .Tn AmigaDOS
459 partitions.
460 .tag)
464 .Ss2 Binary distribution sets
468 binary distribution sets contain the binaries which
469 comprise the
471 \*V release for \*M.
472 The binary distribution sets can be found in the
473 .Pa \*M/binary/sets
474 subdirectory
475 of the
478 .ie \n[sparc64] \{\
479 distribution tree.  
480 .(Note
481 If you want to install 32-bit only binaries, you will 
482 still need to boot using the sparc64 installation tools.  When sysinst
483 asks you for the distribution set to install, provide the
484 .Nx Ns /sparc
485 .Pa binary/sets .
486 Be sure to use the 32 bit sparc
487 .Pa kern-GENERIC_SUN4U.tgz 
488 kernel distribution.  Otherwise, continue to follow the \*M installation
489 procedure, not the sparc instructions.
490 .Note)
491 Most people will want the 64-bit \*M distribution tree:
493 .el distribution tree, and are as follows:
494 .(tag xserver \" sets
496 .It Sy base
501 .Sy base
502 binary distribution.
504 .Em must
505 install this distribution set.
506 It contains the base
508 utilities that are necessary for the
509 system to run and be minimally functional.
511 .\" XXX set sizes can be calculated using list-setsizes.sh
513 .if \n[acorn26] .setsize 28 80
514 .if \n[acorn32] .setsize 28 80
515 .if \n[algor] .setsize 30 95
516 .if \n[alpha] .setsize 33 102
517 .if \n[amd64] .setsize 34 100
518 .if \n[amiga] .setsize 25 75
519 .if \n[arc] .setsize 30 95
520 .if \n[atari] .setsize 26 75
521 .if \n[cats] .setsize 28 80
522 .if \n[cesfic] .setsize 25 75
523 .if \n[cobalt] .setsize 30 95
524 .if \n[dreamcast] .setsize 27 73
525 .if \n[evbarm] .setsize 28 80
526 .if \n[evbmips] .setsize 30 95
527 .if \n[evbppc] .setsize 27 79
528 .if \n[evbsh3] .setsize 28 73
529 .if \n[hp300] .setsize 25 75
530 .if \n[hp700] .setsize 30 85
531 .if \n[hpcarm] .setsize 28 80
532 .if \n[hpcmips] .setsize 30 95
533 .if \n[hpcsh] .setsize 28 73
534 .if \n[i386] .setsize 26 76
535 .if \n[ibmnws] .setsize 28 83
536 .if \n[iyonix] .setsize 28 80
537 .if \n[landisk] .setsize 28 73
538 .if \n[luna68k] .setsize 25 75
539 .if \n[mac68k] .setsize 25 75
540 .if \n[macppc] .setsize 29 83
541 .if \n[mipsco] .setsize 30 95
542 .if \n[mmeye] .setsize 28 73
543 .if \n[mvme68k] .setsize 25 75
544 .if \n[mvmeppc] .setsize 28 83
545 .if \n[netwinder] .setsize 28 80
546 .if \n[news68k] .setsize 25 75
547 .if \n[newsmips] .setsize 30 95
548 .if \n[next68k] .setsize 25 75
549 .if \n[ofppc] .setsize 28 83
550 .if \n[pmax] .setsize 30 96
551 .if \n[prep] .setsize 29 83
552 .if \n[sandpoint] .setsize 28 83
553 .if \n[sbmips] .setsize 30 95
554 .if \n[sgimips] .setsize 30 95
555 .if \n[shark] .setsize 28 80
556 .if \n[sparc] .setsize 27 80
557 .if \n[sparc64] .setsize 33 103
558 .if \n[sun2] .setsize 166 413
559 .if \n[sun3] .setsize 25 75
560 .if \n[vax] .setsize 25 70
561 .if \n[x68k] .setsize 26 75
562 .showsize
564 .It Sy comp
565 Things needed for compiling programs.
566 This set includes the system include files
567 .Pq Pa /usr/include
568 and the various system libraries (except the shared
569 libraries, which are included as part of the
570 .Sy base
571 set).
572 This set also includes the manual pages for
573 all of the utilities it contains, as well as the
574 system call and library manual pages.
575 .if \n[acorn26] .setsize 41 140
576 .if \n[acorn32] .setsize 41 140
577 .if \n[algor] .setsize 37 139
578 .if \n[alpha] .setsize 49 206
579 .if \n[amd64] .setsize 58 218
580 .if \n[amiga] .setsize 36 130
581 .if \n[arc] .setsize 37 139
582 .if \n[atari] .setsize 35 130
583 .if \n[cats] .setsize 41 140
584 .if \n[cesfic] .setsize 35 130
585 .if \n[cobalt] .setsize 37 139
586 .if \n[dreamcast] .setsize 38 125
587 .if \n[evbarm] .setsize 41 140
588 .if \n[evbmips] .setsize 37 139
589 .if \n[evbppc] .setsize 44 153
590 .if \n[evbsh3] .setsize 39 125
591 .if \n[hp300] .setsize 36 130
592 .if \n[hp700] .setsize 44 148
593 .if \n[hpcarm] .setsize 41 140
594 .if \n[hpcmips] .setsize 37 139
595 .if \n[hpcsh] .setsize 38 126
596 .if \n[i386] .setsize 37 131
597 .if \n[ibmnws] .setsize 44 153
598 .if \n[iyonix] .setsize 41 140
599 .if \n[landisk] .setsize 38 126
600 .if \n[luna68k] .setsize 35 130
601 .if \n[mac68k] .setsize 36 130
602 .if \n[macppc] .setsize 44 153
603 .if \n[mipsco] .setsize 37 139
604 .if \n[mmeye] .setsize 39 125
605 .if \n[mvme68k] .setsize 35 130
606 .if \n[mvmeppc] .setsize 44 153
607 .if \n[netwinder] .setsize 41 140
608 .if \n[news68k] .setsize 36 130
609 .if \n[newsmips] .setsize 37 139
610 .if \n[next68k] .setsize 36 130
611 .if \n[ofppc] .setsize 44 153
612 .if \n[pmax] .setsize 37 139
613 .if \n[prep] .setsize 44 153
614 .if \n[sandpoint] .setsize 44 153
615 .if \n[sbmips] .setsize 37 139
616 .if \n[sgimips] .setsize 37 139
617 .if \n[shark] .setsize 41 140
618 .if \n[sparc] .setsize 39 140
619 .if \n[sparc64] .setsize 59 225
620 .if \n[sun2] .setsize 30 108
621 .if \n[sun3] .setsize 36 130
622 .if \n[vax] .setsize 29 107
623 .if \n[x68k] .setsize 36 130
624 .showsize
626 .It Sy etc
627 This distribution set contains the system
628 configuration files that reside in
629 .Pa /etc
630 and in several other places.
631 This set
632 .Em must
633 be installed if you are installing the system from scratch, but should
634 .Em not
635 be used if you are upgrading.
636 .\" Not MI, but close enough to the same size on all ports...
637 .showsize 1 1
639 .It Sy games
640 This set includes the games and their manual pages.
641 .\" Shareable within MACHINE_ARCH (NIH)
642 .setsize -unknown-machine-arch- -unknown-machine-arch-
643 .if \n[acorn26] .setsize 4 8
644 .if \n[acorn32] .setsize 4 8
645 .if \n[algor] .setsize 4 9
646 .if \n[alpha] .setsize 4 9
647 .if \n[amd64] .setsize 4 8
648 .if \n[amiga] .setsize 4 8
649 .if \n[arc] .setsize 4 9
650 .if \n[atari] .setsize 4 8
651 .if \n[cats] .setsize 4 8
652 .if \n[cesfic] .setsize 4 8
653 .if \n[cobalt] .setsize 4 9
654 .if \n[dreamcast] .setsize 4 8
655 .if \n[evbarm] .setsize 4 8
656 .if \n[evbmips] .setsize 4 9
657 .if \n[evbppc] .setsize 4 8
658 .if \n[evbsh3] .setsize 4 8
659 .if \n[hp300] .setsize 4 8
660 .if \n[hp700] .setsize 4 8
661 .if \n[hpcarm] .setsize 4 8
662 .if \n[hpcmips] .setsize 4 9
663 .if \n[hpcsh] .setsize 4 8
664 .if \n[i386] .setsize 4 8
665 .if \n[ibmnws] .setsize 4 8
666 .if \n[iyonix] .setsize 4 8
667 .if \n[landisk] .setsize 4 8
668 .if \n[luna68k] .setsize 4 8
669 .if \n[mac68k] .setsize 4 8
670 .if \n[macppc] .setsize 4 8
671 .if \n[mipsco] .setsize 4 9
672 .if \n[mmeye] .setsize 4 8
673 .if \n[mvme68k] .setsize 4 8
674 .if \n[mvmeppc] .setsize 4 8
675 .if \n[netwinder] .setsize 4 8
676 .if \n[news68k] .setsize 4 8
677 .if \n[newsmips] .setsize 4 9
678 .if \n[next68k] .setsize 4 8
679 .if \n[ofppc] .setsize 4 8
680 .if \n[pmax] .setsize 4 9
681 .if \n[prep] .setsize 4 8
682 .if \n[sandpoint] .setsize 4 8
683 .if \n[sbmips] .setsize 4 9
684 .if \n[sgimips] .setsize 4 9
685 .if \n[shark] .setsize 4 8
686 .if \n[sparc] .setsize 4 8
687 .if \n[sparc64] .setsize 4 9
688 .if \n[sun2] .setsize 9 21
689 .if \n[sun3] .setsize 4 8
690 .if \n[vax] .setsize 4 8
691 .if \n[x68k] .setsize 4 8
692 .showsize
694 .\" Kernel set(s)
696 .ie \n[atari] \{\
697 .It Sy kern-SMALL030, kern-ATARITT, kern-FALCON, kern-HADES , kern-MILAN-ISAIDE , kern-MILAN-PCIIDE
698 These sets contain a
699 .Nx*M
701 kernel, named
702 .Pa /netbsd .
704 .Em must
705 install the kernel that matches your hardware.
706 .showsize 2 4
708 .el \{\
709 .ie \n[evbarm] \{\
710 .It Sy kern-INTEGRATOR
711 (see below)
712 .showsize 14 36
713 .It Sy kern-IQ80310
714 (see below)
715 .showsize 26 74
716 .It Sy kern-IQ80321
717 (see below)
718 .showsize 28 74
719 .It Sy kern-TEAMASA_NPWR
720 .showsize 17 44
722 These sets contain a
723 .Nx*M
725 kernel, named
726 .Pa /netbsd .
727 Some of these sets also contain a binary format kernel named
728 .Pa /netbsd.bin
729 and an S-record format kernel named
730 .Pa /netbsd.srec
731 that your firmware may need to boot.
733 .Em must
734 install the kernel that matches your hardware.
736 .el \{\
737 .ie \n[mac68k] \{\
738 .It Sy kern-GENERIC
739 This set contains a
740 .Nx*M
742 .Li GENERIC
743 kernel, named
744 .Pa /netbsd .
746 .Em must
747 install either this distribution set or kern-GENERICSBC.
748 .showsize 2 4
749 .It Sy kern-GENERICSBC
750 This set contains a
751 .Nx*M
753 .Li GENERICSBC
754 kernel, named
755 .Pa /netbsd .
757 .Em must
758 install either this distribution set or kern-GENERIC.
759 .showsize 2 4
761 .el \{\
762 .ie \n[macppc] \{\
763 .It Sy kern-GENERIC
764 This set contains a
765 .Nx*M
767 .Li GENERIC
768 kernel named
769 .Pa /netbsd .
771 .Em must
772 install this distribution set.
773 .showsize 4 8
774 .It Sy kern-GENERIC.MP
775 This set contains a
776 .Nx*M
778 .Li GENERIC.MP
779 kernel, which will use multiple processors (if present), named
780 .Pa /netbsd .
781 .showsize 4 8
783 .el \{\
784 .ie \n[sgimips] \{\
785 .It Sy kern-GENERIC32_IP2x
786 This set contains a
787 .Nx*M
789 .Li GENERIC32_IP12
790 kernel (for R3000 Indigo, IRIS 4D/3x machines), named
791 .Pa /netbsd .
792 This set also contains an ECOFF kernel named
793 .Pa /netbsd.ecoff
794 that your system may need to boot.
795 .It Sy kern-GENERIC32_IP2x
796 This set contains a
797 .Nx*M
799 .Li GENERIC32_IP2x
800 kernel (for Indy, Indigo 2 and Challenge S/M machines), named
801 .Pa /netbsd .
802 This set also contains an ECOFF kernel named
803 .Pa /netbsd.ecoff
804 that your system may need to boot.
805 .It Sy kern-GENERIC32_IP3x
806 This set contains a
807 .Nx*M
809 .Li GENERIC32_IP3x
810 kernel (for O2), named
811 .Pa /netbsd .
814 .Em must
815 install one of these distribution sets for your machine.
816 .showsize 4 8
818 .el \{\
819 .ie \n[sparc] \{\
820 .It Sy kern-GENERIC
821 This set contains a
822 .Nx*M
824 .Li GENERIC
825 kernel named
826 .Pa /netbsd .
828 .Em must
829 install this distribution set.
830 .showsize 2 4
831 .It Sy kern-GENERIC.MP
832 This set contains a
833 .Nx*M
835 .Li GENERIC.MP
836 kernel, which will use multiple processors (if present), named
837 .Pa /netbsd .
838 .showsize 2 4
839 .It Sy kern-GENERIC_SCSI3
840 This set contains a
841 .Nx*M
843 .Li GENERIC_SCSI3
844 kernel, which will set SCSI ID 3 to 
845 .Li sd0 ,
846 named
847 .Pa /netbsd .
848 .showsize 2 4
849 .It Sy kern-GENERIC_SUN4U
850 This set contains a
851 .Nx*M
853 .Li GENERIC_SUN4U
854 kernel, which supports only UltraSPARC systems in 32 bit mode, named
855 .Pa /netbsd .
856 .showsize 4 9
857 .It Sy kern-KRUPS
858 This set contains a
859 .Nx*M
861 .Li GENERIC-KRUPS
862 kernel, which supports the JavaStation-NC, named
863 .Pa /netbsd .
864 .showsize 2 3
865 .It Sy kern-MRCOFFEE
866 This set contains a
867 .Nx*M
869 .Li MRCOFFE
870 kernel, which which supports the OpenBOOT PROM 2 JavaStation-1, named
871 .Pa /netbsd .
872 .showsize 2 3
873 .It Sy kern-MRCOFFEE_OFW
874 This set contains a
875 .Nx*M
877 .Li MRCOFFE_OFW
878 kernel, which which supports the OpenFirmware JavaStation-1, named
879 .Pa /netbsd .
880 .showsize 2 3
882 .el \{\
883 .ie \n[sparc64] \{\
884 .It Sy kern-GENERIC
885 This set contains a
886 .Nx*M
888 .Li GENERIC
889 kernel named
890 .Pa /netbsd .
892 .Em must
893 install this or the kern-GENERIC.MP distribution set.
894 .showsize 4 10
895 .It Sy kern-GENERIC.MP
896 This set contains a
897 .Nx*M
899 .Li GENERIC.MP
900 kernel, which will use multiple processors (if present), named
901 .Pa /netbsd .
902 .showsize 4 10
904 .el \{\
905 .ie \n[evbppc] \{\
906 .It Sy kern-EV64260
907 This set contains a
908 .Nx*M
910 kernel in ELF format named
911 .Pa /netbsd
912 and the same kernel in the format needed by the bootloader as
913 .Pa /netbsd.img .
914 These kernels are specific to the Marvell EV-64260.
915 .showsize 4 8
916 .It Sy kern-EXPLORA451
917 This set contains a
918 .Nx*M
920 kernel in ELF format named
921 .Pa /netbsd
922 and the same kernel in the format needed by the bootloader as
923 .Pa /netbsd.img .
924 These kernels are specific to the NCD Explora451 NC.
925 .showsize 4 8
926 .It Sy kern-OPENBLOCKS266
927 This set contains a
928 .Nx*M
930 kernel in ELF format named
931 .Pa /netbsd
932 and the same kernel in the format needed by the bootloader as
933 .Pa /netbsd.img .
934 These kernels are specific to the Plat'Home OpenBlockS266 microserver.
935 .showsize 4 8
936 .It Sy kern-PMPPC
937 This set contains a
938 .Nx*M
940 kernel in ELF format named
941 .Pa /netbsd
942 and the same kernel in the format needed by the bootloader as
943 .Pa /netbsd.img .
944 These kernels are specific to Artesyn PM/PPC boards.
945 .showsize 4 8
946 .It Sy kern-WALNUT
947 This set contains a
948 .Nx*M
950 kernel in ELF format named
951 .Pa /netbsd
952 and the same kernel in the format needed by the bootloader as
953 .Pa /netbsd.img .
954 These kernels are specific to the IBM 405GP based Walnut evaluation board.
955 .showsize 5 10
957 .el \{\
958 .ie \n[xen] \{\
960 .el \{\
961 .It Sy kern-GENERIC
962 This set contains a
963 .Nx*M
965 .Li GENERIC
966 kernel, named
967 .Pa /netbsd .
969 .Em must
970 install this distribution set.
971 .if \n[cats]:\n[shark] \{\
972 This set also contains an a.out kernel named
973 .Pa /netbsd.aout
974 that your system may need to boot.
976 .if \n[acorn26] .setsize 2 4
977 .if \n[acorn32] .setsize 2 4
978 .if \n[alpha] .setsize 5 10
979 .if \n[amd64] .setsize 5 13
980 .if \n[amiga] .setsize 2 4
981 .if \n[arc] .setsize 3 6
982 .if \n[cats] .setsize 5 10
983 .if \n[cobalt] .setsize 2 5
984 .if \n[dreamcast] .setsize 2 3
985 .if \n[hp300] .setsize 2 4
986 .if \n[hp700] .setsize 4 8
987 .if \n[hpcmips] .setsize 2 5
988 .if \n[hpcsh] .setsize 2 3
989 .if \n[i386] .setsize 5 11
990 .if \n[ibmnws] .setsize 2 5
991 .if \n[iyonix] .setsize 2 4
992 .if \n[landisk] .setsize 3 4
993 .if \n[luna68k] .setsize 1 2
994 .if \n[mac68k] .setsize 2 4
995 .if \n[macppc] .setsize 4 8
996 .if \n[mipsco] .setsize 2 3
997 .if \n[mmeye] .setsize 2 3
998 .if \n[mvme68k] .setsize 2 3
999 .if \n[mvmeppc] .setsize 2 3
1000 .if \n[netwinder] .setsize 2 4
1001 .if \n[news68k] .setsize 2 3
1002 .if \n[newsmips] .setsize 2 4
1003 .if \n[next68k] .setsize 2 3
1004 .if \n[ofppc] .setsize 3 5
1005 .if \n[pmax] .setsize 2 5
1006 .if \n[prep] .setsize 2 5
1007 .if \n[sandpoint] .setsize 2 4
1008 .if \n[sbmips] .setsize 2 4
1009 .if \n[sgimips] .setsize -unknown- -unknown-
1010 .if \n[shark] .setsize 4 7
1011 .if \n[sparc] .setsize 2 4
1012 .if \n[sparc64] .setsize 4 10
1013 .if \n[sun2] .setsize 1 2
1014 .if \n[sun3] .setsize 1 2
1015 .if \n[vax] .setsize 2 3
1016 .if \n[x68k] .setsize 2 3
1017 .showsize
1018 .\} \" !\n[xen]
1019 .\} \" !\n[evbppc]
1020 .\} \" !\n[sparc64]
1021 .\} \" !\n[sparc]
1022 .\} \" !\n[sgimips]
1023 .\} \" !\n[macppc]
1024 .\} \" !\n[mac68k]
1025 .\} \" !\n[evbarm]
1026 .\} \" !\n[atari]
1028 .It Sy man
1029 This set includes all of the manual pages for the
1030 binaries and other software contained in the
1031 .Sy base
1032 set.
1033 Note that it does not include any of the manual pages
1034 that are included in the other sets.
1035 .\" MI
1036 .showsize 12 50
1038 .It Sy misc
1039 This set includes the system dictionaries,
1040 the typesettable document set, and other files from
1041 .Pa /usr/share .
1042 .\" MI
1043 .showsize 4 13
1045 .It Sy text
1046 This set includes
1047 .Nx Ns 's
1048 text processing tools, including
1049 .Xr groff 1 ,
1050 all related programs, and their manual pages.
1051 .\" Shareable within MACHINE_ARCH (NIH)
1052 .if \n[acorn26] .setsize 3 10
1053 .if \n[acorn32] .setsize 3 10
1054 .if \n[algor] .setsize 4 12
1055 .if \n[alpha] .setsize 4 12
1056 .if \n[amd64] .setsize 4 11
1057 .if \n[amiga] .setsize 3 10
1058 .if \n[arc] .setsize 4 12
1059 .if \n[atari] .setsize 3 10
1060 .if \n[cats] .setsize 3 10
1061 .if \n[cesfic] .setsize 3 10
1062 .if \n[cobalt] .setsize 4 12
1063 .if \n[dreamcast] .setsize 3 10
1064 .if \n[evbarm] .setsize 3 10
1065 .if \n[evbmips] .setsize 4 12
1066 .if \n[evbppc] .setsize 4 11
1067 .if \n[evbsh3] .setsize 3 10
1068 .if \n[hp300] .setsize 3 10
1069 .if \n[hp700] .setsize 4 11
1070 .if \n[hpcarm] .setsize 3 10
1071 .if \n[hpcmips] .setsize 4 12
1072 .if \n[hpcsh] .setsize 3 10
1073 .if \n[i386] .setsize 3 10
1074 .if \n[ibmnws] .setsize 4 11
1075 .if \n[iyonix] .setsize 3 10
1076 .if \n[landisk] .setsize 3 10
1077 .if \n[luna68k] .setsize 3 10
1078 .if \n[mac68k] .setsize 3 10
1079 .if \n[macppc] .setsize 4 11
1080 .if \n[mipsco] .setsize 4 12
1081 .if \n[mmeye] .setsize 3 10
1082 .if \n[mvme68k] .setsize 3 10
1083 .if \n[mvmeppc] .setsize 4 11
1084 .if \n[netwinder] .setsize 3 10
1085 .if \n[news68k] .setsize 3 10
1086 .if \n[newsmips] .setsize 4 12
1087 .if \n[next68k] .setsize 3 10
1088 .if \n[ofppc] .setsize 4 11
1089 .if \n[pmax] .setsize 4 12
1090 .if \n[prep] .setsize 4 11
1091 .if \n[sandpoint] .setsize 4 11
1092 .if \n[sbmips] .setsize 4 12
1093 .if \n[sgimips] .setsize 4 12
1094 .if \n[shark] .setsize 3 10
1095 .if \n[sparc] .setsize 3 10
1096 .if \n[sparc64] .setsize 3 11
1097 .if \n[sun2] .setsize 5 15
1098 .if \n[sun3] .setsize 3 10
1099 .if \n[vax] .setsize 3 10
1100 .if \n[x68k] .setsize 3 10
1101 .showsize
1103 .tag) \" sets
1106 .\" ---------------------------- X SETS
1109 maintains its own set of sources for the X Window System in order to
1110 assure tight integration and compatibility.
1111 .ie \n[sun2] \{\
1112 .Nx*M
1113 currently does not ship with an X server or X clients.
1115 .el \{\
1116 These sources are based on
1117 .ie \n[i386]:\n[amd64]:\n[macppc]:\n[sgimips]:\n[sparc64]:\n[shark] \{\
1118 X.Org.
1120 .el \{\
1121 XFree86 4.5.0.
1123 Binary sets for the X Window System are distributed with
1124 .Nx .
1125 The sets are:
1126 .(tag xserver \" x sets
1128 .It Sy xbase
1129 The basic files needed for a complete X
1130 client environment.
1131 This does not include the X servers.
1132 .\" Shareable within MACHINE_ARCH, except atari (NIH)
1133 .if \n[acorn26] .setsize 7 20
1134 .if \n[acorn32] .setsize 7 20
1135 .if \n[algor] .setsize 7 23
1136 .if \n[alpha] .setsize 8 25
1137 .if \n[amd64] .setsize 8 24
1138 .if \n[amiga] .setsize 6 19
1139 .if \n[arc] .setsize 7 23
1140 .if \n[atari] .setsize 6 19
1141 .if \n[cats] .setsize 7 20
1142 .if \n[cesfic] .setsize 6 19
1143 .if \n[cobalt] .setsize 7 23
1144 .if \n[dreamcast] .setsize 7 19
1145 .if \n[evbarm] .setsize 7 20
1146 .if \n[evbmips] .setsize 7 23
1147 .if \n[evbppc] .setsize 7 21
1148 .if \n[evbsh3] .setsize 7 19
1149 .if \n[hp300] .setsize 6 19
1150 .if \n[hp700] .setsize 8 22
1151 .if \n[hpcarm] .setsize 7 20
1152 .if \n[hpcmips] .setsize 7 23
1153 .if \n[hpcsh] .setsize 7 19
1154 .if \n[i386] .setsize 7 21
1155 .if \n[ibmnws] .setsize 7 21
1156 .if \n[iyonix] .setsize 7 20
1157 .if \n[landisk] .setsize 7 19
1158 .if \n[luna68k] .setsize 6 19
1159 .if \n[mac68k] .setsize 6 19
1160 .if \n[macppc] .setsize 8 23
1161 .if \n[mipsco] .setsize 7 23
1162 .if \n[mmeye] .setsize 7 19
1163 .if \n[mvme68k] .setsize 6 19
1164 .if \n[mvmeppc] .setsize 7 21
1165 .if \n[netwinder] .setsize 7 20
1166 .if \n[news68k] .setsize 6 19
1167 .if \n[newsmips] .setsize 7 23
1168 .if \n[next68k] .setsize 6 19
1169 .if \n[ofppc] .setsize 7 21
1170 .if \n[pmax] .setsize 7 23
1171 .if \n[prep] .setsize 7 21
1172 .if \n[sandpoint] .setsize 7 21
1173 .if \n[sbmips] .setsize 7 23
1174 .if \n[sgimips] .setsize 8 25
1175 .if \n[shark] .setsize 7 22
1176 .if \n[sparc] .setsize 7 20
1177 .if \n[sparc64] .setsize 8 25
1178 .if \n[sun2] .setsize -unknown- -unknown-
1179 .if \n[sun3] .setsize 6 19
1180 .if \n[vax] .setsize 6 18
1181 .if \n[x68k] .setsize 6 19
1182 .showsize
1184 .It Sy xcomp
1185 The extra libraries and include files needed to compile X source code.
1186 .\" Shareable within MACHINE_ARCH (NIH)
1187 .if \n[acorn26] .setsize 14 48
1188 .if \n[acorn32] .setsize 14 48
1189 .if \n[algor] .setsize 11 42
1190 .if \n[alpha] .setsize 16 70
1191 .if \n[amd64] .setsize 16 62
1192 .if \n[amiga] .setsize 11 43
1193 .if \n[arc] .setsize 11 42
1194 .if \n[atari] .setsize 11 43
1195 .if \n[cats] .setsize 14 49
1196 .if \n[cesfic] .setsize 11 43
1197 .if \n[cobalt] .setsize 11 42
1198 .if \n[dreamcast] .setsize 13 43
1199 .if \n[evbarm] .setsize 14 48
1200 .if \n[evbmips] .setsize 11 42
1201 .if \n[evbppc] .setsize 13 48
1202 .if \n[evbsh3] .setsize 13 43
1203 .if \n[hp300] .setsize 11 43
1204 .if \n[hp700] .setsize 15 51
1205 .if \n[hpcarm] .setsize 14 48
1206 .if \n[hpcmips] .setsize 11 42
1207 .if \n[hpcsh] .setsize 13 43
1208 .if \n[i386] .setsize 14 48
1209 .if \n[ibmnws] .setsize 13 48
1210 .if \n[iyonix] .setsize 14 48
1211 .if \n[landisk] .setsize 13 43
1212 .if \n[luna68k] .setsize 11 43
1213 .if \n[mac68k] .setsize 11 43
1214 .if \n[macppc] .setsize 16 55
1215 .if \n[mipsco] .setsize 11 42
1216 .if \n[mmeye] .setsize 13 43
1217 .if \n[mvme68k] .setsize 11 43
1218 .if \n[mvmeppc] .setsize 13 48
1219 .if \n[netwinder] .setsize 14 48
1220 .if \n[news68k] .setsize 11 43
1221 .if \n[newsmips] .setsize 11 42
1222 .if \n[next68k] .setsize 11 43
1223 .if \n[ofppc] .setsize 13 48
1224 .if \n[pmax] .setsize 11 42
1225 .if \n[prep] .setsize 13 48
1226 .if \n[sandpoint] .setsize 13 48
1227 .if \n[sbmips] .setsize 11 42
1228 .if \n[sgimips] .setsize 12 47
1229 .if \n[shark] .setsize 16 55
1230 .if \n[sparc] .setsize 13 47
1231 .if \n[sparc64] .setsize 16 65
1232 .if \n[sun2] .setsize -unknown- -unknown-
1233 .if \n[sun3] .setsize 11 43
1234 .if \n[vax] .setsize 8 34
1235 .if \n[x68k] .setsize 11 43
1236 .showsize
1238 .It Sy xfont
1239 Fonts needed by the X server and by X clients.
1240 .if \n[acorn26] .setsize 31 39
1241 .if \n[acorn32] .setsize 31 39
1242 .if \n[algor] .setsize 31 39
1243 .if \n[alpha] .setsize 31 39
1244 .if \n[amd64] .setsize 32 74
1245 .if \n[amiga] .setsize 31 39
1246 .if \n[arc] .setsize 31 39
1247 .if \n[atari] .setsize 31 39
1248 .if \n[cats] .setsize 31 39
1249 .if \n[cesfic] .setsize 31 39
1250 .if \n[cobalt] .setsize 31 39
1251 .if \n[dreamcast] .setsize 31 39
1252 .if \n[evbarm] .setsize 31 39
1253 .if \n[evbmips] .setsize 31 39
1254 .if \n[evbppc] .setsize 31 39
1255 .if \n[evbsh3] .setsize 31 39
1256 .if \n[hp300] .setsize 31 39
1257 .if \n[hp700] .setsize 31 39
1258 .if \n[hpcarm] .setsize 31 39
1259 .if \n[hpcmips] .setsize 31 39
1260 .if \n[hpcsh] .setsize 31 39
1261 .if \n[i386] .setsize 32 74
1262 .if \n[ibmnws] .setsize 31 39
1263 .if \n[iyonix] .setsize 31 39
1264 .if \n[landisk] .setsize 31 39
1265 .if \n[luna68k] .setsize 31 39
1266 .if \n[mac68k] .setsize 31 39
1267 .if \n[macppc] .setsize 32 74
1268 .if \n[mipsco] .setsize 31 39
1269 .if \n[mmeye] .setsize 31 39
1270 .if \n[mvme68k] .setsize 31 39
1271 .if \n[mvmeppc] .setsize 31 39
1272 .if \n[netwinder] .setsize 31 39
1273 .if \n[news68k] .setsize 31 39
1274 .if \n[newsmips] .setsize 31 39
1275 .if \n[next68k] .setsize 31 39
1276 .if \n[ofppc] .setsize 31 39
1277 .if \n[pmax] .setsize 31 39
1278 .if \n[prep] .setsize 31 39
1279 .if \n[sandpoint] .setsize 31 39
1280 .if \n[sbmips] .setsize 31 39
1281 .if \n[sgimips] .setsize 32 74
1282 .if \n[shark] .setsize 32 74
1283 .if \n[sparc] .setsize 31 39
1284 .if \n[sparc64] .setsize 32 74
1285 .if \n[sun2] .setsize -unknown- -unknown-
1286 .if \n[sun3] .setsize 31 39
1287 .if \n[vax] .setsize 31 39
1288 .if \n[x68k] .setsize 31 39
1289 .showsize
1291 .It Sy xetc
1292 Configuration files for X which could be locally modified.
1293 .setsize 1 1
1294 .showsize
1296 .It Sy xserver
1297 The X server. 
1298 .if \n[acorn32] \{\
1299 This includes Xarm32VIDC and Xprt servers.
1301 .if \n[atari] \{\
1302 Please consult the X specific section in the atari FAQ as to which server
1303 you should use.
1305 .if \n[hpcmips] \{\
1306 This includes the Xhpc server which supports 256 and 65536 colors, with man pages.
1308 .if \n[i386] \{\
1309 This includes the modular Xorg server.
1311 .if \n[mac68k] \{\
1312 This includes the Xmac68k
1313 .Em monochrome
1314 server with man pages.
1316 .if \n[macppc] \{\
1317 This includes the modular Xorg server.
1319 .if \n[pmax] \{\
1320 This includes the Xpmax server with man page.
1322 .if \n[shark] \{\
1323 This includes the modular Xorg and Xvfb servers.
1325 .if \n[sparc] \{\
1326 This includes Xsun, Xsun24, XsunMono and Xvfb servers with man pages.
1328 .if \n[sparc64] \{\
1329 This includes the modular Xorg and Xvfb servers.
1331 .if \n[x68k] \{\
1332 This includes the X68k and Xprt
1333 servers with man pages and the runtime configuration file.
1336 .if \n[acorn26] .setsize 5 12
1337 .if \n[acorn32] .setsize 6 13
1338 .if \n[algor] .setsize 5 15
1339 .if \n[alpha] .setsize 8 19
1340 .if \n[amd64] .setsize 14 44
1341 .if \n[amiga] .setsize 5 11
1342 .if \n[arc] .setsize 5 15
1343 .if \n[atari] .setsize 4 10
1344 .if \n[cats] .setsize 11 28
1345 .if \n[cesfic] .setsize 4 10
1346 .if \n[cobalt] .setsize 5 15
1347 .if \n[dreamcast] .setsize 5 10
1348 .if \n[evbarm] .setsize 5 12
1349 .if \n[evbmips] .setsize 5 15
1350 .if \n[evbppc] .setsize 5 12
1351 .if \n[evbsh3] .setsize 5 9
1352 .if \n[hp300] .setsize 4 10
1353 .if \n[hp700] .setsize 5 13
1354 .if \n[hpcarm] .setsize 6 13
1355 .if \n[hpcmips] .setsize 6 17
1356 .if \n[hpcsh] .setsize 5 11
1357 .if \n[i386] .setsize 12 34
1358 .if \n[ibmnws] .setsize 5 12
1359 .if \n[iyonix] .setsize 5 12
1360 .if \n[landisk] .setsize 5 9
1361 .if \n[luna68k] .setsize 4 10
1362 .if \n[mac68k] .setsize 5 13
1363 .if \n[macppc] .setsize 12 34
1364 .if \n[mipsco] .setsize 5 15
1365 .if \n[mmeye] .setsize 5 9
1366 .if \n[mvme68k] .setsize 4 10
1367 .if \n[mvmeppc] .setsize 5 12
1368 .if \n[netwinder] .setsize 10 25
1369 .if \n[news68k] .setsize 4 10
1370 .if \n[newsmips] .setsize 6 16
1371 .if \n[next68k] .setsize 4 10
1372 .if \n[ofppc] .setsize 10 27
1373 .if \n[pmax] .setsize 6 16
1374 .if \n[prep] .setsize 5 12
1375 .if \n[sandpoint] .setsize 5 12
1376 .if \n[sbmips] .setsize 5 15
1377 .if \n[sgimips] .setsize 7 21
1378 .if \n[shark] .setsize 10 26
1379 .if \n[sparc] .setsize 13 35
1380 .if \n[sparc64] .setsize 12 42
1381 .if \n[sun2] .setsize -unknown- -unknown-
1382 .if \n[sun3] .setsize 6 16
1383 .if \n[vax] .setsize 4 9
1384 .if \n[x68k] .setsize 4 11
1385 .showsize
1387 .tag) \" x sets
1389 .\} \" !\n[sun2]
1392 .\" ---------------------------- MI DISCUSSION OF BINARY SETS
1396 The \*M binary distribution sets are distributed as gzipped tar files
1397 named with the extension
1398 .Sy .tgz ,
1399 e.g.
1400 .Pa base.tgz .
1404 The instructions given for extracting the source sets work equally
1405 well for the binary sets, but it is worth noting that if you use that
1406 method, the filenames stored in the sets are relative and therefore
1407 the files are extracted
1408 .Em below the current directory .
1409 Therefore, if you want to extract the binaries into your system, i.e.
1410 replace the system binaries with them, you have to run the
1411 .Ic "tar -xzpf"
1412 command from the root directory (
1413 .Pa / 
1414 ) of your system.
1417 .\" ---------------------------- MD DISCUSSION
1420 .if \n[acorn26] \{\
1422 There is a copy of the
1423 .Nx Ns /acorn26
1424 bootloader,
1425 .Ic boot26 ,
1426 in the
1427 .Pa installation/misc
1428 subdirectory.
1429 This is a RISC OS relocatable module, and should have its file
1430 type set to ffa (Module) once it's been copied to a RISC OS system.
1434 .if \n[atari] \{\
1436 Additional kernels to those included in the distribution sets may be found
1437 in the
1438 .Pa atari/binary/kernel
1439 subdirectory of the
1441 \*V distribution tree.
1442 These kernels are generally named something like
1443 .Pa netbsd-BOOT.gz
1444 or some other suitable name.
1445 Please note that these kernels are simply gzipped and are not in tar archives.
1447 There are six atari floppy images to be found in the
1448 .Pa atari/installation/floppies
1449 subdirectory of the
1451 \*V distribution.
1452 Three of them are bootable
1453 .Tn TOS
1454 kernel floppies and the other
1455 three are installation floppies.
1456 They are described in more detail below.
1457 There are gzipped versions of each available, for easier downloading.
1458 (The gzipped versions have the
1459 .Pa \&.gz
1460 extension added to their names.)
1461 .(tag indent \" atari
1462 .It Em Bootable\ Kernel\ floppies
1463 These
1464 .Tn TOS
1465 disks contains the
1466 .Tn TOS
1467 support programs (like
1468 .Ic loadbsd.ttp
1470 .Ic chg_pid.ttp
1471 \(em see below) and a kernel.
1472 They are setup such that you can insert them into
1473 your floppy drive, and start the programs from GEM.
1475 For the TT030 and Falcon, the (720 KB) floppy is named
1476 .Pa boot.fs
1478 the kernel supplied is
1479 .Li BOOT .
1480 For the Hades, you need the
1481 .Pa hades-boot.fs
1482 floppy (1.44 MB), the kernel is
1483 .Li HADES .
1484 For the Milan, you need the
1485 .Pa milan-boot.fs
1486 floppy (1.44 MB), the kernel is MILAN-PCIIDE.
1487 .It Em Installation\ floppy:
1488 This disk contains a
1490 root file system setup to help
1491 you install the rest of
1492 .Nx .
1493 This includes formatting
1494 and mounting your
1495 .Pa /
1496 (root) and
1497 .Pa /usr
1498 partitions and getting
1499 ready to extract (and possibly first fetching) the distribution
1500 sets.
1501 There is enough on this file system to allow you to
1502 make a slip connection, configure an ethernet, mount an NFS
1503 file system or ftp.
1504 You can also load distribution sets from a SCSI tape or from one of
1505 your existing
1506 .Tn GEMDOS
1507 partitions.
1509 The floppies meant for 720 KB disks are named
1510 .Pa miniroot.fs.1
1512 .Pa miniroot.fs.2 .
1513 There is also an image for an 1.44 MB disk:
1514 .Pa miniroot.fs .
1515 .tag) \" atari
1517 There are also
1518 .Tn TOS
1519 utilities in the
1520 .Pa atari/installation/misc
1521 subdirectory, which you will need to get
1522 .Nx*M
1523 up-and-running.
1524 .(bullet
1526 .Ic gzip.ttp
1527 program allows you to uncompress .gz images.
1528 The usage is:
1530 .Dl Ic "gzip.ttp -d filename.gz"
1533 .Ic rawwrite.ttp
1534 program allows you to create the installation
1535 floppy disks from the files in the
1536 .Pa atari/floppies
1537 directory.
1540 .Ic aptck.ttp
1541 program reads the partition tables present on a
1542 given disk and tries to interpret then the same way the
1544 kernel does.
1545 If you have a disk on which
1546 .Tn GEMDOS
1549 are to co-exist, It is a good idea to run this before you begin the
1550 .Nx*M
1551 installation just to check that the kernel's view
1552 of the partition tables agree with
1553 .Tn GEMDOS Ns 's
1554 view.
1555 If you have more than 3 partitions defined on a disk you will notice that the
1556 .Nx*M
1557 partition starts one sector after the
1558 .Tn GEMDOS
1559 partition.
1560 This is to allow space for the auxiliary root for
1561 the 4th and subsequent partitions.
1564 .Ic loadbsd.ttp
1565 program loads the
1566 .Nx*M
1567 kernel from
1568 .Tn TOS
1570 .Tn MiNT ,
1571 .Tn MultiTOS ,
1572 etc.).
1575 .Ic chg_pid.ttp
1576 program can be used to change the id of an
1577 .Tn AHDI
1578 compatible partition.
1579 This allows you to reserve a partition for use by
1580 .Nx*M
1581 (id: NBD), or for use as a swap (id: SWP) partition.
1584 .Ic file2swp.ttp
1585 program can be used to transfer an installation file system image, like
1586 .Pa sysinst.fs
1587 to a partition with id SWP.
1588 In this way, you can run the installation from the swap partition
1589 instead of a memory disk.
1590 This is a necessity for small memory systems.
1591 .bullet)
1597 .if \n[hpcmips] \{\
1599 Additional kernels to those included in the distribution sets may be found
1600 in the
1601 .Pa hpcmips/binary/kernels
1602 subdirectory of the
1604 \*V distribution tree.
1605 These kernels are generally named something like
1606 .Pa netbsd-GENERIC.gz
1607 or some other suitable name.
1608 Please note that these kernels are simply gzipped and are not in tar archives.
1611 .Tn "Windows CE" Ns No -based utilities
1612 necessary for installing and running
1615 be found in the
1616 .Pa hpcmips/installation/
1617 subdirectory of the
1619 \*V distribution tree.
1620 The important files in this directory are as follows:
1623 .(tag pbsdboot1.exe
1624 .It Pa netbsd.gz
1625 .Nx*M
1626 kernel with system installer
1627 .Pq Ic sysinst .
1628 This kernel runs on Vr41xx and TX3922 CPUs only.
1629 .It Pa netbsd-TX3912.gz
1630 .Nx*M
1631 kernel with system installer
1632 .Pq Ic sysinst .
1633 This kernel runs on TX3912 CPU only.
1634 .It Pa hpcboot.exe
1636 .Nx*M
1637 boot loader utility.
1638 This program is used to boot the
1640 kernel from within
1641 .Tn "Windows CE"
1642 (version 2.11 and later).
1644 .Em 111 KB
1645 .It Pa pbsdboot.exe
1647 .Nx*M
1648 boot loader utility.
1649 This program is used to boot the
1651 kernel from within
1652 .Tn "Windows CE"
1653 (version 2.0 and later).
1655 .Em 176 KB
1656 .It Pa pbsdboot1.exe
1658 .Nx*M
1659 boot loader utility.
1660 This program is used to boot the
1662 kernel from within
1663 .Tn "Windows CE"
1664 (version 1.01).
1666 .Em 191 KB
1667 .tag)
1669 These
1670 .Pa *.exe
1671 files are
1672 .Tn "Windows CE
1673 binaries.
1674 If you need them,
1675 the sources for these utilities are in the
1676 .Pa src/arch/hpc/stand/
1677 and the
1678 .Pa src/arch/hpcmips/stand/
1679 directories.
1683 .if \n[mac68k] \{\
1685 Kernels suitable for booting from an AppleShare server may be found
1686 in the
1687 .Pa mac68k/binary/kernels
1688 subdirectory of the
1690 \*V distribution tree.
1691 These kernels are generally named something like
1692 .Pa netbsd-GENERIC.gz
1693 and can be booted as-is by the
1694 .Nx*M
1695 Booter utility, if desired.
1696 Please note that these kernels are simply gzipped and are not in tar archives.
1699 .Tn Mac OS
1700 based utilities necessary for installing and running
1703 be found in the
1704 .Pa mac68k/installation/misc
1705 subdirectory of the
1707 \*V distribution tree.
1708 The important files in this directory are as follows:
1710 .(tag Installer.sea.hqx
1711 .It Pa Booter.sea.hqx
1713 .Nx*M
1714 Booter utility.
1715 This program is used to boot the
1717 kernel from within
1718 .Tn Mac OS .
1720 .Em 141 KB archived
1721 .It Pa Installer.sea.hqx
1723 .Nx*M
1724 Installer utility.
1725 This program is used to install the distribution sets onto your
1727 partition(s).
1728 This utility is used only in a Traditional method
1729 installation; it is not used or required for an installation using
1731 .Ic sysinst
1732 method.
1734 .Em 147 KB archived
1735 .It Pa Mkfs.sea.hqx
1736 The Mkfs utility.
1737 This program is used to format your chosen partitions so that they
1738 can be used with
1739 .Nx .
1740 This utility is used only in a Traditional method
1741 installation; it is not used or required for an installation using
1743 .Ic sysinst
1744 method.
1746 .Em 76 KB archived
1747 .tag)
1749 These files are all BinHexed, self-extracting archives.
1750 If you need them, the sources for these utilities are in the
1751 .Pa src
1752 subdirectory.
1755 .if \n[mvme68k] \{\
1757 The following are included in the
1758 .Pa mvme68k/installation
1759 directory:
1761 .(tag miniroot/
1762 .It Pa miniroot/
1763 .(Note
1765 .Ic sysinst
1766 method of installation is the preferred method for installing
1767 .Nx*M .
1768 .Em The Traditional method of installation is deprecated
1769 .Em and will be removed in a future release.
1770 Some other important differences between the two installation methods are:
1771 .(bullet
1772 The Installer and Mkfs utilities are not used if the installation is done
1773 using the
1774 .Ic sysinst
1775 method via booting an Installation Kernel.
1777 Mkfs creates a 4.3BSD "old" format file system.
1778 This is the only file system format understood by the Installer.
1780 .Ic sysinst
1781 process creates "new" file systems which can't be processed by Mkfs
1782 or the Installer.
1784 The Installer (and probably Mkfs) is known to have problems with
1785 BSD file systems that are larger than 1 GB or extend beyond the 1 GB
1786 physical limit.
1787 Keep this in mind if doing a Traditional method
1788 installation with these utilities.
1790 The Booter is known to have problems booting from a NetBSD file system
1791 if the inode of the kernel file is too large.
1792 For large disks it is advisable to have a small root partition and one or
1793 more usr-type partitions for other files.
1794 This ensures the inode of the kernel in the root file system will be small.
1796 The Booter is designed to work with 4.3BSD "old" file systems, but there
1797 are enough similarities between the "old" and "new" file system formats in the
1798 first few hundred blocks that the Booter can usually boot a Kernel from a
1799 4.3BSD new file system.
1800 If you choose to use "new" file system formats, it is advisable to use a
1801 small root partition and one or more usr-type partitions for other files.
1802 This is the default layout used by
1803 .Ic sysinst .
1804 .bullet)
1805 .Note)
1806 .       (tag miniroot.gz
1807 .       It Pa miniroot.gz
1808 A copy of the miniroot file system.
1809 This file system image is copied into the swap partition of the disk which
1810 you intend to boot
1812 from.
1813 Normally, this step will be performed manually from the ramdisk boot
1814 environment.
1815 .       tag)
1816 .tag)
1818 .(tag miniroot/
1819 .It Pa netboot/
1820 .       (tag sboot
1821 .       It Pa sboot
1822 An MVME147 bootstrap program in Motorola S-Record format.
1823 This is required when you wish to boot an MVME147 over the network since
1824 the ROM has no built-in network support.
1825 Instructions for getting this program into memory are discussed later.
1826 .       tag)
1827 .       (tag netboot
1828 .       It Pa netboot
1829 A standalone 2nd stage bootstrap program loaded over the network via TFTP.
1830 This is responsible for fetching and starting the
1833 kernel from an NFS server.
1834 .       tag)
1835 .tag)
1837 .(tag tapeimage/
1838 .It Pa tapeimage/
1839 .       (tag stboot
1840 .       It Pa stboot
1841 This file contains a boot sector for Motorola MVME boards.
1842 It must be the first file written to a tape in order to make the tape bootable.
1843 .       tag)
1844 .       (tag bootst
1845 .       It Pa bootst
1846 This file contains a bootstrap program which knows how to load the
1849 ramdisk image from tape.
1850 This must be the second file written to the tape.
1851 .       tag)
1852 .       (tag netbsd-RAMDISK.gz
1853 .       It Pa netbsd-RAMDISK.gz
1854 This is the
1857 ramdisk image.
1858 It contains a
1859 .Li GENERIC
1860 kernel and a built in RAMDISK
1861 with just enough tools to partition a disk, dump the miniroot kernel
1862 to it and make the disk bootable.
1863 This must be the third file written to the tape.
1864 .       tag)
1865 .tag)
1866 .\} \" \n[mvme68k]
1869 .if \n[sgimips] \{\
1871 The following are included in the
1872 .Pa sgimips/installation
1873 directory:
1875 .(tag diskimage/
1876 .It Pa diskimage/
1877 .       (tag diskimage.tgz
1878 .       It Pa diskimage.gz
1879 FFS disk image of the installation filesystem.
1880 .       tag)
1881 .It Pa netboot/
1882 .       (tag diskimage.tgz
1883 .       It Pa diskimage.tgz
1884 Minimal file set necessary for NFS-root installations; to be extracted on the 
1885 NFS server.
1886 .       tag)
1887 .tag)
1891 The following are included in the
1892 .Pa sgimips/binary/kernel
1893 directory:
1895 .(tag netbsd-INSTALL32_IPxx.symbols.gz
1896 .It Pa netbsd.ecoff-GENERIC32_IPxx.gz
1897 An ECOFF
1898 version of the 
1899 .Li GENERIC32_IPxx
1900 kernel (gzipped).  This kernel can be used when booting machines
1901 whose PROMs do not understand the ELF binary format.
1902 .It Pa netbsd-INSTALL32_IPxx.gz
1903 A gzipped
1904 .Li INSTALL32_IPxx
1905 kernel, which includes an embedded ramdisk with the installation tools.
1906 .It Pa netbsd-INSTALL32_IPxx.ecoff.gz
1907 An ECOFF version of the
1908 .Li netbsd-INSTALL32_IPxx kernel (also gzipped).
1909 .It Pa netbsd-INSTALL32_IPxx.symbols.gz
1910 Symbols for
1911 .Pa netbsd-INSTALL32_IPxx.gz .
1912 .tag)
1915 .if \n[sparc] \{\
1916 .(Note
1917 The distribution cannot be extracted using the
1918 .Tn SunOS
1919 .Ic tar
1920 program
1921 .Note)
1925 .if \n[sun2] \{\
1927 There is a collection of Sun2 kernels in the
1928 .Pa \*M/binary/kernel
1929 subdirectory of the
1931 \*V distribution.
1932 The one named
1933 .Pa netbsd-RAMDISK.gz
1934 contain a root file system image and should only be used for the
1935 initial installation.
1936 The others are included for convenience.
1937 (Most people will want to use
1938 .Pa netbsd-GENERIC.gz
1940 .Pa netbsd-FOURMEG.gz
1941 as appropriate.)
1942 Please note that these kernels are simply gzipped and are not tar archives.
1945 .if \n[sun3] \{\
1947 There is a collection of Sun3 and Sun3X kernels in the
1948 .Pa \*M/binary/kernels
1949 subdirectory of the
1951 \*V distribution.
1952 The ones named
1953 .Pa netbsd-ramdisk*.gz
1954 contain a root file system image and should only be used for the
1955 initial installation.
1956 The others are included for convenience.
1957 (Most people will want to use
1958 .Pa netbsd-generic.gz
1960 .Pa netbsd-generic3x.gz
1961 as appropriate.)
1962 Please note that these kernels are simply gzipped and are not tar archives.