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