add directory distributions

distributions/elks/linux1/INSTALL.txt

@@ -0,0 +1,197 @@
+ELKS - INSTALL.TXT - v0.0.3 - 26 January 2000
+Original Author - Matt Balaun - gs25mrb@panther.gsu.edu
+Editor/Contributor - Al Riddoch - ajr@ecs.soton.ac.uk
+
+Here are basic instructions on installing ELKS, the Embeddable Linux Kernel
+Subset, onto one or more floppy disks for use on your PC.
+
+If you are looking for information on ELKS development or kernel
+compiling, please refer to the README file or the ELKS FAQ.
+
+Table of Contents:
+==================
+
+1. Introduction
+2. Installation - DOS/Win3.x/Win9x/WinNT users
+3. Installation - Linux users
+4. Installation - Psion3 SIBO (Under Construction)
+5. Credits/Thanks
+
+If you have any questions about this document, please post your question
+to the linux-8086 discussion list.  Information on this list is available 
+at http://www.elks.ecs.soton.ac.uk/maillist.php3
+
+You can also email the author of this document, Matt Balaun, at
+gs25mrb@panther.gsu.edu
+
+1.  Introduction
+
+ELKS, the Embeddable Linux Kernel Subset, is an open-source project
+designed to bring linux-like functionality to old x86 hardware (8088,
+8086, 80186, and 80286 processors).  Currently, ELKS runs off floppy disks
+only; there is no officially supported means of booting ELKS directly from
+a hard drive as of yet.  This document will tell you step-by-step how to
+create your own set of ELKS floppy disks.
+
+These are the disk images for ELKS as contained in the file IMAGES.ZIP and
+as of ELKS version 0.0.82:
+
+boot - disk image used in creating the boot disk
+root - disk image used in creating the root disk
+comb - disk image used in creating a combination boot and root disk
+
+According to Al Riddoch, the maintainer of the ELKS project, using the
+combined image is always better, but it requires a disk size larger than
+360K, so cannot be used on machines that only have 360K drives.
+
+Thus, if you have only 360k floppies, make separate boot and root disks.
+
+2.  Installation - Dos/Win3.x/9x/NT/2000 users
+
+For those of you working on a DOS-based system (or a system where you can
+access a DOS prompt, such as Win9x/NT), you will need the following to 
+create your set of ELKS disks:
+
+	IMAGES.ZIP (which presumably you've already downloaded if you're
+                    reading this document)
+        RAWRITE.EXE (a DOS-based tool used to write disk images onto your
+		     floppies)
+	Two floppy disks (or just one if you want to make the 
+				  combination boot and root disk)
+
+The disks will need to be at least 720K if you want to use the comb image.
+It does not matter at all if the disks are too big.
+
+If you are missing IMAGES.ZIP, you can get it from:
+
+ftp://linux.mit.edu/pub/ELKS/ 
+
+If you are missing RAWRITE.EXE, you can get it from:
+
+ftp://ftp.cdrom.com/pub/linux/slackware-7.0/bootdsks.144/
+
+If you are missing two floppy disks, buy them from just about any
+computer or office supply store on the planet.
+
+Once you have all these items, you are ready to start making your ELKS disk
+set.
+
+First, unzip IMAGES.ZIP into a directory on your hard drive.  If you don't
+know how to do this, or if you haven't the tools to do this, download 
+PKZ204G.EXE from ftp.pkware.com, install it, and read the documentation
+included with it.  
+
+	Example:  C:\> md elks
+		  C:\> copy images.zip c:\elks\
+                  C:\> cd elks
+                  C:\ELKS> pkunzip images.zip
+
+Second, put a copy of RAWRITE.EXE to that same directory
+
+	Example:  C:\ELKS\> cd ..
+		  C:\> copy rawrite.exe c:\elks\
+		  C:\> cd elks
+
+Third, decide whether you want to make separate boot and root disks or 
+just the combination boot/root disk.  Then make them.  The format for 
+RAWRITE.EXE is RAWRITE [image name] [drive letter].  You can also just type
+RAWRITE, and the program will prompt you for the information it needs.
+
+Example (for separate boot and root disks):
+		  
+	  (put a floppy into drive A:)
+		  
+	  C:\ELKS\> rawrite boot a:
+		  
+	  (wait for rawrite to finish writing to drive A:)
+
+	  (remove floppy from drive A:, label as "ELKS boot"
+	   or some other logical name)
+
+	  (put a new floppy into drive A:)
+
+	  C:\ELKS\> rawrite root a:
+
+	  (wait for rawrite to finish writing to drive A:)
+
+	  (remove floppy from drive A:, label as "ELKS root"
+	   or some other logical name)
+
+	  (congratulate yourself on successful creation of your ELKS
+	   disks)
+
+Example (for the combination boot/root disk):
+
+	  (put a 720K or larger floppy into drive A:)
+
+	  C:\ELKS\> rawrite comb a:
+
+	  (wait for rawrite to finish writing to drive A:)
+
+	  (remove floppy from drive A:, label as "ELKS
+	   boot/root" or some other logical name)
+
+	  (congratulate yourself on successful creation of your ELKS
+	   disk)
+
+
+3.  Installation - Linux users
+
+(This Section Under Construction)
+
+Unzip using the unzip command, write disk images using the dd command.
+
+Example (separate boot and root disks):
+
+	(put floppy disk into /dev/fd0)
+
+	$ dd if=boot of=/dev/fd0 bs=8192
+
+	(remove floppy disk from /dev/fd0, label as "ELKS boot" or some
+	 other logical name)
+
+	(put a new floppy into drive /dev/fd0)
+
+	$ dd if=root of=/dev/fd0 bs=8192
+
+	(remove floppy disk from /dev/fd0, label as "ELKS root" or some
+	 other logical name)
+
+	(congratulate yourself on successful creation of your ELKS disks)
+	
+Example (combination boot/root disk):
+
+	(put 720K or larger floppy disk into /dev/fd0)
+
+	$ dd if=comb of=/dev/fd0 bs=8192
+
+	(remove floppy disk from /dev/fd0, label as "ELKS boot/root" 
+	 or some other logical name)
+
+	(congratulate yourself on successful creation of your ELKS disk)
+
+4.  Installation - Psion3 SIBO
+
+The SIBO port is not currently mature enough to be worth installing. If you
+intereste in testing and developing the SIBO kernel, please see the section
+on the ELKS website at http://www.elks.ecs.soton.ac.uk/sibo.php3
+
+5.  Credits/Thanks
+
+In updating v0.0.2 of this document, Al Riddoch contributed technical
+corrections throughout the whole text.
+
+In helping to distribute this document to all who are interested in ELKS,
+Phillip Rhoades has set up the ELKS Documentation Project homepage
+(http://www.crosswinds.net/~edp/) where the latest version of this and
+other documents relating to the ELKS project should always be available.
+
+Thanks to Al, Phillip, and all the other fine people working on the ELKS
+project.
+----------------------------------------------------------------------------
+
+Matt Balaun
+gs25mrb@panther.gsu.edu
+
+PS - Bug reports welcome.  Requests for help will be answered when time 
+     permits.

distributions/elks/linux1/README.txt

@@ -0,0 +1,93 @@
+(1) Introduction
+(2) Trying out ELKS using the disk images
+(3) Compiling your own kernel
+
+
+
+(1) Introduction
+
+Hello, and welcome to the exciting world of Linux-8086, ELKS, or the
+Embeddable Linux Kernel Subset!  This is a project which will eventually
+produce a Linux-like OS for the 8086 (186, 286) as well as for the Psion
+series of processors.  But, as you have this file, you probably already know
+that, so let's get down to business.
+
+
+
+(2) Trying out ELKS using the images
+
+So you want to give ELKS a try, but you don't want all the fuss and bother of
+compiling the kernel and the tools yourself.  No problem.  All you need to
+do is grab the images.zip file from the download section of
+http://www.elks.ecs.soton.ac.uk/ and save it to its own
+directory. These files can be copied to disks and used to boot ELKS. For
+details of which files you want and how to use them, please see the
+INSTALL file included in this distribution.
+
+(3) Compiling your own kernel
+
+Compiling your own kernel is a bit more involved, but we'll get through it. 
+First, you're going to need a few files from the download section of
+http://www.elks.ecs.soton.ac.uk/
+
+                  elks-x.x.xx.tar.gz
+                  images.zip
+                  elkscmd-xxxxxxxx.tar.gz
+                  Dev86bin-x.xx.x.tar.gz
+
+Okay, so you've got the files.  Personally, I like to keep them in /ELKS/, so
+that's what I'll assume you're doing.  So cd to /ELKS, and let's get
+started.  The first thing we need to do is install the development tools.
+
+                  cp Dev86bin-x.x.xx.tar.gz /
+                  cd /
+                  tar xvzf Dev86bin-x.x.xx.tar.gz
+                  rm Dev86bin-x.x.xx.tar.gz
+
+Now you should have the 8086 development tools installed.  Next, we need to
+cd back to /ELKS/ and untar the ELKS kernel sources. So
+
+                  cd /ELKS
+                  tar xvzf elks-x.x.xx.tar.gz
+                  cd ./elks
+
+Now that we're in the source directory, we can start setting up the kernel.  
+The first thing that needs to be done is
+
+                   make config
+
+You'll be asked a few questions about how you want the kernel set up.  For
+now, we'll accept the defaults and just keep hitting enter until we get
+to the end, then
+
+                  make
+
+You'll see a lot of warnings go by for a few minutes, and then we'll assume
+a perfect compile.  So we'll now have a diskette image file with our new
+kernel on it.  We'll assume we built for the 8086.  The image is a little
+buried, so we'll have to dig into the source tree to find it.
+
+                  cd /ELKS/elks/arch/i86/
+                  ls
+
+If the compile was successful, you'll have an "Image" file here, and you'll
+have to get it onto a diskette.  I'll assume "/dev/fd0".
+
+                  dd if=./Image of=/dev/fd0 bs=8192
+
+This will be your boot disk, but you'll need a root disk, too, so
+
+                  cd /ELKS/
+                  unzip images.zip
+                  dd if=./root of=/dev/fd0 bs=8192
+
+After that, you should be able to use the boot and root disks and watch ELKS
+work its Linux-like magic on your machine.  Have fun!
+
+---------------------------------------------------------------------
+If you have any suggestions for this readme send your comments to
+semjaza@mytalk.com
+or
+linux-8086@vger.rutgers.edu
+
+--Phillip J Rhoades