Home | History | Annotate | Line # | Download | only in hp300
contents revision 1.7
      1 	$NetBSD: contents,v 1.7 1998/01/09 18:46:15 perry 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 /.  Also note that if you upgrade or install this way, those
    134 programs that you are using at the time will NOT be replaced unless
    135 you run "tar" with the "--unlink" option.  If you follow the normal
    136 installation or upgrade procedures, this will be taken care of for
    137 you.
    138 
    139 The 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 
    165 The 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 
    173 Note:	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