contents revision 1.5
1	$NetBSD: contents,v 1.5 1999/02/20 16:18:10 scw Exp $	
2
3The mvme68k-specific portion of the NetBSD _VER release is found in the
4"mvme68k" subdirectory of the distribution.  That subdirectory is laid
5out 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
29The NetBSD/mvme68k install distribution contains files that can be
30used to install NetBSD onto completely "bare" MVME147 and MVME167 boards.
31The 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
60These files can be used to make a boot tape suitable for installing
61NetBSD/mvme68k. These files can also be used to configure an NFS server
62to support installation "over the network".  See the section "Getting
63the NetBSD System onto Useful Media" for instructions on either method.
64
65.../mvme68k/binary/sets
66
67The NetBSD/mvme68k binary distribution sets contain the binaries which
68comprise the NetBSD _VER release for the MVME1x7 series of boards. There
69are seven binary distribution sets, and the "security" distribution set.
70The 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
121The mvme68k security distribution set is named "secr" and can be found
122in the "mvme68k/security" subdirectory of the NetBSD _VER distribution
123tree. It contains executables which are built in the "src/domestic" portion
124of the NetBSD source tree. It can only be found on those sites which carry
125the complete NetBSD distribution and that can legally obtain it. (Remember,
126because of United States law, it may not be legal to distribute this set to
127locations outside of the United States and Canada.)
128[ 128K gzipped, 275K uncompressed ]
129
130.../mvme68k/kernel/
131
132The mvme68k kernel directory contains a gzip'ed kernel image which is
133compatible with both MVME147 and MVME167 boards. This should be used when
134upgrading from a previous version of NetBSD. Before starting the upgrade,
135you should unzip and copy this kernel in place of your existing /netbsd
136image, then reboot.
137
138The mvme68k binary distribution sets are distributed as gzipped tar files.
139Each mvme68k binary distribution set also has its own "CKSUMS" file, just
140as the source distribution sets do.
141
142The instructions given for extracting the source sets work equally
143well for the binary sets, but it is worth noting that if you use that
144method, the files are extracted "below" the current directory.  That
145is, if you want to extract the binaries "into" your system, i.e.
146replace the system binaries with them, you have to run the command:
147
148        pax -zrvpe -f set.tar.gz
149
150while in the root directory of your system (/).
151
152For best results, it is recommended that you follow the installation
153and/or upgrade procedures documented in this file.
154