contents revision 1.12
1	$NetBSD: contents,v 1.12 1998/01/14 06:39:52 scottr Exp $	
2
3The mac68k-specific portion of the NetBSD _VER release is found in the
4"mac68k" subdirectory of the distribution.  That subdirectory is laid
5out as follows:
6
7.../NetBSD-_VER/mac68k/
8			SOURCE_DATE	the date, in the default format
9					produced by the date(1) command,
10					of the source that the release was
11					built from
12
13			INSTALL		these installation notes
14
15			binary/		mac68k system binaries;
16					see below.
17
18			installation/	installation helper items
19
20The NetBSD/mac68k system binaries include the NetBSD/mac68k binary
21distribution sets, additional kernels, and security-related system
22binaries.  The NetBSD _VER release for the mac68k port comprises those
23files found in the "mac68k/binary/sets" subdirectory of the NetBSD _VER
24distribution tree.  There are seven system distribution sets, two kernel
25distribution sets, and five X distribution sets.  The files in the
26"sets" subdirectory are as follows:
27
28	base.tgz	The NetBSD/mac68k _VER base binary distribution.
29			You MUST install this distribution set.  It
30			contains the base NetBSD utilities that are
31			necessary for the system to run and be minimally
32			functional.  It includes shared library support,
33			and excludes everything described below.
34			[ 8.6M gzipped, 25.1M uncompressed ]
35
36	comp.tgz	The NetBSD/mac68k Compiler tools; all of the tools
37			relating to C and C++.  This set includes the
38			system include files (/usr/include), the linker,
39			the compiler tool chain, and the various system
40			libraries (except the shared libraries, which are
41			included as part of the base set).  This set also
42			includes the manual pages for all of the utilities
43			it contains, as well as the system call and library
44			manual pages. 
45			[ 6.2M gzipped, 21.6M uncompressed ]
46
47	etc.tgz		This distribution set contains the system
48			configuration files that reside in /etc and in
49			several other places.  This set MUST be installed
50			if you are installing the system from scratch, but
51			should NOT be used if you are upgrading.  (If you
52			are upgrading, it's recommended that you get a copy
53			of this set and CAREFULLY upgrade your
54			configuration files by hand.) 
55			[ 49K gzipped, 288K uncompressed ]
56
57	games.tgz	This set includes the games and their manual pages.
58			[ 2.8M gzipped, 7.2M uncompressed ]
59
60	kern_sbc.tgz
61	kern.tgz	The NetBSD/mac68k _VER kernel binary.  You MUST
62			install this file.  It is the kernel that you need
63			to boot the system.  If you experience SCSI-related
64			difficulties with your 68030-based system, you
65			might want to try kern_sbc.tgz instead.
66			[ 606K gzipped, 1.32M uncompressed ]
67
68	man.tgz		This set includes all of the manual pages for the
69			binaries and other software contained in the base
70			set.  Note that it does not include any of the
71			manual pages that are included in the other sets. 
72			[ 2.2M gzipped, 8.8M uncompressed ]
73
74	misc.tgz	This set includes the system dictionaries (which
75			are rather large), the typesettable document set,
76			and man pages for other architectures which happen
77			to be installed from the source tree by default. 
78			[ 2.1M gzipped, 7.6M uncompressed ]
79
80	text.tgz	This set includes NetBSD's text processing tools,
81			including groff, all related programs, and their
82			manual pages. 
83			[ 1.0M gzipped, 3.7M uncompressed ]
84
85	xbase.tgz	X clients, shared libraries, and related man pages.
86			Also includes bitmaps and miscellaneous
87			configuration files.
88			[ 2.34 M gzipped, 7.46M uncompressed ]
89
90	xcomp.tgz	Static libraries, include files (except bitmaps),
91			X config files (for xmkmf), and related man pages.
92			[ 1.57M gzipped, 6.38M uncompressed ]
93
94	xcontrib.tgz	User-contributed X binaries (e.g. xev, xload) built
95			from the X11 "contrib" sources with man pages and
96			default config files.
97			[ 178K gzipped, 661K uncompressed ]
98
99	xfont.tgz	X11 fonts.
100			[ 5.66M gzipped, 6.99M uncompressed ]
101
102	xserver.tgz	The Xmac68k _monochrome_ server with man pages.
103			[ 1.32M gzipped, 3.25M uncompressed ]
104
105The NetBSD/mac68k security distribution set is named "secr.tgz" and can be
106found in the "mac68k/binary/security" subdirectory of the NetBSD _VER
107distribution tree.  It contains the crypt libraries (for the DES encryption
108algorithm) and the binaries built from the "src/domestic" portion of the
109NetBSD source tree which depend on it.  It can only be found on those sites
110which carry the complete NetBSD distribution and that can legally obtain
111it.  (Remember, because of United States law, it may not be legal to
112distribute this set to locations outside of the United States and Canada.)
113[ 779K gzipped, 2.5M uncompressed ]
114
115The mac68k binary distribution sets are distributed as full .tar.gz files
116(with the extension .tgz because the software used to download the sets may
117incorrectly auto-unpack files ending in .gz and to accomodate systems which
118only support 3 character extensions to file names).  The instructions
119given for extracting the source sets work equally well for the binary sets,
120but it is worth noting that if you use that method, the files are extracted
121"below" the current directory.  That is, if you want to extract the
122binaries "into" your system, i.e. replace the system binaries with them,
123you have to run the "tar xpf" from /.  Also note that if you upgrade or
124install this way, those programs that you are using at the time will NOT be
125replaced.  If you follow the normal installation or upgrade procedures,
126this will be taken care of for you.
127
128Additional kernels to those included in the distribution sets may be found
129in the "mac68k/binary/kernels" subdirectory of the NetBSD _VER distribution
130tree.  These kernels are generally named something like "netbsd-GENERIC.gz"
131or some other suitable name.  Please note that these kernels are simply
132gzipped and are not in tar archives.
133
134The MacOS-based utilities necessary for installing and running NetBSD can
135be found in the "mac68k/installation/misc" subdirectory of the NetBSD
136_VER distribution tree.  The important files in this directory are as
137follows: 
138
139	Booter.sea.hqx		The NetBSD/Mac68k Booter utility.  This
140				program is used to boot the NetBSD kernel
141				from within MacOS.
142				[ 141 K archived ]
143
144	Installer.sea.hqx	The NetBSD/Mac68k Installer utility.  This
145				program is used to install the distribution
146				sets onto your NetBSD partition(s).
147				[ 147 K archived ]
148
149	Mkfs.sea.hqx		The Mkfs utility.  This program is used to
150				format your chosen partitions so that they
151				can be used with NetBSD.
152				[ 76 K archived ]
153
154These files are all binhexed, self-extracting archives.  If you need them,
155the sources for these utilities are in the "src" subdirectory.
156
157
158Note:	Each directory in the mac68k binary distribution also has its
159-----	own checksum files, just as the source distribution does:
160
161	All BSDSUM files are historic BSD checksums for the various files
162	in that directory, in the format produced by the command:
163	cksum -o 1 <file>.
164
165	All CKSUM files are POSIX checksums for the various files in that
166	directory, in the format produced by the command: cksum <file>.
167
168	All MD5 files are MD5 digests for the various files in that
169	directory, in the format produced by the command: cksum -m <file>.
170
171	All SYSVSUM files are historic AT&T System V UNIX checksums for
172	the various files in that directory, in the format produced by
173	the command: cksum -o 2 <file>.
174
175	The MD5 digest is the safest checksum, followed by the POSIX
176	checksum. The other two checksums are provided only to ensure
177	that the widest possible range of system can check the integrity
178	of the release files.
179