contents revision 1.3
1The sun3-specific portion of the NetBSD 1.2 release is found in the
2"sun3" subdirectory of the distribution.  That subdirectory is laid
3out as follows:
4
5.../NetBSD-1.2/sun3/
6			INSTALL.txt	Installation notes; this file.
7
8			install/	Boot programs, a GENERIC kernel,
9					a stand-alone RAMDISK kernel,
10					and a miniroot filesystem image.
11					see below.
12
13			binary/		sun3 binary distribution sets;
14					see below.
15
16			security/	sun3 security distribution;
17					see below.
18
19.../sun3/install/
20
21The NetBSD/sun3 install distribution contains files that can be
22used to install NetBSD onto a completely "bare" sun3.  The files
23in the "sun3/install" directory are described below:
24
25	MakeBootTape	A script for creating a boot tape using
26			the other files in this directory.
27
28	miniroot.gz	A gzipped copy of the miniroot filesystem.
29			This image is to be un-gzipped and copied
30			into the swap area of a disk.
31
32	netbsd-rd.gz	A gzipped copy of the "RAMDISK kernel"
33			for installing the miniroot filesystem.
34
35	netbsd-gen.gz	A gzipped GENERIC kernel (for upgrade)
36
37	netboot		A copy of the network boot program.
38			This is useful if you are installing
39			a diskless NetBSD/sun3 system.
40
41	tapeboot	A copy of the tape boot program, used
42			as the first segment of a boot tape.
43
44These files can be used to make a boot tape suitable for installing
45NetBSD/sun3.  These files can also be used to configure an NFS server
46to support installation "over the network".  See the section "Getting
47the NetBSD System onto Useful Media" for instructions on either method.
48
49.../sun3/binary/
50
51The NetBSD/sun3 binary distribution sets contain the binaries which
52comprise the NetBSD 1.2 release for the sun3.  There are seven binary
53distribution sets, and the "security" distribution set.  The binary
54distribution sets can be found in the "sun3/binary" subdirectory of
55the NetBSD 1.2 distribution tree, and are as follows:
56
57	base12	The NetBSD/sun3 1.2 base binary distribution.  You
58		MUST install this distribution set.  It contains the
59		base NetBSD utilities that are necessary for the
60		system to run and be minimally functional.  It
61		includes shared library support, and excludes
62		everything described below.
63		[ 7.6M gzipped, 21.5M uncompressed ]
64
65	comp12	The NetBSD/sun3 Compiler tools.  All of the tools
66		relating to C and C++.  This set includes the system
67		include files (/usr/include), the linker, the compiler
68		tool chain, and the various system libraries (except
69		the shared libraries, which are included as part of the
70		base set).  This set also includes the manual pages for
71		all of the utilities it contains, as well as the system
72		call and library manual pages.
73		[ 5.4M gzipped, 17.2M uncompressed ]
74
75	etc12	This distribution set contains the system configuration
76		files that reside in /etc and in several other places.
77		This set MUST be installed if you are installing the
78		system from scratch, but should NOT be used if you are
79		upgrading.  (If you are upgrading, it's recommended that
80		you get a copy of this set and CAREFULLY upgrade your
81		configuration files by hand.)
82		[ 68K gzipped, 350K uncompressed ]
83
84	games12	This set includes the games and their manual pages.
85		[ 2.9M gzipped, 7.0M uncompressed ]
86
87	man12	This set includes all of the manual pages for the
88		binaries and other software contained in the base set.
89		Note that it does not include any of the manual pages
90		that are included in the other sets.
91		[ 0.9K gzipped, 3.5M uncompressed ]
92
93	misc12	This set includes the system dictionaries (which are
94		rather large), the typesettable document set, and
95		man pages for other architectures which happen to be
96		installed from the source tree by default.
97		[ 1.9M gzipped, 6.5M uncompressed ]
98
99	text12	This set includes NetBSD's text processing tools,
100		including groff, all related programs, and their
101		manual pages.
102		[ 0.8M gzipped, 2.9M uncompressed ]
103
104.../sun3/security/
105
106The sun3 security distribution set is named "secr12" and can be found
107in the "sun3/security" subdirectory of the NetBSD 1.2 distribution
108tree.  It contains executables which are built in the "src/domestic" portion
109if the NetBSD source tree.  It can only be found on those sites which carry
110the complete NetBSD distribution and that can legally obtain it.  (Remember,
111because of United States law, it may not be legal to distribute this set to
112locations outside of the United States and Canada.)
113[ 128K gzipped, 275K uncompressed ]
114
115The sun3 binary distribution sets are distributed as gzipped tar files.
116Each sun3 binary distribution set also has its own "CKSUMS" file, just
117as the source distribution sets do.
118
119The instructions given for extracting the source sets work equally
120well for the binary sets, but it is worth noting that if you use that
121method, the files are extracted "below" the current directory.  That
122is, if you want to extract the binaries "into" your system, i.e.
123replace the system binaries with them, you have to run the command:
124
125	tar --unlink -zxvpf set.tar.gz
126
127from /.   Note that the "--unlink" flags is very important!
128
129For best results, it is recommended that you follow the installation
130and/or upgrade procedures documented in this file.
131