SLS (SOFTLANDING LINUX SYSTEM)

                INTRODUCTION

Welcome to release 1.05 of SLS (SoftLanding Linux System) containing
kernel 1.0, libc 4.5.23, gcc 2.5.8 and XFree86 2.0 (2.1 on CD).  
Linux is a free 386 unix like operating system similar to System V, and 
developed by Linus Torvalds, plus a few hundred big hearted programmers on 
the Internet.   SLS is produced and GPL copyrighted by Softlanding Software.
You may redistribute SLS, as long as you do include both this file, 
and the file COPYING prominently in the distribution.  You may not
take credit for the work of others.

SLS is NOT just an image dump of some ones Unix system.
Instead it is a distribution whose primary purposes are:

0) provide an initial installation program (for the queasy).
1) utilities compiled to use minimal disk space.
2) provide a reasonably complete/integrated U*ix system.
3) provide a means to install and uninstall packages.
4) permit partial installations for small disk configs.
5) add a menu driven, extensible system administration.
6) take the hassle out of collecting and setting up a system.
7) give non internet users access to Linux.
8) provide a distribution that can be easily updated.

SLS contains ~600 utilities designed to provide a relatively
complete computer operating system for the sophisticated user. It
includes programs for compression, text processing, communications,
Xwindowing system, program development (Assembler, C, C++, Fortran, 
Pascal, Tcl and Perl),  mail, spreadsheets, and word-processing.  Also 
supported  are DOS files, a DOS emulator, SCSI, CDROMs, and TCP/IP. A
387 coprocessor is emulated by the kernel if you don't have one.  Full
source code for the kernel is also provided with SLS.

The development environment includes libraries for unix and Xwindows, a
debugger that does full screen (via emacs) with support for core dumps.
Shared libraries make the most miserly use of RAM and disk space. FAQ and
Manual pages document most of the Linux utilities.  SLS requires at least
12 Meg of disk for the minimal install.  90 Meg or more is required for the
full system (not including TeX or Interviews).  You will need at least 2
Meg of RAM, 4 meg if you want to compile programs, and 8 Meg to run
Xwindows.  Note that sometimes you can get by with less, but usually with
noticeable performance limitations.
----------------------------------------------------------------------------

                INSTALLATION

Before you can install Linux on your hard drive, you must partition your
drive, and put a file system on it.  Roughly, this entails:

 - Write protect all disks (do or die).
 - Boot Linux from disk a1
 - For special install (eg: a mitsumi drive) hit ALT at LILO prompt 
 - Log in as "install" for a menu driven install

or if you like, you can do a manual install by logging in as root and 

 - Create a Linux/Minix partition with "fdisk" on your hard drive and reboot.
 - Make a file system on the partition with "mke2fs".
 - Use "doinstall /dev/PART": PART is your partition (eg "doinstall /dev/hda2"
   or "doinstall /dev/hda2 /dev/hda3 /usr /dev/hdb1 /usr/spool" if you wish to
   have multiple partitions, with say /usr on a different partition.

Also "doinstall" will execute the script "doinst.sh" if it is found on PART.
The final step will ask you to put a formatted floppy in the drive so the
BOOT DISK can be prepared for you.  Have one ready ahead of time.  When the
installation is complete, and you reboot from this floppy, you will be using
Linux from your hard drive.   Later, you may wish to play with /usr/src/lilo
to boot from your harddrive.  Note that if you have less than 4 Meg of RAM,
you will likely not have enought memory to do the installation.  But you can
try to make and activate a 4 Meg swap partition, prior to installation.
For example, using /dev/hda3 for swap: "mkswap /dev/hda3 4096; swapon /dev/hda3"
Before you begin, however, you may wish to type "menu" and browse the
Instructions sub menu.  But make sure you exit "menu" before you start the
install process.  You can also print files from there using "P", or you can
use "cat README > /dev/lp1" or "cat README > /dev/lp2".

Your first task after the base install is done, should be to make backup
copies of all of your disks  (Look in the "User Commands" menu). In fact,
you should make sure all disks (except a1) are write protected before you start 
the installation.  After the install, you can log on as "root".  Note the new
Extended FS type 2, it is now the recommended file system to use, although
the old minix fs can be used and is still the default.
----------------------------------------------------------------------------

                EXAMPLE PARTITIONING PROCEDURE

... Put disk a1 in drive A: and reboot computer, 

/# fdisk
 
Command (m for help): n
Command action
   e   extended
   p   primary partition (1-4)
p
Partition number (1-4): 2
First cylinder (500-977): 500
Last cylinder or +size or +sizeM or +sizeK (500-977): 977
 
Command (m for help): t
Partition number (1-4): 1
Hex code (type L to list codes): 81
 
Command (m for help): v
Command (m for help): p
 
Disk /dev/hda: 5 heads, 17 sectors, 977 cylinders
Units = cylinders of 85 * 512 bytes
 
   Device Boot  Begin   Start     End  Blocks   Id  System
/dev/hda1           1       1     499   20000    4  DOS
/dev/hda2           1       1       7   30000   81  Linux/MINIX

Command (m for help): w
reboot now before doing anything else
/#
...< after the reboot>
/# mke2fs /dev/hda2 30000
/# doinstall /dev/hda2
... Follow prompts, and insert disks as requested, then login as root.
----------------------------------------------------------------------------

                ADDITIONAL SLS INFORMATION

SLS is a binary mostly distribution (except for the kernel), and is broken 
into multiple parts, or series, each of which is denoted by a letter followed 
by the disk number as follows:

        a1-aN: The minimal base system
        b1-bN: Base system extras, like man pages, emacs etc.
        c1-cN: The compiler(s), gcc/g++/p2c/f2c
        x1-xN: The X-windows distribution (+Tcl and Tk)
        t1-tN: TeX (document processing)
        s1-sN: Source code for critical system components
        d1-dN: Documentation for various things

This scheme allows new disks to be added to the distribution without
changing the disk numbering.  Also, the sysinstall program doesn't have to
be changed when new disks are added as the last disk is marked by the
presence of the file "install.end".  And when interviews is added, say as
a new series "t", it can be installed with:

        sysinstall -series t

Highlights of the base are:  gcc/g++, emacs, kermit, elm/mail/uucp, gdb, sc
(spreadsheet), man pages, groff, elvis, zip/zoo/lh and menu.  Highlights of
X are: X, programmers libs, 75 dpi fonts, games (spider, tetris, xvier,
chess, othello, xeyes, etc) and utilities like xmag, xmenu, xcolormap and
ghostscript.  Approximate usage is as follows:

Tiny base system:       15 Meg  (Series 'a')
Main base system:       45 Meg  (Series 'a', 'b' and 'c')
Main base system + X11: 70 Meg  (Series 'a', 'b', 'c' and 'x')
Full system:            90 Meg  (Series 'a', 'b', 'c', 'd', 's', 't' and 'x')
----------------------------------------------------------------------------

                LINUX SPECIFIC INFORMATION

Linux supports multiple VC's (virtual consoles).  You can switch from one 
to the other using the "LEFT-ALT-FN" keys.  The right ALT key will not work.
The console in linux more or less emulates a VT100.  So you can usually
just use kermit to do your remote logins (even while doing the install :-).
If you have a color monitor, you can even use color using the "setterm"
utility, or just execute the "/etc/startcons" script to have all VC's set
to default values.  If your screen gets garbled, you can use "reset".
Up arrow recalls previous commands.   Use the "man" command to read the
Linux manual pages, and the "man -k X" to list commands with the keyword
"X" in the command description.  The system editor is "vi" but you might
find "joe" easier to learn.

Never just power off your Linux system.  Instead type "sync", wait a sec,
then powerdown or reboot.   If your disk gets in trouble (or every
couple of weeks anyways) you may wish to run "fsck -av PART" where PART
is your partition, to try to fix any problems.

Dos files can be accessed in one of two ways.  The first uses the mtools
commands (mdir, mcopy, mtype, ...).  The file "/etc/mtools" may need
some tweeking, especially if you use mformat.  The second method is to
mount the dos disk/partition onto a directory.  eg: 

        mount -t msdos /dev/fd0 /user

Swapping can be set up of size SIZE, to a partition or to a file using:

        mkswap file SIZE
        swapon file

Linux can be booted without the floppy using /usr/src/lilo.  Important 
directories include:

"/etc"          - System configuration information
"/usr/src"      - Miscellaneous packages.
"/usr/X386/*"   - Xwindows stuff
----------------------------------------------------------------------------

                CONFIGURING X-WINDOWS

Getting X-windows to run on your PC can sometimes be a bit of a sobering 
experience, mostly because there are so many types of video cards for the PC.  
Linux X11 supports only VGA type video cards, but there are so many types of 
VGA's that only certain ones are fully supported.  SLS comes with two Xwindows 
servers.  The full color one, XFree86, supports some or all ET3000, ET4000, PVGA1,
GVGA, Trident, S3, 8514, Accelerated cards, ATI plus and others.

The other server, XF86_Mono, should work with virtually any VGA card, but only 
in monochrome mode.  Accordingly, it also uses less memory, and should be
faster than the color one.  But of course it doesn't look as nice.

The bulk of the Xwindows configuration information is stored in the directory
"/usr/X386/lib/X11/".  In particular, the file "Xconfig" defines the timings
for the monitor and the video card.   By default, X windows is setup to use
the color server, but you can switch to using the monochrome server x386mono, 
if the color one gives you trouble, since it should support any standard vga.
Essentially, this just means making /usr/X386/bin/X a link to it.

Just edit Xconfig to set the mouse device type and timings, and enter "startx".
To figure out the clock timings to put in Xconfig.  README.modegen explains
how you can use the spreadsheet to figure out your clock timings based upon
your monitor specifications.  More information can be found in the directory
/usr/X386/lib/X11.  But be prepared to fiddle.
----------------------------------------------------------------------------

		AVAILABILITY:

SLS is available on floppies (31 5.25 floppies or 26 3.5 floppies), QIC150 or
CDROM from the address below for a flat rate distribution fee of US $99
($125 Canadian) + $15 shipping and handling.  Mail payment, either
cheque or money order, in advance, to Softlanding.   Visa and Mastercard
are also accepted.
 
The SLS CDROM contains the full source tree and a 60+ page user manual
"Using SLS".  A quarterly CD (4 CD's over 1 year) is available for US $199
(255 Canadian) + $15 S&H.  Quantity discounts are also available for resellers.
 
When ordering floppies, ensure that you specify the bootdisk type (3 1/2 or 5 1/4).
Softlanding also offers support subscriptions for SLS as follows:
Individual support, (one user, one machine) is $99 per year.
Group support, primarily for resellers and reseller/corporate, $999 per
 

    Softlanding Software
    PO Box 48054 - 3575 Douglas St, 
    Victoria, BC, Canada
    V8Z-7HS
    Phone (604) 592-0188 
    FAX (604) 595-5820

See Softlanding for a gentle touch down from a DOS bailout.