Last-modified: 94-11-28
Maintained-By: Joerg Mayer <jmayer@informatik.uni-kl.de>

                Frequently Asked Questions on Linux/68k
              A Linux port to Motorola's 680x0 processors

Version of this FAQ : 0.7
Version of Linux/68k: 09pl4
Version of Linux    : 1.1pl67


i) Introduction
===============

This is the fourth public release of the Linux/68k FAQ. Since it probably
still contains errors (typographical and logical), outdated and missing infos,
I ask that you send feedback and corrections to me. This document is not
intended to describe what Unix is or how to to administrate it. To find out
more about that read the standard Linux manuals.
Parts of this document were snarfed from Helmut Neukirchen's Linux/68k WWW page
(see below). Thanks.

ii) Newsflash
=============

This FAQ is available via WWW:
  http://pfah.informatik.uni-kl.de:8000/pers/jmayer/linux68k-faq
  ftp://tsx-11.mit.edu/pub/linux/680x0/FAQ (or any tsx-11 mirror)
Linux/68k  0.9 PL 4 released
Problems with 680X0 channel of Linux-Mailinglist (see 6.2) solved?

iii) Contents
=============

i Introduction
ii Newsflash
iii Contents
1. About Linux and Linux/68k
2. Requirements to run Linux/68k
  2.1 Processor
  2.2 RAM
  2.3 Harddisk
  2.4 Software
3. Similarities and differences of Amiga and Atari Linux/68k
  3.1 Similarities
  3.2 Differences
4. The current status of Linux/68k
  4.1 General
  4.2 Amiga
  4.3 Atari
  4.4 Mac
  4.5 Pc
5. Hints on installing Linux/68k
6. Sources for information/sources/binaries
  6.1 Newsgroups
  6.2 Mailinglists
  6.3 WWW-sites
  6.4 Ftp-sites
  6.5 Modem
  6.6 Distributions
7. Activities
  7.1 Coordinator
  7.2 Bug reports/Known bugs
  7.3 Under construction/To do
8. Famous last words


1. About Linux and Linux/68k
============================

Linux is a freely available operating system for PCs - to be more precise,
it is one of many flavours of Unix. Linux is being developed on the net by
several thousand people and being tested/used by many many more.
The fun and success of Linux inspired some people to port it to another
platform - the Amiga. The first version released to the general public was
005. While 008 was current, a few enthusiasts ported that version to the Atari
and the two versions have been successfully merged with 09pl3 (this reads
version 09 patchlevel 3). Linux/68k can be regarded as beta. This means that
code that hasn't been ported/written recently works well most of the time.

2. Requirements to run Linux/68k
================================

2.1 Processor
-------------
You need a Motorola 680x0 processor *with PMMU*. There is *no way* to run
it without one. This reduces the list of possible processors to 68020+68851,
68030, 68040, 68LC040, 68060. Currently only the 68020+68851, 68030 and
68040 are supported. At this stage you will also need a 68881 or 68882 FPU
if you don't have a 68040.  A FPU is not strictly neccessary as it can be
emulated with the normal processor, however nobody has written the code to
do so. This list of processors excludes the 68000, 68010, 68EC020, 68EC030,
68EC040.  Linux/68k can *never* run on these processors as they lack a PMMU
and an interface for an external one.
The following Amigas have the "right" processor built-in: A3000, A3000T,
A4000/40 (not! A4000/30).
The following Ataris (or clones) have the "right" processor built-in:
Atari Falcon (FPU is not standard but needed!), Atari TT, Medusa (not yet
supported), Eagle (not yet supported). Note: In some of the older TTs there
is a bug in the PAL controlling the access to the FPU. This may cause a
crash. A file describing a hardware fix exists (German language only).
Any processor upgrade card with a 68040 or 68030+68881/2 (like PAK/3) is able
to run Linux. Note: The PAK/3 is not yet supported on the Atari.

2.2 RAM
-------
Note: On the Amiga the size of fastram is relevant.
It is possible to boot Linux/68k with as little as 2 MB. If you want to work
with it you should have 4 MB (8 MB with a X-server).

2.3 Harddisk
------------
If you want to do more than just boot Linux/68k you will need 30 - oo
(infinity)
MB of space on your hard disk and a supported hard disk controller.

2.4 Software
------------
Amiga: In order to run amiboot you need AmigaDOS 2.0 or higher (expansion.lib-
rary V36+).

3. Similarities and differences between Amiga and Atari Linux/68k
=================================================================

3.1 Similarities
----------------
All code that dependens only on the processor (i.e. paging, systemcalls,
parts of the interrupt handling and of c(o)urse those parts of Linux that
were handoptimized by writing the code in assembler) has to be ported to
Linux/68k only once. This means that the Amiga and the Atari may use the
same kernel image (in fact the vmlinux from tsx-11 runs on both machines).
Another big bonus is that all user programs (= binaries) should work on
any machine running Linux/68k no matter whether the machine is an Amiga
or Atari - as long as no machine specific devices are used (see below).

3.2 Differences
---------------
All code that depends on the hardware is machine dependent and with very
few exceptions which are in the kernel (timer, a small part of interrupt
handling, startup code) has been put into modules called device drivers.
Writing device drivers makes up most of the porting work.

4. The current status of Linux/68k
==================================

4.1 General
-----------
What has been done? The kernel (this means all the processor/mmu/fpu specific
stuff) has been ported. Version 09 is based on the Linux 1.0 patchlevel 9
sources. Several hardware-independent devices have been ported:
Ramdisk, mem, pty, tty, vt, slip, net/inet, general SCSI stuff. Also the fol-
lowing filesystems have been done: minix, ext2, msdos, proc, isofs, affs, nfs,
( = Amiga Fast File System, read only).

4.2 Amiga
---------
Supported built-in hardware:
A3000-SCSI, A4000-IDE, A1200-IDE, serial port, parallel port, mouse, keyboard,
graphics emulates an ASCII-terminal (resolution varies with your chipset/
setup), timer, floppy disk drive (DD and HD, Amiga-formatted disks only).

Supported cards:
Several SCSI cards are supported. These are the A2091, A590 and GVP Series II.
To find out whether additional hardware is supported, look at the Linux/68k
source (config.in provides a list of supported hardware).

4.3 Atari
---------
SCSI, ACSI, Falcon IDE, serial ports driven by a MFP (i.e. Modem 1 and
Serial 1), keyboard, Atari mouse, parallel printer port, RTC clock, floppy
disk (DD/HD), native Atari graphics (ST/TT/Falcon)
Note: Linux' Minix FS is compatible to the Minix V2 FS used with MiNT.

4.4 Mac
-------
Someone is working on Linux/68k-Mac. [I hope to find out more on that by
the next release of this FAQ.]

4.5 Pc
------
As pc's don't have Motorolas inside (except on soundcards and other plug-ins),
this section should read "What parts that originated in Linux/68k have been
ported to Linux/pc?"
 - Amiga Fast File System (read only) tsx-11:/pub/linux/patches/amigaffs.tar.Z

5. Hints on installing Linux/68k
================================

[If someone is willing to write something more complete/comprehensible I will
happily replace this section.]
 1. Get a working kernel, *all* announce files and the boostrap program for
   your machine (different kernel versions may require different bootstrap
   versions), the root and usr-filesystems and the newfilesys (this is a
   ramdisk that contains everything you will need to setup a working harddisk
   environment). Sources for these programs: See below.
 2. Bootstrap the kernel and newfilesys as described in the ANNOUNCE file for
   that kernel. Many of the bootstrap flags available are documented in older
   announce files only.
 3. Create a partition on your harddisk and install an ext2fs filesystem on it.
 4. Create another partition as swapspace.
 5. Unpack the root and usr filesystem onto the disk.
 6. Copy the contents of your ramdisk to your harddisk. This replaces several
    old programs in root and usr with newer (working) versions.
    This is not needed if you downloaded the new usr.tar.gz.
 7. If /etc/termcap does not exist, get it (see below) and install it.
 8. Reboot
 9. Bootstrap your kernel, this time from the harddisk instead of ramdisk.
 10. Get and read the Installation-HOWTO for Linux. Start reading from section
    4 "Installing the Software". Warning: This is for the pc so you may have
    to do things differently at some points.
These are the filenames relative to 680x0/
  ANNOUNCE-0.XXXXXX
  filesys/new-filesys.gz
  filesys/root.tar.gz
  filesys/usr.tar.gz
  bin/gcc-2.5.8.tar.gz (needed if you downloaded the new usr.tar.gz)
  kernel/vmlinux-0.9pl4.gz
  kernel/amiboot-1.10.gz
  kernel/ataboot-0.4.gz (if it doesn't exist: see ANNOUNCE-file)
  src/linux-0.9*.gz (the kernel source tree and diff files)
  ../docs/HOWTO/Installation-HOWTO
  The new root.tar.gz file contains /etc/termcap but no gcc. If you are a
  tcsh or emacs addict you will want to get these packages from bin/ too.
  The filesystems naturally contain *no kernel sources*, so you will have
  to get these too.
  You can get the termcap via Helmut Neukirchen's WWW pages, if you don't
  want to download the new usr.tar.gz.
 
6. Sources for information/sources/binaries
===========================================

6.1 Newsgroups
--------------
comp.os.linux.development: This group is on Linux *kernel* development only.
  From time to time it contains messages dealing with the Linux/68k kernel.
comp.os.linux.announce: This group announces new Linux related products as
  well as new kernel releases. Announcements for new versions of Linux/68k
  may be found there.
maus.os.linux68k:
  This group deals with Linux/68k only. The languages currently used are
  German and English.  It should be available at least at the following
  internet site:   news.uni-stuttgart.de (read only)
  The Newsgroup is also available in FidoNet (LINUX-68K.GER).
comp.unix.amiga: This group is for discussions on AMIX, NetBSD and Linux/68k
  on the Amiga. As most articles on Linux/68k are not Amiga specific, the
  name is somewhat of a misnomer.
de.comp.sys.amiga.unix: Similar to comp.unix.amiga but in German language.

6.2 Mailinglists
----------------
I am aware of one mailinglist for Linux/68k. This is the 680X0 channel of
linux-activists. To find out how to subscribe send an empty mail to
linux-activists-request@niksula.hut.fi. The channel you want to join is
680X0. Keep the help file! You will want to read the help file again in
order to unsubscribe. The articles on this list are currently mirrored on
maus.os.linux68k. The mailinglists are 2-way mirrored in the linux.act.*
news-hierarchy in some places, for example the 680X0 channel is in the group
linux.act.680X0.
During the last few weeks there have been problems with the niksula.hut.fi
mailinglists. Another site has offered to act as a replacement. In oder to
find out how to subscribe, send mail consisting of one line saying "help" to
majordomo@vger.rutgers.edu. The channel you want to join is named linux-680x0.
Please note that niksula has resumed operation.

6.3 WWW-sites
-------------
Helmut Neukirchen's Linux/68k WWW page:
  http://www-users.informatik.rwth-aachen.de/~hn/linux68k.html
Mirror of tsx-11 via WWW:
  http://src.doc.ic.ac.uk/packages/Linux/tsx-11-mirror/680x0/

6.4 Ftp-sites
-------------
THE Linux/68k server:
  ftp://tsx-11.mit.edu/pub/linux/680x0/
THE two Linux servers (sources for you to port to/compile on Linux/68k):
  ftp://tsx-11.mit.edu/pub/linux/sources/
  ftp://sunsite.unc.edu/pub/Linux/system/
Mirrors (please use the one nearest to you, most of these mirrors are updated
daily):
  ftp://ftp.tu-clausthal.de/pub/systems/Linux/680x0/
  ftp://ftp.informatik.tu-muenchen.de/pub/comp/os/linux/680x0/
  ftp://ftp.informatik.uni-oldenburg.de/pub/linux/680x0/
  ftp://ftp.twi.tudelft.nl/pub/Linux/680x0/
  ftp://ftp.informatik.rwth-aachen.de/pub/Linux/BETA/680x0/
  ftp://ftp.germany.eu.net/pub/os/Linux/Mirror.SunSITE/
  ftp://src.doc.ic.ac.uk/computing/operating-systems/Linux/tsx-11-mirror/680x0/
[Please tell me, if your favourite mirror is not on this list.]
The kernel source for Linux/68k can be found in 680x0/src/, a lot of
binaries in 680x0/bin/. A few more tools reside in 680x0/tools/.

6.5 Modem
---------
If you have a modem, you can get Linux/68k from the following addresses:

6.5.1 Germany
-------------
System name: nasim
Phone: +49 89 5469593, ZyX19200
Login:  Anon-uucp: nuucp - no password / ZModem: gast - no password
Contents: full 680x0-tree of tsx-11 in /pub/linux-68k
Get first: index file /pub/linux-68k/ls-lR.nasim.linux-68k.gz
Other features: provides uucp access to 680X0 channel (read only) and the
  linux.act.* news-groups
Admin: Frank Bartels (knarf@nasim.cube.net)

6.6 Distributions
-----------------
A distribution for Atari Linux - including a GEM based installation tool - has
been announced by Whiteline for November '94 (they do ads in Atari-magazines).

7. Activities
=============

7.1 Coordinator
---------------
Linux/68k releases are built and released by Hamish Macdonald (his e-mail is
hamish@border.ocunix.on.ca). 'Built' means that you write a patch against the
current version/patchlevel and he will integrate it into the next release.
Atari specific patches should be sent to Roman Hodek (his e-mail is
rnhodek@cip.informatik.uni-erlangen.de) as Hamish has no way to test them.
If you want your patches to be generally available rather than waiting for
Hamish to integrate them: Post them to the 680X0 channel of linux-activists
and linux-680x0 at least. Hamish has his own pace of doing releases. So read
my lips:-) *Don't push him!*

7.2 Bug reports/Known bugs
--------------------------
Send bugreports to the author of the code or to Hamish (general and Amiga)
or to Roman (Atari). Another approach is to post it to the 680X0 channel or
to the appropriate newsgroup.
If there are bugs that will probably stay for some time let me know so I can
publish them here.

7.3 Under construction/To do
----------------------------
I would like to have a list of projects planned/started, similar to the
Linux Project-FAQ. If you send me infos I will put them into this section.

7.3.1 General
-------------
Affs: Write code, other DOS types and special root block handling missing.
Documentation: A Linux/68k update of the khg (Kernel hackers guide) needs to
  be written (especially the mmu specific stuff). Infos on the machine
  abstraction would be nice too.
A concept for an interface between kernel and X-server has to be developed
  (see maus.os.linux68k).

7.3.2 Amiga
-----------
X-server: Martin Apel (apel@physik.uni-kl.de) has a (pre-) alpha X-server
  running (most things are hard coded and the blitter isn't used).

7.3.3 Atari
-----------
X-server: *May* be out somtime in november.
SCC-Treiber (rnhodek@cip.informatik.uni-erlangen.de)
Console for ET4000
Falcon: better gfx support (more modes)
Medusa, PAK/3 support

8. Famous last words
====================

Amiga, Atari, Motorola, Unix and perhaps some more words I used in this text
are trademarks. So what?

-----------
J"org Mayer  Student an der  Universit"at Kaiserslautern
http      :  http://pfah.informatik.uni-kl.de:8000/pers/jmayer.txt
e-mail    :  jmayer@informatik.uni-kl.de    //   PGPid: 0xFB2461E1
phone     :  Kaiserslautern: 205-3348 (Uni) //    3100480 (privat)
snail-mail:  Beethovenstr. 44 // 67655 Kaiserslautern  //  Germany


--
Send submissions for comp.os.linux.announce to: linux-announce@tc.cornell.edu
PLEASE remember Keywords: and a short description of the software.

