read.me

一个多任务操作系统CTask的源代码 用C语言编写

           The upper byte contains the line status on return, the lower
           byte the received character.


   Note: The port should not be used for other, especially interrupt
   driven, activities. The tsk_cprint... routines use polling to allow a
   snapshot to be output even when the system is unstable.


                ----------------------------

When compiling some of the files, you will get warnings about
unreferenced formal parameters. This is normal, and should be
ignored. The Turbo C pragma for turning off those warnings is not
compatible with Microsoft, so it is not used in the current version.

Please inspect the sample sources before trying them out. Some samples
use serial output, and may hang if no terminal is connected to the serial
port. Other samples may directly access video memory on mono or color
cards without checking for their existance, which may crash your system.
The samples are provided only as a test base, not as ready-to-use code.

                ----------------------------

Note that the Turbo C batch and make files refer to "lib" and
"tmake", where Turbo users would normally use "tlib" and "make". This
is to resolve naming conflicts in my own configuration. To use the
files in a "standard" Turbo configuration, you may have to edit the
files, or provide suitable alias definitions.

The huge model make files are not yet up to date with new versions of BC.
If you should need huge model support, you may have to edit the make files,
please use the standard make files as an example.

                ----------------------------

Don't use TASM 1.0 to assemble the CTask routines. Version 1.0 of
Borland's TASM has severe problems with the extended model
directives, which will cause Assembly time errors, and, if you get
past them, run time crashes. Versions 1.01 and later of TASM are safe
to use.

You can also use MASM 5.1 for the TC version, just edit the make
files to change the assembler name.

You will probably NOT be successfull trying to assemble the CTask
routines with MASM 6.0. Microsoft managed to make their new version
so totally incompatible with the old one that it's quite a feat to
adapt sources to the new version while still staying compatible with
the other assemblers. On top of this, MASM 6.0 is extremely buggy.
Therefore, I will not adapt CTask to 6.0. If you don't have access to
MASM 5.1, please get Borlands TASM.

From what I have heard, Microsoft MASM 6.1 is supposed to be more
useable than 6.0, especially regarding 5.1 compatibility. I don't have
a copy of 6.1 yet, so you'd have to check it out yourself.

                ----------------------------

The manual included is ready for printing. No fancy formatting 
was used, and the page length was chosen to fit the short 
American sized paper. The only control character your printer 
must understand is the formfeed. 

                ----------------------------

Files in the archives:

Compiled CTask kernel and support routines

   CTASKMS.LIB  CTask kernel, Microsoft C (any model)
   CTSUPMSL.LIB CTask support routines, MS-C (large model)

        The files were compiled with MSC 8.0 (MS Visual C++ 1.0).

   CTASKTC.LIB  CTask kernel, Turbo C (any model except Tiny & Huge)
   CTSUPTCL.LIB CTask support routines, Turbo C (large model)

        The files were compiled with Borland C++ 3.1.

Documentation

   READ.ME      This file
   CTASK.DOC    Documentation for CTask, ready for printing
   FERRARI.DOC  Commercial advertising, required reading

   CTASK.DEF    Periscope debugger record definition file

Include Files

   KBD.H        Keyboard scan code and flag definitions for Hotkeys
   PRT.H        Include file required for printer driver
   SIO.H        Include file required for serial driver
   TSK.H        Include file required for CTask kernel
   TSKCONF.H    CTask configuration options (C and Assembler)
   TSKDEB.H     Debug mode configuration (C and Assembler)
   TSKLOCAL.H   Include file for internal CTask use
   TSKPRF.H     Function prototypes for printf replacement routines
   TSKSUP.H     Include file required for support routines

   TSK.MAC      Assembler include file

Source files for the CTask kernel
                
   TSKASM.ASM   Scheduler and miscellaneous ASM routines
   TSKBIOS.ASM  AT BIOS wait/post handler (INT 15)
   TSKDOS.ASM   DOS multiplex interface for CTask
   TSKEMS.ASM   EMS support routines
   TSKINT17.ASM BIOS printer interface (INT 17)
   TSKKBD.ASM   Keyboard interface and hotkey handler
   TSKNDP.ASM   Numerioc coprocessor support routines
   TSKPRTI.ASM  Printer driver interrupt stack switcher
   TSKQUE.ASM   Queue handling
   TSKRES.ASM   CTask residency check
   TSKSEC.ASM   DOS and Keyboard interface routines
   TSKSIOI.ASM  Serial driver interrupt stack switcher
   TSKSTCK.ASM  Stack switch routine
   TSKSTUB.ASM  Code sharing function stubs/entry table
   TSKTIM.ASM   Timer tick interface (INT 8)

   TSKBUF.C     Buffer events
   TSKCNT.C     Counter events
   TSKFLG.C     Flag events
   TSKGRP.C     Group creation/removal
   TSKHOT.C     Hotkey creation
   TSKINST.C    Main kernel installation/removal
   TSKMAIN.C    Main CTask installation routines
   TSKMEMW.C    Memory watches
   TSKMSG.C     Mailbox events
   TSKNAME.C    Name searching
   TSKPORW.C    Port watches
   TSKPIP.C     Pipe events
   TSKPRT.C     Printer driver
   TSKRSC.C     Resource events
   TSKSIO.C     Serial I/O driver
   TSKSUB.C     Subroutines for internal CTask use
   TSKTASK.C    Main task related routines
   TSKTICK.C    Ticker handling
   TSKTOPS.C    Timeout and watch routines
   TSKTSUB.C    Timer/watch helper subroutines
   TSKTTSK.C    Timer task
   TSKTUTL.C    Task utility subroutines
   TSKUTIL.C    Miscellaneous utilitiy routines
   TSKWPIP.C    Word pipe events

Support routine source files

   CONOUT.C     Console output support
   TSKALLOC.C   Memory allocation RTL interface
   TSKSNAP.C    Snapshot dump utility
   TSKPRF.ASM   Printf replacement routines

Sample application sources

   MINRES.ASM   Minimal resident CTask
   TESTMOD.ASM  Check for model independence

   RES.C        CTask TSR
   SNAP.C       Snapshot dump
   SPAWN.C      Spawn DOS
   TEST.C       General Test
   TPRT.C       Test printer driver
   TSIO.C       Test serial driver

Batch files to make kernel and samples

   MS.BAT       Make Kernel and support routines, MS-C
   SAMPMS.BAT   Make Sample applications, MS-C
   CTC.BAT      Make Kernel and support routines, Turbo C
   SAMPTC.BAT   Make Sample applications, Turbo C
   TCH.BAT      Make Kernel and support routines, Turbo C Huge model
   BC.CFG       Compiler configuration file, BC++ 3.1
   CBC.BAT      Make Kernel and support routines, BC++

Microsoft Make files for Microsoft C 6.0/MASM 5.1

   CTASK.MS     Make Kernel
   CTSUP.MS     Make Support Routines

   MINRES.MS    Make MINRES.ASM
   RES.MS       Make RES.C
   SNAP.MS      Make SNAP.C
   SPAWN.MS     Make SPAWN.C
   TEST.MS      Make TEST.C
   TESTMOD.MS   Make TESTMOD.ASM
   TPRT.MS      Make TPRT.C
   TSIO.MS      Make TSIO.C

Borland Make files for Turbo C/TASM

   CTASK.TC     Make Kernel
   CTASK.BC     Make Kernel, BC++
   CTSUP.TC     Make Support Routines
   CTSUP.BC     Make Support Routines, BC++

   CTASKH.TC    Make Kernel, Huge model
   CTASKH.BC    Make Kernel, Huge model, BC++
   CTSUPH.TC    Make Support Routines, Huge model
   CTSUPH.BC    Make Support Routines, Huge model, BC++
                
   MINRES.TC/BC Make MINRES.ASM
   RES.TC/BC    Make RES.C
   SNAP.TC/BC   Make SNAP.C
   SPAWN.TC/BC  Make SPAWN.C
   TEST.TC/BC   Make TEST.C
   TESTMOD.TC/BC Make TESTMOD.ASM
   TPRT.TC/BC   Make TPRT.C
   TSIO.TC/BC   Make TSIO.C