contents revision 1.10
1	$NetBSD: contents,v 1.10 1998/01/09 18:46:05 perry 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			binary/		atari binary distribution sets;
9					see below.
10
11			floppies/	atari boot and installation
12					floppies; see below.
13
14			security/	atari security distribution;
15					see below;
16
17			utils.netbsd/
18			utils.tos/	Miscellaneous atari
19					installation utilities; see
20					installation section, below.
21
22There are three atari floppy images to be found in the "atari/floppies"
23subdirectory of the NetBSD _VER distribution.  One of them is a
24bootable TOS kernel floppy and the other two are installation floppies.
25They are described in more detail below.  There are gzipped versions
26of each available, for easier downloading.  (The gzipped version
27have the ".gz" extension added to their names.)
28
29Bootable Kernel floppy:
30
31	This TOS disk contains the loadbsd and chg_pid programs
32	and a kernel.  It is setup so that you can insert it
33	int your floppy drive, and start the programs from GEM.
34
35	For the TT030 and Falcon, the floppy is named boot-_SVER_S.fs and
36	the kernel supplied is 'BOOT'. For the Hades, you need the
37	hades-boot-_SVER_S.fs floppy. The kernel is 'HADES'.
38
39Installation floppy:
40
41	This disk contains a BSD root file system setup to help
42	you install the rest of NetBSD.  This includes formatting
43	and mounting your root and /usr partitions and getting
44	ready to extract (and possibly first fetching) the distribution
45	sets.  There is enough on this file system to allow you to
46	make a slip connection, configure an ethernet, mount an NFS
47	file system or ftp.  You can also load distribution sets from
48	a SCSI tape or from one of your existing GEMDOS partitions.
49
50	These floppies are named "miniroot-_SVER_S.fs.1" and "miniroot-_SVER_S.fs.2".
51
52There are also TOS utilities in the "atari/utils.tos" subdirectory, which
53you will need to get NetBSD/Atari 'up-and-running'.
54
55	The "gzip.ttp" program allows you to uncompress .gz images.  The
56	usage is "gzip.ttp -d filename.gz".
57
58	The "rawwrite.ttp" program allows you to create the installation 
59	floppy disks from the files in the "atari/floppies" directory.
60
61	The "aptck.ttp" program reads the partition tables present on a
62	given disk and tries to interpret then the same way the NetBSD
63	kernel does.  If you have a disk on which GEMDOS and NetBSD are
64	to co-exist, It is a good idea to run this before you begin the
65	NetBSD/Atari installation just to check that the kernel's view
66	of the partition tables agree with GEMDOS's view.  If you have
67	more than 3 partitions defined on a disk you will notice that
68	the NetBSD/Atari partition starts one sector after the GEMDOS
69	partition.  This is to allow space for the auxilliary root for
70	the 4th and subsequent partitions.
71
72	The "loadbsd.ttp" program loads the NetBSD/Atari kernel from TOS
73	(or MiNT, MultiTOS, etc.).
74
75The NetBSD/Atari kernels are in the "atari/kernels" subdirectory.
76
77The NetBSD/atari binary distribution sets contain the binaries which
78comprise the NetBSD _VER release for the atari.  There are seven binary
79distribution sets, and the "security" distribution set.  The binary
80distribution sets can be found in subdirectories of the "atari/binary"
81subdirectory of the NetBSD _VER distribution tree, and are as follows:
82
83	base	The NetBSD/atari _VER base binary distribution.  You
84		MUST install this distribution set.  It contains the
85		base NetBSD utilities that are necessary for the
86		system to run and be minimally functional.  It
87		includes shared library support, and excludes
88		everything described below.
89		[ 8.7M gzipped, 25.2M uncompressed ]
90
91	comp	The NetBSD/atari Compiler tools.  All of the tools
92		relating to C, C++, and FORTRAN (yes, there are two!).
93		This set includes the system include files
94		(/usr/include), the linker, the compiler tool chain,
95		and the various system libraries (except the shared
96		libraries, which are included as part of the base
97		set).  This set also includes the manual pages for all
98		of the utilities it contains, as well as the system
99		call and library manual pages.
100		[ 6.5M gzipped, 22.9M uncompressed ]
101
102	etc	This distribution set contains the system
103		configuration files that reside in /etc and in several
104		other places.  This set MUST be installed if you are
105		installing the system from scratch, but should NOT be
106		used if you are upgrading.  (If you are upgrading,
107		it's recommended that you get a copy of this set and
108		CAREFULLY upgrade your configuration files by hand.)
109		[ 52K gzipped, 320K uncompressed ]
110
111	games	This set includes the games and their manual pages.
112		[ 2.8M gzipped, 7.2M uncompressed ]
113
114	man	This set includes all of the manual pages for the
115		binaries and other software contained in the base set.
116		Note that it does not include any of the manual pages
117		that are included in the other sets.
118		[ 2.4M gzipped, 10.0M uncompressed ]
119
120	misc	This set includes the system dictionaries (which are
121		rather large), the typesettable document set, and
122		man pages for other architectures which happen to be
123		installed from the source tree by default.
124		[ 2.1M gzipped, 8.1M uncompressed ]
125
126	text	This set includes NetBSD's text processing tools,
127		including groff, all related programs, and their
128		manual pages.
129		[ 960K gzipped, 3.7M uncompressed ]
130
131The atari security distribution set is named "secr" and can be found
132in the "atari/security" subdirectory of the NetBSD _VER distribution
133tree.  It contains crypt.c (the source file for the DES encryption
134algorithm) and the binaries which depend on it.  It can only be found
135on those sites which carry the complete NetBSD distribution and that
136can legally obtain it.  (Remember, because of United States law, it
137may not be legal to distribute this set to locations outside of the
138United States and Canada.)  [ 740K gzipped, 2.5M uncompressed ]
139
140The atari binary distribution sets are distributed in the same form as
141the source distribution sets; catted together, the members of a set
142form a gzipped tar file.  Each atari binary distribution set also has
143its own "CKSUMS" file, just as the source distribution sets do.
144
145The instructions given for extracting the source sets work equally
146well for the binary sets, but it is worth noting that if you use that
147method, the files are extracted "below" the current directory.  That
148is, if you want to extract the binaries "into" your system, i.e.
149replace the system binaries with them, you have to run the "tar xvfp"
150from /.  Also note that if you upgrade or install this way, those
151programs that you are using at the time will NOT be replaced.  If you
152follow the normal installation or upgrade procedures, this will be
153taken care of for you.
154