Category : Files from Magazines
Archive   : DDJ9405D.ZIP
Filename : FILES.TXT

------------ FILES.TXT ------------------

This file contains the list of files included
in the x0.8 DDJ distribution of the MMURTL
Computer Operating System. Reading this file
will give you a feeling for the organization
of the source code and additional sample utilties
included. Simple installation instructions are
at the end of this file.

Mandatory Legalese:

Copyright (c) Richard A. Burgess, 1991-1993
All Rights Reserved
All program source files and text documentation
listed below are provided to you courtesy of
R.A. Burgess via various distribution mediums
as determined by the staff of DR DOBB'S JOURNAL.
You have my permission to use portions of the
source code (algorithms and code sections)
in your commercial and personal programming
projects, and for educational purposes. The only
restriction placed on its use is that it may
NOT be used in a commercial computer operating
system or embedded systems kernel (sold for profit
or not), or distributed commercially, in whole or
part, as a computer operating system or embedded
systems kernel (for profit or not). Only DR DOBB'S
journal has been given my permission to distribute
this version of the code in source, object, or
executable format. This is NOT "shareware,"
NOR is it "public domain."

NO WARRANTY

We provide absolutely NO warranty, to the extent permitted
by applicable state law. Except when otherwise stated in
writing, MMURTL is provided "AS IS" without warranty of
any kind, either expressed or implied, including, but not
limited to, the implied warranties of merchantability and
fitness for a particular purpose. The entire risk as to
the quality and performance of MMURTL is with you.
Should MMURTL prove defective, you assume the cost of all
necessary servicing, repair or correction.

In no event, unless required by applcable law, will
R.A. Burgess or The D-Group be liable to you for damages,
including lost profits, lost monies, or other special,
incidental or consequential damages arising from the use or
inability to use MMURTL (including but not limited to loss
of data or data rendered inaccurate, or losses sustained
by third parties or a failure of the program to operate
with any other programs), even if you have been advised
of the possibility of such damages, or for any claim by any
other party.

-----------------------------------------------
The MMURTL operating system (Version x0.8)

Please read the README.1ST file FIRST, else
you will be like an uninitialized pointer
(lost and probably doing damage).

README.1ST (Read ReadMe.1ST before anything else)
README.2nd (This one is obviously second)
Then... read this file.
-----------------------------------------------------------
The following C and Assembler files are used to build
the OS run image (as an MS-DOS executable)

MOS ASM - Main OS ASM Data & Code file

The following ASM files are "INCLUDED" in MOS.ASM:

MOSEDF INC - OS constant definitions
MOSPDR INC - Initial page directory
MOSGDT INC - Initial Global Desc table

KBDDATA INC - Keyboard variables & data
DVDRDATA INC - Device Driver varaibles & data
VIDDATA INC - Video variables and data
DBGDATA INC - Debugger varaibles & data

KERNEL INC - kernel code
INITCODE INC - Initialization code
MEMCODE INC - Memory handling code
KBDCODE INC - Keyboard Service & ISR code
VIDCODE INC - Video code
DBGCODE INC - Debugger code
DMACODE INC - DMA Hardware code
INTCODE INC - Interrupt handling code
NUMCNVRT INC - General purpose number conversion code
SVCCODE INC - System Service code
RQBCODE INC - Request handling code
TMRCODE INC - Timer code
DVDRCODE INC - Device driver interface code
JOBCODE INC - Job handling code
MISCCODE INC - Miscellaneous code

MPUBLICS INC - Defines OS entry addresses
for applications
(not included in OS code)

The following C source files are built with the CM32
C compiler (MS-DOS version included) using
special options that produce separate Code and Data
assembler files (.CAS and .DAS). These code and data
files are also "INCLUDED" with MOS.asm:

FDD C - Floppy Device driver
HDD C - Hard disk (IDE & MFM) device driver
JOBC C - More job handling code
UASM C - More debugger code
FSYS C - File System code (MS-DOS FAT)
MONITOR C - Monitor code
COMMDRV C - RS-232 Device Driver

The following header (.h) files are used in the
C files for the OS, and are also used by
MMURTL application programmers in their
source files when using the CM32 compiler
to build MMURTL apps:

MKERNEL H - C kernel protos & stuct defs
MJOB H - C Job protos & struc defs
RUNFILE H - C Runfile definitions
MTIMER H - C Timer protos & struc defs
MDEVDRV H - C Device driver protos & struc defs
MDATA H - C Data manipulation protos
MKBD H - C Keyboard protos & defs
MFILES H - C File system protos & defs
MVID H - C Video protos & defs
MMEMORY H - C Memory Protos & defs
COMMDRV H - C Comms Driver defines
STATUS H - C defines for common MMURTL errors

The following are (VERY) simple MS-DOS batch files
that will build the MMURTL OS image.

MAKEJOBC BAT - Calls CM32 to make JOBC.CAS and .DAS
MAKEUASM BAT - Calls CM32 to make UASM.CAS and .DAS
MAKEMON BAT - Calls CM32 to make MONITOR.CAS and .DAS
MAKEHDD BAT - Calls CM32 to make HDD.CAS and .DAS
MAKEFDD BAT - Calls CM32 to make FDD.CAS and .DAS
MAKEFSYS BAT - Calls CM32 to make FSYS.CAS and .DAS
MAKECOMM BAT - Calls CM32 to make COMMDRV.CAS and .DAS

MAKEMOS BAT - Calls Borland TASM to build OS Image

MAKEALL.BAT - Does all of the above in one step

The following file is produced:

MOS EXE - MMURTL OS RUN Image in DOS EXE format
----------------------------------------------------
The following ASCII text files contain the MMURTL
documentation that was applicable to this version.
They are listed in the order I suggest you read them.

NOTE:
The TXT files are saved WITHOUT soft carriage returns.
CR/LFs are located only where HARD CR/LFs were found
in my word processor. This means if you want to print
the doumentation, you should bring it up in your
word processor, set the margins to about 1" on
all sides and print it. This makes it easy for
you to change the font size, reformat it easily, etc.


INTRO DOC - Introcution to MMURTL
MMARCH DOC - MMURTL Architecture
APPLPRG DOC - Application Programming
MMAPI DOC - MMURTL API Spec
JOBS DOC - MMURTL Jobs detail
SYSPRG DOC - MMURTL Systems programming
KBDSVC DOC - Keyboard Services
FILESYS DOC - File System Services
DEBUGGER DOC - Debugger info & commands
MONITOR DOC - Discusses the Monitor program

DMATHERY DOC - Theory on ISA DMA handling code
OSINIT DOC - Discussion on initializing the OS

-----------------------------------------------------
The following are the only three MMURTL applications
provided with this version of MMURTL. They are the
command line interpreter (e.g., Command.com in DOS),
a simple in memory text editor, and possibly the dumbest
terminal program in the history of the world. DUMB is
here only to demo the Comms Device interface.

In order to build the "RUN" files, you need CM32 and DASM
which are both included in their MS-DOS versions in
separate ZIPed files.

CLI C - CLI source
CLI ATF - Assembler Template File (for DASM)
MAKECLI BAT - Simple MS-DOS batch to build CLI.run
CLI RUN - The run file
CLI HLP - displayed in CLI with HELP ccommand
CLI DOC - Command Line Interpreter documentation

EDIT C - Editor source code
EDIT ATF - Assembler Template file (for DASM)
MAKEEDIT BAT - Simple MS-DOS batch file to build edit.run
EDIT RUN - The run file
EDITOR DOC - Editor Documentation

DUMB C - Dumb term source code
DUMB ATF - Assembler Template file (for DASM)
MAKEDUMB BAT - Simple MS-DOS batch file to build Dumb.run
DUMB RUN - The run file
Sorry - no DUMB documentation:
The only command it knows is ALT-X (Exit)
It is simply here to show the Comms Device
Driver programatic interface.
-----------------------------------------------------
Note: Documentation for the CM32 C compiler
and the DASM Assembler are provided with these two
applications in the same format described above.
The CM32 (tm) compiler, and DASM (tm) are completely
separate DOS based applications.

INSTALLATION:

There are 6 files total:

Readme.1st
Readme.2nd
Files.txt (this file)
MMURTL.zip
CM32.zip
DASM.zip

All files and applications should be placed
on the same drive (for the simple MS-DOS
batch files to work).

All Files from MMURTL.ZIP should placed
in the MMURTL Directory (under the root).

CM32.zip files should be in the CM32 directory
under the root (use -d option to unzip).
It will have two subdirectories:
INCLUDE
LIB

All files from DASM.zip should be placed
in the DASM directory.

---------------------------------------
MS-DOS is a trademark of Microsoft Corp.
Intel is a trademark of Intel Corp.

MMURTL, CM32, and DASM are trademarks of
The D-Group & R.A. Burgess

---------- End of List ----------------------