Home | History | Annotate | Line # | Download | only in mvme68k
contents revision 1.5
      1 	$NetBSD: contents,v 1.5 1999/02/20 16:18:10 scw Exp $	
      2 
      3 The mvme68k-specific portion of the NetBSD _VER release is found in the
      4 "mvme68k" subdirectory of the distribution.  That subdirectory is laid
      5 out as follows:
      6 
      7 .../NetBSD-_VER/mvme68k/
      8                         INSTALL         Installation notes; this file.
      9 
     10                         installation/   Boot programs, a stand-alone
     11                                         RAMDISK kernel, and a miniroot
     12                                         filesystem image. see below.
     13 
     14                         binary/         mvme68k binary distribution sets;
     15                                         see below.
     16 
     17                         security/       mvme68k security distribution;
     18                                         see below.
     19 
     20 .../mvme68k/installation/
     21                         miniroot/       The miniroot filesystem image.
     22 
     23 			netboot/	Two programs needed to boot
     24 					mvme68k kernels over the network.
     25 
     26 			tapeimage/      Tape boot programs, and a RAMDISK
     27 					kernel.
     28 
     29 The NetBSD/mvme68k install distribution contains files that can be
     30 used to install NetBSD onto completely "bare" MVME147 and MVME167 boards.
     31 The files in the "mvme68k/installation/*" directories are described below:
     32 
     33         miniroot.gz     A gzipped copy of the miniroot filesystem.
     34                         This image is to be un-gzipped and copied
     35                         into the swap area of a disk.
     36 
     37         netbsd-rd.gz    A gzipped copy of the "RAMDISK kernel"
     38                         for installing the miniroot filesystem.
     39 
     40         stboot          A tape boot-block, in the form required to
     41                         allow the 1x7-Bug ROM to boot from tape. This
     42                         is the first segment of a boot tape.
     43 
     44         bootst          A copy of the tape boot program, used
     45                         as the second segment of a boot tape.
     46 
     47         sboot           A copy of the MVME147 serial boot program.
     48 			This is necessary if you don't have a tape
     49 			drive, but you _do_ have another system which
     50 			can act as a boot and NFS server. This is also
     51                         useful if you are installing a diskless
     52                         NetBSD/MVME147 system.
     53 
     54         netboot         A copy of the network boot program. Used
     55                         in conjunction with sboot on the MVME147 to get
     56                         your system booted over a network. The MVME167
     57 			can boot this directly using 167Bug's builtin
     58 			TFTP client.
     59 
     60 These files can be used to make a boot tape suitable for installing
     61 NetBSD/mvme68k. These files can also be used to configure an NFS server
     62 to support installation "over the network".  See the section "Getting
     63 the NetBSD System onto Useful Media" for instructions on either method.
     64 
     65 .../mvme68k/binary/sets
     66 
     67 The NetBSD/mvme68k binary distribution sets contain the binaries which
     68 comprise the NetBSD _VER release for the MVME1x7 series of boards. There
     69 are seven binary distribution sets, and the "security" distribution set.
     70 The binary distribution sets are as follows:
     71 
     72         base    The NetBSD/mvme68k _VER base binary distribution. You
     73                 MUST install this distribution set. It contains the
     74                 base NetBSD utilities that are necessary for the
     75                 system to run and be minimally functional. It includes
     76                 shared library support, and excludes everything
     77                 described below.
     78                 [ 9.2M gzipped, 26.5M uncompressed ]
     79 
     80         comp    The NetBSD/mvme68k Compiler tools. All of the tools
     81                 relating to C and C++. This set includes the system
     82                 include files (/usr/include), the linker, the compiler
     83                 tool chain, and the various system libraries (except
     84                 the shared libraries, which are included as part of the
     85                 base set). This set also includes the manual pages for
     86                 all of the utilities it contains, as well as the system
     87                 call and library manual pages.
     88                 [ 6.9M gzipped, 24.1M uncompressed ]
     89 
     90         etc     This distribution set contains the system configuration
     91                 files that reside in /etc and in several other places.
     92                 This set MUST be installed if you are installing the
     93                 system from scratch, but should NOT be used if you are
     94                 upgrading. (If you are upgrading, it's recommended that
     95                 you get a copy of this set and CAREFULLY upgrade your
     96                 configuration files by hand.)
     97                 [ 53K gzipped, 327K uncompressed ]
     98 
     99         games   This set includes the games and their manual pages.
    100                 [ 2.9M gzipped, 7.5M uncompressed ]
    101 
    102         man     This set includes all of the manual pages for the
    103                 binaries and other software contained in the base set.
    104                 Note that it does not include any of the manual pages
    105                 that are included in the other sets.
    106                 [ 2.5K gzipped, 10.3M uncompressed ]
    107 
    108         misc    This set includes the system dictionaries (which are
    109                 rather large), the typesettable document set, and
    110                 man pages for other architectures which happen to be
    111                 installed from the source tree by default.
    112                 [ 2.3M gzipped, 8.7M uncompressed ]
    113 
    114         text    This set includes NetBSD's text processing tools,
    115                 including groff, all related programs, and their
    116                 manual pages.
    117                 [ 1.0M gzipped, 3.9M uncompressed ]
    118 
    119 .../mvme68k/security/
    120 
    121 The mvme68k security distribution set is named "secr" and can be found
    122 in the "mvme68k/security" subdirectory of the NetBSD _VER distribution
    123 tree. It contains executables which are built in the "src/domestic" portion
    124 of the NetBSD source tree. It can only be found on those sites which carry
    125 the complete NetBSD distribution and that can legally obtain it. (Remember,
    126 because of United States law, it may not be legal to distribute this set to
    127 locations outside of the United States and Canada.)
    128 [ 128K gzipped, 275K uncompressed ]
    129 
    130 .../mvme68k/kernel/
    131 
    132 The mvme68k kernel directory contains a gzip'ed kernel image which is
    133 compatible with both MVME147 and MVME167 boards. This should be used when
    134 upgrading from a previous version of NetBSD. Before starting the upgrade,
    135 you should unzip and copy this kernel in place of your existing /netbsd
    136 image, then reboot.
    137 
    138 The mvme68k binary distribution sets are distributed as gzipped tar files.
    139 Each mvme68k binary distribution set also has its own "CKSUMS" file, just
    140 as the source distribution sets do.
    141 
    142 The instructions given for extracting the source sets work equally
    143 well for the binary sets, but it is worth noting that if you use that
    144 method, the files are extracted "below" the current directory.  That
    145 is, if you want to extract the binaries "into" your system, i.e.
    146 replace the system binaries with them, you have to run the command:
    147 
    148         pax -zrvpe -f set.tar.gz
    149 
    150 while in the root directory of your system (/).
    151 
    152 For best results, it is recommended that you follow the installation
    153 and/or upgrade procedures documented in this file.
    154