Home | History | Annotate | Line # | Download | only in alpha
contents revision 1.8
      1 	$NetBSD: contents,v 1.8 1999/01/25 23:34:22 garbled Exp $	
      2 
      3 The alpha-specific portion of the NetBSD _VER release is found in the
      4 "alpha" subdirectory of the distribution:
      5 #if _FOR_RELEASE
      6 .../NetBSD-_VER/alpha/
      7 #else
      8 .../arch/alpha/snapshot/YYYYMMDD/
      9 #endif
     10         INSTALL                 Installation notes; this file.
     11 
     12         binary/
     13                 sets/           alpha binary distribution sets;
     14                                 see below.
     15 
     16                 security/       alpha security distribution;
     17                                 see below.
     18 
     19                 kernel/         alpha kernels; see below.
     20 
     21         installation/
     22 
     23                 floppy/         alpha boot and installation
     24                                 floppies; see below.
     25 
     26         source/			Toolchain source code; see below.
     27 
     28 Bootable installation/upgrade floppies:
     29 
     30         There is a bootable floppy disk image available which contains
     31         the software necessary to prepare your hard drive for NetBSD
     32         and install the NetBSD distribution, or to upgrading an already
     33         installed system from a previous version of NetBSD.
     34 
     35         Because the kernel on the installation disks is not suitable
     36         for use beyond initial installation and configuration, a
     37         "generic" kernel has been placed in a distribution set named
     38         "kern". This kernel is intended to run your system while you
     39         build a custom kernel. It is strongly encouraged that you
     40         build a custom kernel for your installation rather than use
     41         the prebuilt generic kernel on a long term basis.
     42 
     43         Please note that the INSTALL kernel (which is booted from
     44         the install floppy or the network) is not usable for anything
     45         other than installing; it will always use as root an internal
     46         ramdisk with the install tools. Also, currently the INSTALL
     47         image only supports systems that are likely to have a floppy
     48         drive (the NoName, EB64+, EB164, AS500/600; the DECStation
     49         3000 systems and the 8200/8400 are not supported by this
     50         floppy). If booting the INSTALL kernel from the network
     51         proves popular, we will generate another network version
     52         of the INSTALL kernel that supports more systems.
     53 
     54 The alpha toolchain:
     55 
     56         The toolchain (compiler, assembler, linker, etc.) for the
     57         alpha port is not yet integrated into the main NetBSD source
     58         tree, so the sources for it are distributed separately. This
     59 	source code should be unpacked into /usr/local/toolchain.
     60 
     61 	Unlink some previous distributions, in this release the toolchain
     62 	binaries are not distributed in a toolchain set intended to be
     63 	installed into /usr/local, but this time are installed into /usr/bin
     64 	and are distributed in the standard comp.tgz binary distribution set
     65 	as with other NetBSD platforms.
     66 
     67 The NetBSD/alpha binary distribution sets contain the binaries which
     68 comprise the NetBSD _VER release for the alpha.  There are eight binary
     69 distribution sets and the "security" distribution set.  The binary
     70 distribution sets can be found in the "alpha/binary/sets" subdirectory
     71 of the NetBSD _VER distribution tree, and are as follows:
     72 
     73 
     74         base    The NetBSD/alpha _VER base binary distribution.  You
     75                 MUST install this distribution set.  It contains the
     76                 base NetBSD utilities that are necessary for the
     77                 system to run and be minimally functional.  It
     78                 includes shared library support, and excludes
     79                 everything described below.
     80                 [ 13M gzipped, 41M uncompressed ]
     81 
     82         comp    
     83 		Things needed for compiling programs.  This set
     84 		includes the system include files (/usr/include)
     85 		and the various system libraries (except the shared
     86 		libraries, which are included as part of the base
     87 		set).  This set also includes the manual pages for
     88 		all of the utilities it contains, as well as the
     89 		system call and library manual pages. 
     90 		[ 6M gzipped, 31M uncompressed ]
     91 
     92         etc     This distribution set contains the system
     93                 configuration files that reside in /etc and in several
     94                 other places.  This set MUST be installed if you are
     95                 installing the system from scratch, but should NOT be
     96                 used if you are upgrading.  (If you are upgrading,
     97                 it's recommended that you get a copy of this set and
     98                 CAREFULLY upgrade your configuration files by hand.)
     99                 [ 50K gzipped, 320K uncompressed ]
    100 
    101         games   This set includes the games and their manual pages.
    102                 [ 3M gzipped, 8M uncompressed ]
    103 
    104         kern    This set contains a NetBSD/alpha _VER GENERIC kernel,
    105                 named "/netbsd". You MUST install this distribution
    106                 set.
    107                 [ 1M gzipped, 2M uncompressed ]
    108 
    109         man     This set includes all of the manual pages for the
    110                 binaries and other software contained in the base set.
    111                 Note that it does not include any of the manual pages
    112                 that are included in the other sets.
    113                 [ 2.5M gzipped, 10M uncompressed ]
    114 
    115         misc    This set includes the system dictionaries (which are
    116                 rather large), the typesettable document set, and
    117                 man pages for other architectures which happen to be
    118                 installed from the source tree by default.
    119                 [ 2M gzipped, 9M uncompressed ]
    120 
    121         text    This set includes NetBSD's text processing tools,
    122                 including groff, all related programs, and their
    123                 manual pages.
    124                 [ 1M gzipped, 4M uncompressed ]
    125 
    126 
    127 The alpha security distribution set is named "secr" and can be
    128 found in the "alpha/binary/security" subdirectory of the NetBSD
    129 _VER distribution tree.  It contains security related binaries
    130 which depend on cryptographic source code. You do not need this
    131 distribution set to use encrypted passwords in your password file;
    132 the "base" distribution includes a crypt library which can perform
    133 only the one-way encryption function.  The security distribution
    134 includes a version of the Kerberos IV network security system, and
    135 a Kerberized version of the "telnet" program.  The "secr" distribution
    136 set can be found only on those sites which carry the complete NetBSD
    137 distribution and which can legally obtain it.  (Remember, because
    138 of United States law, it may not be legal to distribute this set
    139 to locations outside of the United States and Canada.)
    140         [ 1M gzipped, 3M uncompressed ]
    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 "tar xfp"
    147 from /.
    148