README.md

Welcome to the ZipSlack(tm) 10.0 UMSDOS Linux installation.

This is a great way to install an up-to-date Slackware Linux system on a DOS
partition. It'll use about 90 megabytes of drive space, which means you can
install this on a Zip disk. (more space will be used if your drive uses large
clusters, i.e. a one or more gigabyte pre-FAT32 DOS partition) It'll probably
work with LS120 and all the other Zip-imitators as well (but I haven't tried it
myself, as I'm pretty loyal to Iomega :^) and, it can also be installed to any
DOS partition (including FAT32) as a quick and easy way to get a nicely loaded
base Linux system up and running without having to repartition a hard drive.

This system includes:

2.4.26 Linux kernel, with support for many SCSI controllers.
Includes parallel port Zip support.

An easy to configure PPP setup script (pppsetup), network setup script
(netconfig), and a nice collection of network applications like mail,
links, ssh, and more.

Slackware 'pkgtool', 'installpkg', 'rpm2targz', and other tools to let you
customize the system and add additional software that the ZipSlack
installation doesn't add by default for space considerations (like X).

Extra applications and utilities, such as:
-- bash shell.
-- A large set of kernel modules
-- Midnight Commander file manager
-- "Links" text based web browser
-- Many networking related tools like lftp, nmap, nc, rsync, ssh,
traceroute, wget, and more

Here's the list of packages ZipSlack installs:

a/aaa_elflibs-9.2.0-i486-1.tgz a/umsdos-progs-1.13-i386-1.tgz
a/acpid-1.0.3-i486-1.tgz a/usbutils-0.11-i486-2.tgz
a/apmd-3.0.2-i386-1.tgz a/utempter-1.1.1-i486-1.tgz
a/bash-2.05b-i486-3.tgz a/util-linux-2.12a-i486-1.tgz
a/bin-9.2.0-i486-2.tgz ap/bc-1.06-i386-2.tgz
a/bzip2-1.0.2-i486-5.tgz ap/cdparanoia-IIIalpha9.8-i386-1.tgz
a/coreutils-5.2.1-i486-1.tgz ap/cdrdao-1.1.9-i486-1.tgz
a/cpio-2.5-i386-1.tgz ap/cdrtools-2.00.3-i486-1.tgz
a/cxxlibs-5.0.6-i486-1.tgz ap/diffutils-2.8.1-i386-1.tgz
a/dcron-2.3.3-i386-4.tgz ap/dvd+rw-tools-5.19_1.4.9.7-i486-1.tgz
a/devs-2.3.2-zipslack-2.tgz ap/groff-1.17.2-i386-3.tgz
a/e2fsprogs-1.35-i486-1.tgz ap/joe-3.1-i486-1.tgz
a/elvis-2.2_0-i486-2.tgz ap/lsof-4.71-i486-1.tgz
a/etc-5.1-noarch-9.tgz ap/man-1.5m2-i486-1.tgz
a/findutils-4.1.7-i386-1.tgz ap/man-pages-1.64-zipslack-1.tgz
a/floppy-5.4-i386-3.tgz ap/mc-4.6.0-i486-4.tgz
a/gawk-3.1.3-i486-1.tgz ap/mdadm-1.6.0-i486-1.tgz
a/gettext-0.14.1-i486-1.tgz ap/mpg321-0.2.10-i486-2.tgz
a/glibc-solibs-2.3.2-i486-6.tgz ap/raidtools-1.00.3-i386-1.tgz
a/glibc-zoneinfo-2.3.2-noarch-6.tgz ap/screen-4.0.2-i486-1.tgz
a/gpm-1.19.6-i486-6.tgz ap/sox-12.17.4-i486-2.tgz
a/grep-2.5-i386-2.tgz ap/workbone-2.40-i386-3.tgz
a/gzip-1.3.3-i386-2.tgz n/curl-7.12.0-i486-1.tgz
a/hdparm-5.5-i486-1.tgz n/dhcpcd-1.3.22pl4-i386-1.tgz
a/hotplug-2004_01_05-noarch-3.tgz n/inetd-1.79s-i486-6.tgz
a/infozip-5.51-i486-1.tgz n/iptables-1.2.10-i486-1.tgz
a/isapnptools-1.26-i386-1.tgz n/iptraf-2.7.0-i386-1.tgz
a/kbd-1.12-i486-2.tgz n/lftp-3.0.6-i486-1.tgz
a/kernel-modules-2.4.26-i486-3.tgz n/links-0.98-i386-2.tgz
a/less-382-i486-1.tgz n/nail-10.7-i486-1.tgz
a/lilo-22.5.9-i486-2.tgz n/nc-1.10-i386-1.tgz
a/logrotate-3.6.8-i486-1.tgz n/netpipes-4.2-i386-1.tgz
a/minicom-2.00.0-i386-1.tgz n/netwatch-1.0a-i386-1.tgz
a/module-init-tools-3.0-i486-1.tgz n/nmap-3.50-i486-1.tgz
a/openssl-solibs-0.9.7d-i486-1.tgz n/openssh-3.8.1p1-i486-1.tgz
a/pciutils-2.1.11-i486-5.tgz n/pidentd-3.0.18-i486-1.tgz
a/pcmcia-cs-3.2.7-i486-3.tgz n/portmap-5.0-i486-1.tgz
a/pkgtools-10.0.0-i486-1.tgz n/ppp-2.4.2-i486-2.tgz
a/procps-3.2.1-i486-1.tgz n/rp-pppoe-3.5-i386-1.tgz
a/reiserfsprogs-3.6.17-i486-1.tgz n/rsync-2.6.2-i486-1.tgz
a/sed-4.0.9-i486-2.tgz n/tcpdump-3.8.3-i486-2.tgz
a/shadow-4.0.3-i486-10.tgz n/tcpip-0.17-i486-28.tgz
a/slocate-2.7-i486-3.tgz n/traceroute-1.4a12-i386-2.tgz
a/smartmontools-5.30-i486-1.tgz n/wget-1.9.1-i486-1.tgz
a/sysklogd-1.4.1-i486-9.tgz n/wireless-tools-26-i486-3.tgz
a/syslinux-2.10-i486-1.tgz n/ytalk-3.1.1-i386-1.tgz
a/sysvinit-2.84-i486-50.tgz y/bsd-games-2.13-i386-6.tgz


INSTALLATION:

To install Slackware using ZipSlack, all you need to do is unzip the file
ZIPSLACK.ZIP on the DOS partition where you want Linux installed. To do this,
you'll need an unzip utility. If you don't already have an unzipper such as
PKZIP for DOS or Windows, http://www.pkware.com is a great place to get one.

Here's how you'd install on a Zip disk on drive D:\ -- first, fire up Win95 and
start PKZIP for Windows.

Then, from the "File" menu, select the "Open..." option. In the dialog box,
browse for and select the file ZIPSLACK.ZIP.

If you're planning to put this on a Zip disk, make sure it's in your machine,
formatted, and ready to go.

Next, you need to extract the files to a DOS partition. From the "Extract"
menu, select the "Extract Files..." choice. In the "Extract" box, make sure
the "all files" choice is selected. In the "Extract to:" box, make sure the
"Disk" choice is selected. In the text box next to "Disk", you'll need to
fill in the path to where you want to extract the files. (They'll be extracted
into a \linux subdirectory) For example, if your Zip drive is D:\ and that's
where you want to install, then you'll want to put D:\ in the box. Otherwise,
fill in any DOS drive with enough free space to install. When you've got
everything filled in correctly, hit the "Extract" button to extract the files.

Be sure to unzip zipslack.zip at the top of whatever partition you choose
(the \ directory in DOS/Windows). It will create a \LINUX directory there.
If you try to unzip it in a subdirectory or folder, it will not boot correctly.


BOOTING THE LINUX SYSTEM

There are probably countless ways to boot this system once you've unzipped it.
Here, I'll cover two.

Loadlin
-------

Loadlin is a DOS program designed to load the Linux kernel and boot it. In the
\linux directory, you'll find these files:

LOADLIN.EXE: The loadlin loader executable.
LINUX.BAT: A simple DOS batch file to boot Linux using LOADLIN.EXE.
vmlinuz: A Linux kernel with support for SCSI and IDE devices.

You can use the provided vmlinuz kernel (a generic kernel with support for many
devices that will work for most machines), or you can use another Linux kernel
of your choosing by copying it to \linux\vmlinuz over the existing file.
Slackware includes a large collection of precompiled kernels in its \kernels
directory, any of which will work.

To boot the system, you'll need to edit the LINUX.BAT file, and make sure the
root=/dev/XXXX statement on the loadlin line (the one that's not commented out
with 'rem') is set up to use the partition where you unzipped ZIPSLACK.ZIP,
such as /dev/sda4. If you're not sure which partition to use, just go ahead
and guess. If you get it wrong, you'll still be able to use scrollback
(right shift key and PageUp) when the kernel halts to go back and look at your
partitions, noting the names Linux gives them. With this information, you
should be able to edit the LINUX.BAT correctly.

Once LINUX.BAT is edited, you can try to boot the system by entering LINUX on
a prompt while in the \linux directory. IMPORTANT: You'll need to be in
DOS mode for the boot to work. A DOS prompt running under Windows95 will not
work! What you need to do if you use Windows95 is shut the machine down,
selecting the "Restart in MS-DOS mode" selection. Then, you'll be able to use
Loadlin. I've also had great success booting with a "Startup disk" made from
Win95 (Add/Remove Programs in Control Panel, and then "Startup disk" tab) and
then switching into the \linux directory on the target drive and running
LINUX.BAT.

If it doesn't work, the problem could be DOS memory management -- I had to run
both HIMEM.SYS and EMM386.EXE to get LOADLIN to load a large kernel, but it
also worked fine with no memory management. I ran into problems when I tried
to run _just_ HIMEM.SYS.

You can also run LOADLIN directly. Here is a sample boot command to boot Linux
on /dev/sda4 in read-write mode using the kernel file vmlinuz:

loadlin vmlinuz root=/dev/sda4 rw

Using a boot floppy
-------------------

The other way you can boot the system is by using a boot floppy. There's
one provided (bootdisk.img) that uses the generic kernel, or you can use any
of the bootdisks included with Slackware.

To write the image to a floppy disk, use the RAWRITE.EXE program:

rawrite bootdisk.img a:

To boot a Linux system in read-write mode on /dev/sda4, boot the bootdisk. On
the 'boot:' prompt, you'd enter this command:

mount root=/dev/sda4 rw


CONFIGURING THE SYSTEM

Once you've booted the system, log in as 'root'. One of the first things you
should do is add a root password with the 'passwd' command. Then, (if you want
some things like 'df' to work) you'll need to edit /etc/fstab to fix the entry
for your root partition. Seasoned UNIX veterans will probably use 'vi' for
this, otherwise 'mcedit' is another option.

If you're on an ethernet connected to the Internet, you can run 'netconfig' to
configure your network access. You may also need to edit /etc/rc.d/rc.modules
to load a kernel module that supports your ethernet card.

If you use PPP to connect to the Internet, you can configure your PPP
connection using 'pppsetup'.


COMPILING AND DEVELOPING SOFTWARE

Past versions of ZipSlack have also included development tools such as binutils,
gcc, make, and perl, but these things are now too large to include by default.
Luckily, it's still easy to add them if you have enough space to install them.
To add a complete development system you'll need to install the packages from the
Slackware D (development) and L (libraries) series using the installpkg package
utility. For example, if you've mounted a Slackware CD on /mnt/cdrom:

cd /mnt/cdrom/slackware
installpkg d/*.tgz l/*.tgz

Note that this will add more than 300MB of software, so you'd better have the space
for it! If you're looking to add a more modest development environment for C and
C++, you'll need at least these packages for good results:

d/binutils d/gcc d/gcc-g++ d/kernel-headers d/make l/glibc

This will require around 125MB of additional space.

Note that the entire ZipSlack system may be extended using Slackware packages, and
you may even use installpkg to install all of them on top of a basic ZipSlack
system in order to get a fully complete Linux system with X, KDE, and GNOME.

==============

I hope this system makes it easier to get Linux up and running. At around 40
megabytes (or so) most people can download this package in just a few hours.
If you like the ZipSlack installation, let me know so that I'll know that people
are interested in seeing continued support for it. And, if you find any
problems with it, let me know about them.

Have fun!

---
Patrick Volkerding
volkerdi@slackware.com