contents revision 1.3
1	$NetBSD: contents,v 1.3 1998/01/09 18:46:48 perry 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 a
24										VME147 kernel 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 a completely "bare" VME147.  The files
31in 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 147-Bug to boot from tape. This is the
42                        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 serial boot program. This is
48                        necessary if you don't have a tape drive,
49                        but you _do_ have another system which can
50                        act as a boot and NFS server. This is also
51                        useful if you are installing a diskless
52                        NetBSD/mvme68k system.
53
54        netboot         A copy of the network boot program. Used
55                        in conjunction with sboot to get your system
56                        booted over a network.
57
58These files can be used to make a boot tape suitable for installing
59NetBSD/mvme68k. These files can also be used to configure an NFS server
60to support installation "over the network".  See the section "Getting
61the NetBSD System onto Useful Media" for instructions on either method.
62
63.../mvme68k/binary/sets
64
65The NetBSD/mvme68k binary distribution sets contain the binaries which
66comprise the NetBSD _VER release for the VME147. There are seven binary
67distribution sets, and the "security" distribution set. The binary
68distribution sets are as follows:
69
70        base    The NetBSD/mvme68k _VER base binary distribution. You
71                MUST install this distribution set. It contains the
72                base NetBSD utilities that are necessary for the
73                system to run and be minimally functional. It includes
74                shared library support, and excludes everything
75                described below.
76                [ 9.2M gzipped, 26.5M uncompressed ]
77
78        comp    The NetBSD/mvme68k Compiler tools. All of the tools
79                relating to C and C++. This set includes the system
80                include files (/usr/include), the linker, the compiler
81                tool chain, and the various system libraries (except
82                the shared libraries, which are included as part of the
83                base set). This set also includes the manual pages for
84                all of the utilities it contains, as well as the system
85                call and library manual pages.
86                [ 6.9M gzipped, 24.1M uncompressed ]
87
88        etc     This distribution set contains the system configuration
89                files that reside in /etc and in several other places.
90                This set MUST be installed if you are installing the
91                system from scratch, but should NOT be used if you are
92                upgrading. (If you are upgrading, it's recommended that
93                you get a copy of this set and CAREFULLY upgrade your
94                configuration files by hand.)
95                [ 53K gzipped, 327K uncompressed ]
96
97        games   This set includes the games and their manual pages.
98                [ 2.9M gzipped, 7.5M uncompressed ]
99
100        man     This set includes all of the manual pages for the
101                binaries and other software contained in the base set.
102                Note that it does not include any of the manual pages
103                that are included in the other sets.
104                [ 2.5K gzipped, 10.3M uncompressed ]
105
106        misc    This set includes the system dictionaries (which are
107                rather large), the typesettable document set, and
108                man pages for other architectures which happen to be
109                installed from the source tree by default.
110                [ 2.3M gzipped, 8.7M uncompressed ]
111
112        text    This set includes NetBSD's text processing tools,
113                including groff, all related programs, and their
114                manual pages.
115                [ 1.0M gzipped, 3.9M uncompressed ]
116
117.../mvme68k/security/
118
119The mvme68k security distribution set is named "secr" and can be found
120in the "mvme68k/security" subdirectory of the NetBSD _VER distribution
121tree. It contains executables which are built in the "src/domestic" portion
122of the NetBSD source tree. It can only be found on those sites which carry
123the complete NetBSD distribution and that can legally obtain it. (Remember,
124because of United States law, it may not be legal to distribute this set to
125locations outside of the United States and Canada.)
126[ 128K gzipped, 275K uncompressed ]
127
128.../mvme68k/kernel/
129
130The mvme68k kernel directory contains a gzip'ed VME147 specific kernel
131image. This should be used when upgrading from a previous version of
132NetBSD. Before starting the upgrade, you should unzip and copy this
133kernel in place of your existing /netbsd image, then reboot.
134
135The mvme68k binary distribution sets are distributed as gzipped tar files.
136Each mvme68k binary distribution set also has its own "CKSUMS" file, just
137as the source distribution sets do.
138
139The instructions given for extracting the source sets work equally
140well for the binary sets, but it is worth noting that if you use that
141method, the files are extracted "below" the current directory.  That
142is, if you want to extract the binaries "into" your system, i.e.
143replace the system binaries with them, you have to run the command:
144
145        tar --unlink -zxvpf set.tar.gz
146
147from /.   Note that the "--unlink" flag is very important!
148
149For best results, it is recommended that you follow the installation
150and/or upgrade procedures documented in this file.
151