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