contents revision 1.11
1 $NetBSD: contents,v 1.11 1998/01/14 06:50:26 scottr Exp $ 2 3The Atari-specific portion of the NetBSD _VER release is found in the 4"atari" subdirectory of the distribution. That subdirectory is laid 5out as follows: 6 7.../NetBSD-_VER/atari/ 8 SOURCE_DATE the date, in the default format 9 produced by the date(1) command, 10 of the source that the release was 11 built from 12 13 INSTALL these installation notes 14 15 binary/ atari system binaries; 16 see below. 17 18 installation/ installation helper items 19 20The NetBSD/atari system binaries include the NetBSD/atari binary 21distribution sets, additional kernels, and security-related system 22binaries. The NetBSD _VER release for the atari port comprises those 23files found in the "atari/binary/sets" subdirectory of the NetBSD _VER 24distribution tree. There are seven system distribution sets, two 25kernel distribution sets, and four X distribution sets. The files in the 26"sets" subdirectory are as follows: 27 28 base.tgz The NetBSD/atari _VER base binary distribution. 29 You MUST install this distribution set. It 30 contains the base NetBSD utilities that are 31 necessary for the system to run and be minimally 32 functional. It includes shared library support, 33 and excludes everything described below. 34 [ 8.6M gzipped, 25.1M uncompressed ] 35 36 comp.tgz The NetBSD/atari Compiler tools; all of the tools 37 relating to C and C++. This set includes the 38 system include files (/usr/include), the linker, 39 the compiler tool chain, and the various system 40 libraries (except the shared libraries, which are 41 included as part of the base set). This set also 42 includes the manual pages for all of the utilities 43 it contains, as well as the system call and library 44 manual pages. 45 [ 6.2M gzipped, 21.6M uncompressed ] 46 47 etc.tgz This distribution set contains the system 48 configuration files that reside in /etc and in 49 several other places. This set MUST be installed 50 if you are installing the system from scratch, but 51 should NOT be used if you are upgrading. (If you 52 are upgrading, it's recommended that you get a copy 53 of this set and CAREFULLY upgrade your 54 configuration files by hand.) 55 [ 49K gzipped, 288K uncompressed ] 56 57 games.tgz This set includes the games and their manual pages. 58 [ 2.8M gzipped, 7.2M uncompressed ] 59 60 kern.tgz The NetBSD/atari _VER kernel binary. You should 61 kern_hades.tgz install the appropriate kernel for your system. 62 kern_x.tgz [ 472K gzipped, 1.01M uncompressed ] 63 64 man.tgz This set includes all of the manual pages for the 65 binaries and other software contained in the base 66 set. Note that it does not include any of the 67 manual pages that are included in the other sets. 68 [ 2.2M gzipped, 8.8M uncompressed ] 69 70 misc.tgz This set includes the system dictionaries (which 71 are rather large), the typesettable document set, 72 and man pages for other architectures which happen 73 to be installed from the source tree by default. 74 [ 2.1M gzipped, 7.6M uncompressed ] 75 76 text.tgz This set includes NetBSD's text processing tools, 77 including groff, all related programs, and their 78 manual pages. 79 [ 1.0M gzipped, 3.7M uncompressed ] 80 81 xbase.tgz X clients, shared libraries, and related man pages. 82 Also includes bitmaps and miscellaneous 83 configuration files. 84 [ 2.34 M gzipped, 7.46M uncompressed ] 85 86 xcomp.tgz Static libraries, include files (except bitmaps), 87 X config files (for xmkmf), and related man pages. 88 [ 1.57M gzipped, 6.38M uncompressed ] 89 90 xcontrib.tgz User-contributed X binaries (e.g. xev, xload) built 91 from the X11 "contrib" sources with man pages and 92 default config files. 93 [ 178K gzipped, 661K uncompressed ] 94 95 xfont.tgz X11 fonts. 96 [ 5.66M gzipped, 6.99M uncompressed ] 97 98 [* Note: an X server distribution set is currently not available.] 99 100The NetBSD/atari security distribution set is named "secr.tgz" and can be 101found in the "atari/binary/security" subdirectory of the NetBSD _VER 102distribution tree. It contains the crypt libraries (for the DES encryption 103algorithm) and the binaries built from the "src/domestic" portion of the 104NetBSD source tree which depend on it. It can only be found on those sites 105which carry the complete NetBSD distribution and that can legally obtain 106it. (Remember, because of United States law, it may not be legal to 107distribute this set to locations outside of the United States and Canada.) 108[ 779K gzipped, 2.5M uncompressed ] 109 110The atari binary distribution sets are distributed as full .tar.gz files 111(with the extension .tgz because the software used to download the sets may 112incorrectly auto-unpack files ending in .gz and to accomodate systems which 113only support 3 character extensions to file names). The instructions 114given for extracting the source sets work equally well for the binary sets, 115but it is worth noting that if you use that method, the files are extracted 116"below" the current directory. That is, if you want to extract the 117binaries "into" your system, i.e. replace the system binaries with them, 118you have to run the "tar xvpf" from /. Also note that if you upgrade or 119install this way, those programs that you are using at the time will NOT be 120replaced. If you follow the normal installation or upgrade procedures, 121this will be taken care of for you. 122 123Additional kernels to those included in the distribution sets may be found 124in the "atari/binary/kernel" subdirectory of the NetBSD _VER distribution 125tree. These kernels are generally named something like "netbsd.BOOT.gz" 126or some other suitable name. Please note that these kernels are simply 127gzipped and are not in tar archives. 128 129There are three atari floppy images to be found in the 130"atari/installation/floppies" subdirectory of the NetBSD _VER 131distribution. One of them is a bootable TOS kernel floppy and the other 132two are installation floppies. They are described in more detail below. 133There are gzipped versions of each available, for easier downloading. 134(The gzipped version have the ".gz" extension added to their names.) 135 136Bootable Kernel floppy: 137 138 This TOS disk contains the loadbsd and chg_pid programs 139 and a kernel. It is setup so that you can insert it 140 int your floppy drive, and start the programs from GEM. 141 142 For the TT030 and Falcon, the floppy is named boot-_SVER_S.fs and 143 the kernel supplied is 'BOOT'. For the Hades, you need the 144 hades-boot-_SVER_S.fs floppy. The kernel is 'HADES'. 145 146Installation floppy: 147 148 This disk contains a BSD root file system setup to help 149 you install the rest of NetBSD. This includes formatting 150 and mounting your root and /usr partitions and getting 151 ready to extract (and possibly first fetching) the distribution 152 sets. There is enough on this file system to allow you to 153 make a slip connection, configure an ethernet, mount an NFS 154 file system or ftp. You can also load distribution sets from 155 a SCSI tape or from one of your existing GEMDOS partitions. 156 157 These floppies are named "miniroot.fs.1" and "miniroot.fs.2". 158 159There are also TOS utilities in the "atari/installation/misc" subdirectory, 160which you will need to get NetBSD/Atari 'up-and-running'. 161 162 The "gzip.ttp" program allows you to uncompress .gz images. The 163 usage is "gzip.ttp -d filename.gz". 164 165 The "rawwrite.ttp" program allows you to create the installation 166 floppy disks from the files in the "atari/floppies" directory. 167 168 The "aptck.ttp" program reads the partition tables present on a 169 given disk and tries to interpret then the same way the NetBSD 170 kernel does. If you have a disk on which GEMDOS and NetBSD are 171 to co-exist, It is a good idea to run this before you begin the 172 NetBSD/Atari installation just to check that the kernel's view 173 of the partition tables agree with GEMDOS's view. If you have 174 more than 3 partitions defined on a disk you will notice that 175 the NetBSD/Atari partition starts one sector after the GEMDOS 176 partition. This is to allow space for the auxilliary root for 177 the 4th and subsequent partitions. 178 179 The "loadbsd.ttp" program loads the NetBSD/Atari kernel from TOS 180 (or MiNT, MultiTOS, etc.). 181 182Note: Each directory in the atari binary distribution also has its 183----- own checksum files, just as the source distribution does: 184 185 All BSDSUM files are historic BSD checksums for the various files 186 in that directory, in the format produced by the command: 187 cksum -o 1 <file>. 188 189 All CKSUM files are POSIX checksums for the various files in that 190 directory, in the format produced by the command: cksum <file>. 191 192 All MD5 files are MD5 digests for the various files in that 193 directory, in the format produced by the command: cksum -m <file>. 194 195 All SYSVSUM files are historic AT&T System V UNIX checksums for 196 the various files in that directory, in the format produced by 197 the command: cksum -o 2 <file>. 198 199 The MD5 digest is the safest checksum, followed by the POSIX 200 checksum. The other two checksums are provided only to ensure 201 that the widest possible range of system can check the integrity 202 of the release files. 203