contents revision 1.7
1	$NetBSD: contents,v 1.7 1998/01/09 18:46:15 perry 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 /.  Also note that if you upgrade or install this way, those
134programs that you are using at the time will NOT be replaced unless
135you run "tar" with the "--unlink" option.  If you follow the normal
136installation or upgrade procedures, this will be taken care of for
137you.
138
139The following are included in the `hp300/installation' directory:
140
141	miniroot/
142		miniroot.fs.gz		A copy of the miniroot filesystem.
143
144	misc/
145		HP-IB.geometry		A file containing geometry for some
146					HB-IB disk drives.
147
148		SYS_INST.gz		A gzipped copy of the SYS_INST
149					miniroot installation program.
150
151		SYS_UBOOT.gz		A gzipped copy of the universal boot
152					block. Supports Network, tape and
153					disk booting. This is useful if you
154					are installing a diskless NetBSD/hp300
155					system.
156
157		rbootd.tgz		Source code for the rbootd program
158					included with NetBSD. It requires that
159					the server has a Berkeley Packet
160					Filter (bpf).  You will need to
161					compile this version of rbootd if
162					server system does not have this
163					utility already.
164
165The following are included in the `hp300/binary/kernel'directory:
166
167	netbsd.gdb.gz		A gzipped GENERIC kernel with debugging
168				symbols.
169
170	netbsd.gz		A gzipped GENERIC kernel.
171
172
173Note:	Each directory in the hp300 binary distribution also has its
174-----	own checksum files, just as the source distribution does:
175
176	All BSDSUM files are historic BSD checksums for the various files
177	in that directory, in the format produced by the command:
178	cksum -o 1 <file>.
179
180	All CKSUM files are POSIX checksums for the various files in that
181	directory, in the format produced by the command: cksum <file>.
182
183	All MD5 files are MD5 digests for the various files in that
184	directory, in the format produced by the command: cksum -m <file>.
185
186	All SYSVSUM files are historic AT&T System V UNIX checksums for
187	the various files in that directory, in the format produced by
188	the command: cksum -o 2 <file>.
189
190	The MD5 digest is the safest checksum, followed by the POSIX
191	checksum. The other two checksums are provided only to ensure
192	that the widest possible range of system can check the integrity
193	of the release files.
194