Home | History | Annotate | Line # | Download | only in hp300
contents revision 1.8
      1 	$NetBSD: contents,v 1.8 1999/01/25 23:34:22 garbled Exp $	
      2 
      3 The hp300-specific portion of the NetBSD _VER release is found in the
      4 "hp300" subdirectory of the distribution.  That subdirectory is laid
      5 out 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 
     33 The NetBSD/hp300 binary distribution sets contain the binaries which
     34 comprise the NetBSD _VER release for the hp300.  There are eight binary
     35 distribution sets, and the "security" distribution set.  The binary
     36 distribution sets can be found in the "hp300/binary/sets" subdirectory of
     37 the 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 
     90 The hp300 security distribution set is named "secr" and can be found
     91 in the "hp300/binary/security" subdirectory of the NetBSD _VER distribution
     92 tree.  It contains executables which are built in the "src/domestic" portion
     93 if the NetBSD source tree.  It can only be found on those sites which carry
     94 the complete NetBSD distribution and that can legally obtain it.  (Remember,
     95 because of United States law, it may not be legal to distribute this set to
     96 locations outside of the United States and Canada.)
     97 [ 776K gzipped, 263K uncompressed ]
     98 
     99 Since NetBSD 1.3, binary sets for the X Window system are also
    100 distributed with each NetBSD release. The binaries are based on
    101 X11R6.3. Unfortunatly there is no R6.3 Xserver for NetBSD/hp300 yet,
    102 so we can only distribute the X clients this time.
    103 You can not yet install them using the new automated install system.
    104 However, they are gzipped tarfiles, just like the other sets, so you
    105 can always simply extract them once you have your NetBSD system installed
    106 and 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 
    123 The hp300 binary distribution sets are distributed as gzipped tar files
    124 named with the extension ".tgz", e.g. "base.tgz".
    125 Each hp300 binary distribution set also has its own checksum files, just
    126 as the source distribution sets do.
    127 
    128 The instructions given for extracting the source sets work equally
    129 well for the binary sets, but it is worth noting that if you use that
    130 method, the files are extracted "below" the current directory.  That
    131 is, if you want to extract the binaries "into" your system, i.e.
    132 replace the system binaries with them, you have to run the "tar xfp"
    133 from /.
    134 
    135 The 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 
    161 The 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 
    169 Note:	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