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