home *** CD-ROM | disk | FTP | other *** search
- FreeDOS beta9 release candidate 5.
-
- Readme file
-
- Table of Contents:
- ---------------------------------
-
- I) How to view this document
- II) What to get, platform dependant
- III) How to boot up
- IV) Installation
- V) Post-installation disk/RAM layout and configuration files
- VI) Using FreeDOS
- VII) Updates and help
-
- ---------------------------------
-
- I - How to view this document
-
- This document is posted online and thus may incidentally not comply with the
- DOS specification of keeping line width below 80 characters. We recommend
- using a HTML viewer or the FreeDOS program PG, which supports line wrapping,
- found at http://www.ibiblio.org/pub/micro/pc-stuff/freedos/files/util/file/pg/
-
- ---------------------------------
-
- II - What to get, platform dependant
-
- The FreeDOS distribution is available in several ways. Users only wanting to
- use the kernel don't need to download the entire distribution. Owners of a
- computer older than 80386 often don't have a cdrom drive in their systems.
- FreeDOS Beta9 Release Candidate #5 is offered for:
-
- Platform: what to download:
- ---------------------------------------------------------------------
- 8086/80186/80286 : - download diskette distribution if available
- http://fdos.org/ripcord/beta9rc5/disksets
- - alternative #1: download ODIN (One Disk INstaller)
- http://odin.fdos.org/fdodin06.8088.zip
- - alternative #2: download zipfile and split onto disks:
- http://fdos.org/ripcord/beta9rc5/binfiles.zip
- - alternative #3: get FreeDOS install disk
- http://fdos.org/ripcord/beta9rc5/fdos1440.img
-
- 80386 or newer : - download the bootable freedos cdrom
- http://fdos.org/ripcord/beta9rc5/fdbootcd.iso
-
- We recommend to boot from the cdrom as our cdrom driver is
- still in experimental stage (atapicdd.sys , ALPHA status)
-
- if you cannot boot from cdrom, please download bootdisk
- http://fdos.org/ripcord/beta9rc5/fdos1440.img
-
- replace our cdrom driver with the vendor-supplied one if
- desired. [ e.g http://www.opus.co.tt/dave/indexall.htm ]
-
- You may need to write the bootdisk image to a diskette using one of several
- available programs found at: http://www.fdos.org/ripcord/rawrite/
- (RAwrite downloadable from : http://fdos.org/ripcord/beta9rc5/rawrite.exe )
- If the target diskette contains information, it will be erased when writing
- the image contents to the diskette.
-
- The .iso file (ISO9660 filesystem) can be written to a blank recordable medium
- [CD-R(W) or DVD+/-R(W)] using a cd writing program that can write a disk image.
- Most used is Ahead's Nero Burning Rom, and the Unix/Linux program CDrecord
- Make sure contents of the fdbootcd.iso file is stored on the written medium,
- not the file itself. In other words, you should see a file called autorun.inf
- and the directories called FREEDOS and ISOLINUX.
-
- ---------------------------------
-
- III - How to boot up
-
- Virtually all computer systems that FreeDOS can be installed on support booting
- from another medium than the harddisk. This is required for installing FreeDOS
- to your harddisk.
- Old computers support diskette booting, recent computers also support starting
- up from cdrom (the so called El Torito standard dating from 1995)
-
- If you cannot boot from cdrom or do not know how to set up your BIOS
- settings (most systems use DEL, ESC, F2 or F10 keys to access the BIOS)
- to allow booting from cdrom, please boot from diskette.
-
- If you are able to get your system to allow booting from cdrom, that's the
- easiest and best way of installing FreeDOS. Type "1" at the BOOT: prompt and
- then you'll see FreeDOS starting. You should now see another menu. Select
- option 1 to load memory and cdrom drivers. the CDROM is accessed and then you
- can select what to do next (Install FreeDOS, Run FreeDOS, Create bootdisk),
- but more about that later. First the floppy explanation.
-
- For booting from diskette, insert the diskette to which you have written the
- contents of fdos1440.img using WinImage or Rawrite for example.
-
- You should now see a boot menu with 2 options:
- *Select 1 (default and started if waiting 10 seconds) to gain access to
- additional options for recent computers only (386 or newer).
- In the follow-up menu:
- *entering 1 followed by ENTER boots up a fasterversion of the bootdisk
- (bootdisk is read into system RAM and then started)
- *entering 2 followed by ENTER allows you to test your system's RAM
- for potential errors, using the Memtest86+ program, now at version 1.11
- *entering 3 followed by ENTER starts the Smart Boot Manager.
- it is here that you can select to boot from the cdrom device.
- see above at cdrom description how to go on.
-
- *Select 2 (most compatible) to load FreeDOS from the cdrom.
- see below on how to work with FreeDOS once you see the menu
- that offers driver and cdrom loading.
-
- Working with FreeDOS:
- you'll see 4 menu entries, so you need to select the correct one.
- for 8086 and 80186, use entry 2, which does not load any memory drivers,
- but still attempts to load cd-rom drivers.
- for 80286 or newer, select option 1. It loads memory driver and cdrom drivers,
- then tries to detect the FreeDOS cdrom.
- -if the cdrom is found, you'll be presented with a new menu
- (1: Install, 2:Run from cdrom, 3:Create Bootdisk).
- -if the cdrom is not found, you'll be presented an error message
- (cdrom driver not loaded, cdrom not found)
- you get the chance of redetecting cdrom drive (insert correct cdrom),
- doing a diskette install (if made available by the FreeDOS project),
- or giving up (you're on your own then)
-
- see chapter IV - Installation for further info.
-
- ---------------------------------
-
- IV - Installation
-
- Regardless of which way you booted, installing FreeDOS is made up of several
- steps. If you want (or need) to change your disk layout (using a partitioning
- program) , you will need to reboot at least once in this process.
-
- These are the steps you need to follow:
- 1) Partition your harddisk (not recommended unless necessary!)
- 2) Create a filesystem (not recommended unless necessary!)
- 3) Install and configure FreeDOS core files and additional files.
-
- Step1: (not recommended unless necessary!)
- You can change your disk layout by using any partition program.
- most known ones are Fdisk ("program for Fixed Disks") and the Partition Magic
- product from the company Symantec (was PowerQuest Partition Magic).
- DOS *requires* a primary partition with the FAT filesystem that it recognizes as C:.
- Having a C under your modern Windows system using NTFS is not suitable.
-
- KNOW WHAT YOU ARE DOING - ALTERING DISK PARTITION LAYOUT CAN CAUSE DATA LOSS
-
- FreeDOS provides its own version of FDISK, called FreeFdisk.
- Here's what you need to do:
- *Answer yes to the first question (do you want support for FAT32 (big disks?))
- *Create some free (actually unpartitioned) disk space by making sure
- not all disk space is allocated.
- *Create a primary partition in the unallocated space, at least 20 MegaBytes
- (option 1, then option 1)
- *Set it active (option 2 from the main menu)
- *Exit FDISK. You will probably have to reboot. Be sure to boot from the same
- boot device again (diskette/cdrom)
-
-
- Step2: (not recommended unless necessary)
- Once an active primary partition exists, FreeDOS detects this.
- However it still allows to change disk layout by calling the supplied FDISK.
- and offers you to format the partition. If the partition was not yet formatted
- then FreeDOS auto-formats it. If it was formatted, we recommend not to format
- the partition again, as it may contain programs and data you wish to keep
- (creating the FAT [File Allocation Table] filesystem using the FORMAT program
- erases all previous contents)
-
-
- Step3:
- Once the active primary partition actually contains a filesystem, be it
- already present or just created through the FORMAT program, it will allow
- you to install FreeDOS using the installation program.
- We assume the installation program speaks for itself.
-
- All selected files are copied to the selected installation directory,
- the core components installed (kernel - c:\kernel.sys ; shell - c:\command.com)
- and several startup files are created. See following chapter for that.
-
- finally, you are presented information on [1] how to add FreeDOS to another
- already installed operating system (so called Dualboot) or [2]to install
- it all by itself.
- Next, you will get the question if the bootsector code should be written.
- -In case 1, answer no (as it would overwrite the bootsector code of your
- already installed operating system, thus making it not start anymore)
- -In case 2, answer yes, or you will be unable to boot FreeDOS.
-
- All is done now, you have installed FreeDOS to harddisk and can start using it
-
-
- ---------------------------------
-
- V - Post-installation disk/RAM layout and configuration files
-
- This chapter references the layout of both files and memory layout,
- on diskette, cdrom and the harddisk installed FreeDOS distribution.
-
- Feel free to skip this chapter immediately or after the harddisk
- disk layout and conventional memory layout.
-
- * Memory layout (below 1MB) when maximizing free conventional memory,
- using the FreeDOS EMM386 driver. Layout obtained from "MEM /C /P"
-
- Name Total Conventional Upper Memory
- -------- ---------------- ---------------- ----------------
- SYSTEM 18,784 (18K) 12,480 (12K) 6,304 (6K)
- HIMEM 2,112 (2K) 2,112 (2K) 0 (0K)
- EMM386 2,608 (3K) 2,608 (3K) 0 (0K)
- KEYB 1,520 (1K) 0 (0K) 1,520 (1K)
- MOUSE 3,328 (3K) 0 (0K) 3,328 (3K)
- COMMAND 3,264 (3K) 0 (0K) 3,264 (3K)
- DISPLAY 21,104 (21K) 0 (0K) 21,104 (21K)
- Free 782,592 (764K) 637,904 (623K) 144,688 (141K)
-
-
- * Harddisk layout for a fresh installed FreeDOS distribution:
- C:\ Root of active FreeDOS FAT partition
- | AUTOEXEC.BAT Bootup script, contentse see below
- | COMMAND.COM Shell (FreeCOM), translated if possible
- | CONFIG.SYS FreeDOS configuration file
- | FDOSBOOT.BIN Bootsector of drive C: stored in file
- | KERNEL.SYS FreeDOS kernel
- |
- \--FDOS FreeDOS directory
- | +--INSTBASE GUI installer logfiles
- | +--TEMP Directory for storing temporary files
- | +--APPINFO Contains the Linux Software Maps for programs
- | +--BIN Contains FreeDOS programs and drivers
- | | +--CTMOUSE CuteMouse available in several languages
- | | | \--UTILITY CuteMouse debugging program
- | | \--KEY keyboard layout files for KEYB 2.0, zipped(!)
- | +--DOC Contains documentation for each program
- | +--HELP Stores the help-files for freedos program
- | | \--HHSTNDRD called HELP in HTML format
- | +--NLS contains localized help text for some programs
- | \--CPI Internation CodePages for FreeDOS Display program
-
-
- * Created Config.sys bootup file (c:\config.sys or c:\fdconfig.sys):
- ( "!" means always execute, ";" is a comment, "123?" is menu implementation)
- ( our cdrom driver is disabled, as we recommend the VIDE-CDD.SYS from BENQ )
-
- !SET dosdir=C:\FDOS
- !SET lang=NL
- ;for help on commands, see file config.sys in your FreeDOS directory
- ;www.benq.com/ss_download/drivers/storage/cd-rom/drivers/dos/apicd214.exe
- ;below is a demonstration of the FreeDOS multi-configuration menu system.
- !LASTDRIVE=Z
- !BUFFERS=20
- !FILES=40
- !DOS=HIGH,UMB
- !DOSDATA=UMB
- !set dircmd=/ogn
- !MENUCOLOR=7,0
- MENUDEFAULT=1,5
- MENU 1 - Load FreeDOS including HIMEM XMS-memory driver
- MENU 2 - Load FreeDOS with maximum RAM free, using EMM386
- MENU 3 - Load FreeDOS without drivers
- 12?DEVICE=C:\FDOS\BIN\HIMEM.EXE
- 2?DEVICE=C:\FDOS\BIN\EMM386.EXE NOEMS I=B000-B7FF I=DC00-EBFF I=C800-C8FF
- ;1?DEVICE=C:\FDOS\bin\atapicdd.sys /D:FDCD0001
- 12?SHELLHIGH=c:\command.com /K c:\autoexec.bat
- 3?SHELLHIGH=c:\command.com /D /K set path=C:\FDOS\bin
-
- (note that cdrom driver has been disabled. Remove the ;REM part from atapicdd,
- or download the VIDE_CDD.sys file from above named APICD214.exe link)
-
-
- * Created Autoexec.bat bootup file (c:\autoexec.bat or \freedos\fdauto.bat),
- including basic sound support and drivers for keyboard, cdrom and mouse:
- (display driver configuration is an example, and commented out by default)
- (at the end you see some text in Dutch, to demonstrate localized parts)
-
- @echo off
- set PATH=%dosdir%\bin
- set NLSDIR=%dosdir%\NLS
- set temp=%dosdir%\temp
- set tmp=%dosdir%\temp
- SET BLASTER=A220 I5 D1 H5 P330
- REM LH DISPLAY CON=(EGA,,1)
- REM MODE CON CP PREP=((858) %dosdir%\cpi\EGA.CPI)
- REM MODE CON CP SEL=858
- Shsucdx /D:?FDCD0001 /D:?FDCD0002 /D:?FDCD0003
- LH KEYB US,,C:\FDOS\bin\KEY\US.KL
- echo typ HELP om ondersteuning te verkrijgen over opdrachten en navigatie
- echo.
- echo FreeDOS heet u welkom.
- echo.
- MOUSE
-
-
- * FreeDOS downloadable Bootdisk RAM contents (Modules using memory below 1MB):
- (note that EMM386 is not enabled by default, as EMM386 settings are specific
- to each individual computer system)
-
- Name Total Conventional Upper Memory
- -------- ---------------- ---------------- ----------------
- SYSTEM 17,600 (17K) 12,480 (12K) 5,120 (5K)
- HIMEM 2,112 (2K) 2,112 (2K) 0 (0K)
- EMM386 2,608 (3K) 2,608 (3K) 0 (0K)
- UDMA 624 (1K) 624 (1K) 0 (0K)
- COMMAND 3,984 (4K) 0 (0K) 3,984 (4K)
- SHSUCDX 6,656 (7K) 0 (0K) 6,656 (7K)
- ELTORITO 3,104 (3K) 0 (0K) 3,104 (3K)
- CDRCACHE 6,016 (6K) 0 (0K) 6,016 (6K)
- Free 792,464 (774K) 637,136 (622K) 155,328 (152K)
-
-
- * FreeDOS downloadable Bootdisk image contents:
-
- A:\ Root of diskette(-image)
- | LDLINUX.SYS Syslinux bootloader
- | README.TXT FreeDOS readme document
- | MEMDISK Syslinux RAMDISK DISK-image loader
- | FDCONFIG.SYS FreeDOS bootup configuration file
- | SYSLINUX.CFG Syslinux configuration file
- | SBM.CBT Smart Boot Manager compiled as Syslinux module
- | COMMAND.COM FreeDOS command interpreter / shell (FreeCOM)
- | FDBOOT.IMG 360KB FreeDOS bootimage for MEMDISK
- | MEMTESTP Memtest+ version 1.11 (www.memtest.org)
- | METAKERN.SYS FreeDOS bootmanager
- | KERNEL.SYS FreeDOS kernel/core, release version 2.033
- |
- +--FREEDOS Directory containing freedos applications
- | ATTRIB.COM (Re)sets file and directory attributes
- | CALLVER.COM Fakes DOS version for a specific file you load
- | COPYBS.COM Copies partition's bootsector to a file on disk
- | FDAUTO.BAT Bootup script, called from fdconfig.sys
- | FDISK.EXE The "Fixed Disk" partitioning program
- | FDISK.INI Configuration file for Fdisk
- | FORMAT.EXE Creates FAT (FAT12/FAT16/FAT32) filesystem
- | GPL.COM The General Public License in executable format
- | IFMEMDSK.COM Detects if Iso/Sys-Linux was loaded with Memdisk
- | LOADLIN.EXE Linux bootloader
- | LOCALIZE.COM CATS implementation for displaying text from file
- | MEMTEST2.EXE unofficial Memtest86 v3.0 executable version
- | META-ALL.BIN MetaKern bootloader primary stub
- | METABOOT.BOT MetaKern bootloader freedos kernel loader
- | SYS.COM Transfers FreeDOS core files and makes disk bootable
- | WHICHFAT.COM Detects which FAT implementation is used on partition
- | XCOPY.EXE Copies files and directories
- | LABEL.EXE Sets the label of a disk
- | PG.EXE advanced textfile viewer
- | EDIT.EXE textfile editor
- | MEMTESTE.EXE fallback version of Memtest.exe
- |
- +--DRIVER contains FreeDOS drivers
- | ATAPICDD.SYS cdrom driver, alpha-status
- | CDRCACHE.SYS cdrom caching module
- | CTMOUSE.EXE CuteMouse serial/PS2 mouse driver
- | DEVLOAD.COM Commandline device driver loading utility, UMB support
- | ELTORITO.SYS Bart Lagerweij's boot-from-cdrom cdrom-driver
- | FDXMS286.SYS XMS driver for 286 and newer, up to 16 or 64MB RAM
- | HIMEM.EXE XMS driver for 386 and newer, up to 2048MB RAM
- | SHSUCDX.EXE Provides driveletter to each cdrom drive (MSCDEX)
- | UDMA.SYS Speed up harddisk writes and reads by DMA transfers
- | ATAPICD2.SYS Incomplete newer test version of ATAPICDD.sys
- | EMM386.EXE UMB and EMS providing memory optimizing driver
-
-
- * CDROM image contents
-
- [CDROM]
- | BOOT.CAT MKISOFS's El-Torito Boot Catalogue
- | AUTORUN.INF auto-launch file for Windows
- |
- +--FREEDOS FreeDOS specific files
- | +--3RDPARTY (Freeware/GPL) third party addons
- | +--DOCS Various important documents
- | | +--LICENSES useful License Stuff
- | | \--MOREINFO older license stuff
- | |
- | +--PACKAGES installable programs
- | | +--BASE FreeDOS basic components
- | | | +--DISK01 disk#1 up to and including disk#7
- | | |
- | | \--SRC_BASE Sourcefiles for basic components
- | | +--DISK01
- | | +--DISK02 Sourcefiles for FreeCOM
- | | +--DISK03 Sourcefiles for Defrag
- | | +--DISK04 Sourcefiles for FreeDOS kernel 2033
- | | +--DISK05 Sources for FreeDOS programs,
- | | +--DISK06 disk#5 up to disk#10
- | |
- | |
- | \--SETUP
- | +--BATCH
- | | AUTORUN.BAT FreeDOS batch logic for menu's
- | | BOOTDISK.BAT Creates a FreeDOS bootdisk
- | | MENU1.BAT Handles user output for menu 1
- | | MENU2.BAT Handles user output for menu 2
- | | POSTINST.BAT Finds the post-installation batchfile
- | | TEXTMENU.BAT Handles Fdisk/Format/Installer
- | |
- | +--BIN Contains necessary programs
- | | \--KEY Keyboard layouts for non-US keyboards
- | +--INSTALL
- | | | INSTALL.EXE Graphical User Interface installer,
- | | | INSTALL.INI by Sergej Kozlovich
- | | | INSTALL.MIN specify which disksets to present
- | | | INSTALL.TXT required by GUI installer
- | | | LICENCE.TXT required by GUI installer
- | | | TEXTINST.EXE Textmode (fallback) installer, JeremyD
- | | | in case GUI fails to create \fdconfig.sys
- | | | or for (8086/186/286)systems without cdrom
- | | |
- | | +--EN Translated text-files, English
- | | +--ES Translated text-files, Spanish
- | | \--NL Translated text-files, Dutch
- | |
- | +--LANGUAGE Long installation textfiles,
- | | +--DE translated into German,
- | | +--EN English
- | | +--ES Spanish
- | | \--NL Dutch
- | |
- | \--NLS Translated texts for batchfile use
- |
- \--ISOLINUX Isolinux bootloader (isolinux.zytor.com)
- | ISOLINUX.CFG Isolinux Menu configuration file
- | MAKEISO.BAT ISO9660 creation batchfile for Windows
- | ISOLINUX.BIN Isolinux non-emulation mode bootloader
- |
- +--DATA
- | BOOTMSG.TXT Tells user which keys to press
- | F1_HELP.TXT Tells user which keys to press
- | F2_LICEN.TXT Tells user FreeDOS distributed under GPL
- | FDBOOT.IMG FreeDOS bootup disk image, 360KB
- | F_ABOUT.TXT About FreeDOS
- | LOGO.LSS Splashscreen you see when booting cdrom
- | MEMDISK RAMDISK Loader for (diskette) image files
- |
- +--BUILDCD
- | COMMAND.COM FreeCOM, DOS/Win9x shell too limited
- | MKISOFD.RC FreeDOS-specific MKISOFS resource file
- | CYGWIN1.DLL Cygwin Win32 subsystem for running MKISOFS
- | DFL.EXE Duplicate File Linker (dangerous)
- | MKISOFS.EXE MKISOFS cdrom image creation program
-
-
- ---------------------------------
-
- VI - Using FreeDOS
-
- We must assume you are familiar with the DOS operating system.
- This README document is not the place to explain that.
-
- You can get help in the following ways:
- *HELP
- *programname /?
- *HELP programname
- *FASTHELP programname
- *read documents located in the DOC subdirectory of your installation directory
-
- if that's not enough to help you, feel free to submit your problem or question
- to the FreeDOS user's list. See end of this document for the email address.
-
-
- ---------------------------------
- VII - Updates and help
-
- -A newer FreeDOS distribution may be found at www.freedos.org/freedos/files/
-
- -Updated software is available from http://www.freedos.org/freedos/software/
-
- -The FreeDOS kernel may be updated by replacing C:\KERNEL.SYS with a newer
- version, which can be obtained from:
- [official release] http://sourceforge.net/project/showfiles.php?group_id=5109
- [weekly from CVS ] http://fdos.org/bootdisks/
- http://fdos.org/bootdisks/autogen/FDOEM.144.imz
- [alternative ] http://linux.tu-varna.acad.bg/%7Elig/romdsk/romd-bin.rar
-
- or compiled (use OpenWatCom 1.2 for example) from sources:
- [daily CVS source ] http://freedos.sourceforge.net/kernel/kernel.tgz
-
-
- -Bugs may be reported at the FreeDOS bug database
- [ http://www.freedos.org/bugs/bugzilla/ ], or at the developer's mailinglist
- [ read: http://sourceforge.net/mailarchive/forum.php?forum=freedos-devel ]
- [ subscribe to: http://www.freedos.org/freedos/lists/ ]
- [ send message: freedos-devel@lists.sourceforge.net ]
-
- for general help please consult the FreeDOS user mailinglist,
- [ read: http://sourceforge.net/mailarchive/forum.php?forum=freedos-user ]
- [ subscribe to: http://www.freedos.org/freedos/lists/ ]
- [ send message: freedos-user@lists.sourceforge.net ]
-
-
- thank you for reading this lengthy document, and good luck
-
- Bernd Blaauw,
- 2004-04-20