xref: /netbsd-src/distrib/notes/i386/contents (revision 6929ad87a5c37179228b21785018bbb66fe06b56)
1The i386-specific portion of the NetBSD 1.0 release is found in the
2"i386" subdirectory of the distribution.  That subdirectory is laid
3out as follows:
4
5.../NetBSD-1.0/i386/
6			INSTALL		Installation notes; this file.
7
8			binary/		i386 binary distribution sets;
9					see below.
10
11			floppies/	i386 boot and installation
12					floppies; see below.
13
14			security/	i386 security distribution;
15					see below;
16
17			utils/		Miscellaneous i386
18					installation utilities; see
19					installation section, below.
20
21There are four i386 floppy images to be found in the "i386/floppy"
22subdirectory of the NetBSD 1.0 distribution.  Two of them are bootable
23kernel-copy floppies, one is an installation floppy, and one is an
24upgrade floppy.  They are all described in more detail below.  There
25are gzipped versions of each available, for easier downloading.  (The
26gzipped versions have the ".gz" extension added to their names.)
27
28Bootable Kernel-copy floppies:
29
30	These disks contain file systems, are bootable, and have
31	enough utilities on board to copy a new kernel to your hard
32	disk once you have it partitioned for NetBSD.  They make
33	upgrading to a new kernel easy, because all you have to do is
34	get a new kernel-copy floppy with a new kernel, boot from it,
35	and confirm that you want to have the kernel copied to your
36	disk.
37
38	There are two different kernel copy floppy images,
39	"kcaha-10.fs", and "kcbt-10.fs".  They are identical except
40	that the first has the driver for the Adaptec 1542 SCSI host
41	adapter and does not contain the driver for the Buslogic 74x
42	SCSI host adapters, and vice-versa for the second.  (All other
43	drivers are present on both disks.)
44
45Installation floppy:
46
47	This disk contains the software necessary to prepare your hard
48	drive for NetBSD and install the NetBSD distribution. It is
49	not bootable, and must be used in conjunction with one of the
50	kernel-copy floppies.  This floppy is named "inst-10.fs".
51
52Upgrade floppy:
53
54	This disk contains the software to be used in upgrading the
55	system from a previous version of NetBSD.  It is not bootable,
56	and must be used in conjunction with one of the kernel-copy
57	floppies.  This floppy is named "upgr-10.fs"
58
59The NetBSD/i386 binary distribution sets contain the binaries which
60comprise the NetBSD 1.0 release for the i386.  There are seven binary
61distribution sets, and the "security" distribution set.  The binary
62distribution sets can be found in subdirectories of the "i386/binary"
63subdirectory of the NetBSD 1.0 distribution tree, and are as follows:
64
65	base10	The NetBSD/i386 1.0 base binary distribution.  You
66		MUST install this distribution set.  It contains the
67		base NetBSD utilities that are necessary for the
68		system to run and be minimally functional.  It
69		includes shared library support, and excludes
70		everything described below.
71		[ 6.2M gzipped, 16.7M uncompressed ]
72
73	comp10	The NetBSD/i386 Compiler tools.  All of the tools
74		relating to C, C++, and FORTRAN (yes, there are two!).
75		This set includes the system include files
76		(/usr/include), the linker, the compiler tool chain,
77		and the various system libraries (except the shared
78		libraries, which are included as part of the base
79		set).  This set also includes the manual pages for all
80		of the utilities it contains, as well as the system
81		call and library manual pages.
82		[ 4.2M gzipped, 12.9M uncompressed ]
83
84	etc10	This distribution set contains the system
85		configuration files that reside in /etc and in several
86		other places.  This set MUST be installed if you are
87		installing the system from scratch, but should NOT be
88		used if you are upgrading.  (If you are upgrading,
89		it's recommended that you get a copy of this set and
90		CAREFULLY upgrade your configuration files by hand.)
91		[ 50K gzipped, 263K uncompressed ]
92
93	games10	This set includes the games and their manual pages.
94		[ 1.0M gzipped, 2.7M uncompressed ]
95
96	man10	This set includes all of the manual pages for the
97		binaries and other software contained in the base set.
98		Note that it does not include any of the manual pages
99		that are included in the other sets.
100		[ 0.7M gzipped, 2.8M uncompressed ]
101
102	misc10	This set includes the system dictionaries (which are
103		rather large), the typesettable document set, and
104		man pages for other architectures which happen to be
105		installed from the source tree by default.
106		[ 1.6M gzipped, 5.6M uncompressed ]
107
108	text10	This set includes NetBSD's text processing tools,
109		including groff, all related programs, and their
110		manual pages.
111		[ 0.8M gzipped, 2.8M uncompressed ]
112
113The i386 security distribution set is named "secr10" and can be found
114in the "i386/security" subdirectory of the NetBSD 1.0 distribution
115tree.  It contains crypt.c (the source file for the DES encryption
116algorithm) and the binaries which depend on it.  It can only be found
117on those sites which carry the complete NetBSD distribution and that
118can legally obtain it.  (Remember, because of United States law, this
119distribution set may not be exported to locations outside of the
120United States and Canada.)  [ 114K gzipped, 253K uncompressed ]
121
122The i386 binary distribution sets are distributed in the same form as
123the source distribution sets; catted together, the members of a set
124form a gzipped tar file.  Each i386 binary distribution set also has
125its own "CKSUMS" file, just as the source distribution sets do.
126
127The instructions given for extracting the source sets work equally
128well for the binary sets, but it is worth noting that if you use that
129method, the files are extracted "below" the current directory.  That
130is, if you want to extract the binaries "into" your system, i.e.
131replace the system binaries with them, you have to run the "tar xfp"
132from /.  Also note that if you upgrade or install this way, those
133programs that you are using at the time will NOT be replaced.  If you
134follow the normal installation or upgrade procedures, this will be
135taken care of for you.
136