contents revision 1.8
1	$NetBSD: contents,v 1.8 1999/01/25 23:34:22 garbled Exp $	
2
3The hp300-specific portion of the NetBSD _VER release is found in the
4"hp300" subdirectory of the distribution.  That subdirectory is laid
5out as follows:
6
7.../NetBSD-_VER/hp300/
8	SOURCE_DATE			A file containing the date, in UTC,
9					of the source code from which the
10					release or snapshot was built, in the
11					default format produced by the command:
12					`date -u`.
13
14	INSTALL				Installation notes; this file.
15
16	binary/
17		kernel/			Suitably named, gzipped hp300 kernels;
18					see below.
19
20		security/		Security-related hp300 binaries;
21					see below.
22
23		sets/			hp300 binary distribution sets;
24					see below.
25
26	installation/
27		miniroot/		hp300 miniroot images; see below.
28
29		misc/			Miscellaneous hp300 installation
30					helper utilities; see installation
31					section below.
32
33The NetBSD/hp300 binary distribution sets contain the binaries which
34comprise the NetBSD _VER release for the hp300.  There are eight binary
35distribution sets, and the "security" distribution set.  The binary
36distribution sets can be found in the "hp300/binary/sets" subdirectory of
37the NetBSD _VER distribution tree, and are as follows:
38
39	base	The NetBSD/hp300 _VER base binary distribution.
40		You MUST install this distribution set.  It contains the
41		base NetBSD utilities that are necessary for the
42		system to run and be minimally functional.  It
43		includes shared library support, and excludes
44		everything described below.
45		[ 9.2M gzipped, 26.4M uncompressed ]
46
47	comp	The NetBSD/hp300 Compiler tools.  All of the tools
48		relating to C and C++.  This set includes the system
49		include files (/usr/include), the linker, the compiler
50		tool chain, and the various system libraries (except
51		the shared libraries, which are included as part of the
52		base set).  This set also includes the manual pages for
53		all of the utilities it contains, as well as the system
54		call and library manual pages.
55		[ 6.8M gzipped, 23.9M uncompressed ]
56
57	etc	This distribution set contains the system
58		configuration files that reside in /etc and in several other
59		places. This set MUST be installed if you are installing the
60		system from scratch, but should NOT be used if you are
61		upgrading.  (If you are upgrading, it's recommended that
62		you get a copy of this set and CAREFULLY upgrade your
63		configuration files by hand.)
64		[ 55K gzipped, 337K uncompressed ]
65
66	games	This set includes the games and their manual pages.
67		[ 2.9M gzipped, 7.5M uncompressed ]
68
69	kern	This set includes a NetBSD/hp300 _VER GENERIC kernel,
70		named "/netbsd". You MUST install this distribution set.
71		[ 547K gzipped, 1.2M uncompressed ]
72
73	man	This set includes all of the manual pages for the
74		binaries and other software contained in the base set.
75		Note that it does not include any of the manual pages
76		that are included in the other sets.
77		[ 2.5M gzipped, 10.4M uncompressed ]
78
79	misc	This set includes the system dictionaries (which
80		are rather large), the typesettable document set, and
81		man pages for other architectures which happen to be
82		installed from the source tree by default.
83		[ 2.2M gzipped, 8.4M uncompressed ]
84
85	text	This set includes NetBSD's text processing tools,
86		including groff, all related programs, and their
87		manual pages.
88		[ 1.0M gzipped, 3.4M uncompressed ]
89
90The hp300 security distribution set is named "secr" and can be found
91in the "hp300/binary/security" subdirectory of the NetBSD _VER distribution
92tree.  It contains executables which are built in the "src/domestic" portion
93if the NetBSD source tree.  It can only be found on those sites which carry
94the complete NetBSD distribution and that can legally obtain it.  (Remember,
95because of United States law, it may not be legal to distribute this set to
96locations outside of the United States and Canada.)
97[ 776K gzipped, 263K uncompressed ]
98
99Since NetBSD 1.3, binary sets for the X Window system are also
100distributed with each NetBSD release. The binaries are based on
101X11R6.3. Unfortunatly there is no R6.3 Xserver for NetBSD/hp300 yet,
102so we can only distribute the X clients this time.
103You can not yet install them using the new automated install system.
104However, they are gzipped tarfiles, just like the other sets, so you
105can always simply extract them once you have your NetBSD system installed
106and running. The sets are:
107
108	xbase		The basic files needed for a complete X
109			client environment. This does not include
110			the X servers.
111			[ 2.5M gzipped, 7.6M uncompressed ]
112
113	xcomp		The extra libraries and include files needed
114			to compile X source code.
115			[ 1.7M gzipped, 7.1M uncompressed ]
116
117	xcontrib	Programs that were contributed to X.
118			[ 183k gzipped, 686k uncompressed ]
119
120	xfont		Fonts needed by X.
121			[ 5.9M gzipped, 7.3M uncompressed ]
122
123The hp300 binary distribution sets are distributed as gzipped tar files
124named with the extension ".tgz", e.g. "base.tgz".
125Each hp300 binary distribution set also has its own checksum files, just
126as the source distribution sets do.
127
128The instructions given for extracting the source sets work equally
129well for the binary sets, but it is worth noting that if you use that
130method, the files are extracted "below" the current directory.  That
131is, if you want to extract the binaries "into" your system, i.e.
132replace the system binaries with them, you have to run the "tar xfp"
133from /.
134
135The following are included in the `hp300/installation' directory:
136
137	miniroot/
138		miniroot.fs.gz		A copy of the miniroot filesystem.
139
140	misc/
141		HP-IB.geometry		A file containing geometry for some
142					HB-IB disk drives.
143
144		SYS_INST.gz		A gzipped copy of the SYS_INST
145					miniroot installation program.
146
147		SYS_UBOOT.gz		A gzipped copy of the universal boot
148					block. Supports Network, tape and
149					disk booting. This is useful if you
150					are installing a diskless NetBSD/hp300
151					system.
152
153		rbootd.tgz		Source code for the rbootd program
154					included with NetBSD. It requires that
155					the server has a Berkeley Packet
156					Filter (bpf).  You will need to
157					compile this version of rbootd if
158					server system does not have this
159					utility already.
160
161The following are included in the `hp300/binary/kernel'directory:
162
163	netbsd.gdb.gz		A gzipped GENERIC kernel with debugging
164				symbols.
165
166	netbsd.gz		A gzipped GENERIC kernel.
167
168
169Note:	Each directory in the hp300 binary distribution also has its
170-----	own checksum files, just as the source distribution does:
171
172	All BSDSUM files are historic BSD checksums for the various files
173	in that directory, in the format produced by the command:
174	cksum -o 1 <file>.
175
176	All CKSUM files are POSIX checksums for the various files in that
177	directory, in the format produced by the command: cksum <file>.
178
179	All MD5 files are MD5 digests for the various files in that
180	directory, in the format produced by the command: cksum -m <file>.
181
182	All SYSVSUM files are historic AT&T System V UNIX checksums for
183	the various files in that directory, in the format produced by
184	the command: cksum -o 2 <file>.
185
186	The MD5 digest is the safest checksum, followed by the POSIX
187	checksum. The other two checksums are provided only to ensure
188	that the widest possible range of system can check the integrity
189	of the release files.
190