- Concurrent DOS for the Motorola MC68000 VME/10
DISK1.DOC Developer Kit Disk 1 - Boot Disk and Executable
Utilities (part 1)
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
In this release of Concurrent DOS 68K the operating system's function-
ality and characteristics are defined in two phases; 1) the initial hardware
configuration and the user environment are defined during system generation
(when the CDOS.SYS file is created) by the VMCONFIG.C file, and 2) at system
load time via the files CONFIG.BAT and AUTOEXEC.BAT. Be sure to edit these
files to correspond to any changes you make to your hardware or software
organization.
This version of Concurrent DOS is shipped with a system that includes
the CP/M 68K front end and may be booted from either the floppy or the hard
disk. Instructions for booting from the hard disk are included in the
Concurrent DOS for the Motorola MC68000 Release Note.
For the VME/10 the window manager keys are as follows:
Function Key
<WINDOW> SEL
<HELP> PAD FUNC + HELP
<NEXT> -->| (the tab key on the arrow keypad)
<PREV> |<-- (the backtab key on the arrow keypad)
DISK2.DOC Developer Kit Disk 2 - Executable Utilities
(part 2) and UNIX-like
Utilities (part 1)
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This disk contains the remainder of the CDOS native utilities and part
1 of a set of general purpose tools similar to some of the tools provided with
UNIX. These UNIX-like tools are provided to help system developers and
application programmers create and maintain files. These tools are documented
in the PROGRAMMER'S UTILITIES GUIDE SUPPLEMENT.
DISK3.DOC Developer Kit Disk 3 - UNIX-like Utilities
(part 2), CP/M 68K Tools,
Special Utilities, and
Code Sample
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This disk contains the following programming tools and sample code:
Subdirectory Explanation
U_TOOLS Remainder of the UNIX-like tools. Documented in the
PROGRAMMER'S UTILITIES GUIDE SUPPLEMENT.
TOOLS CP/M 68K programming tools; requires the CP/M 68k
front-end be present. The utilities COMBINE and
EXPAND are CDOS native mode utilities that are
useful for conserving disk space used to store
small files. The typical naming convention is to
give COMBINE'd files the extension ARC. All of these
programs are documented in the PROGRAMMER'S UTILITIES
GUIDE.
SAMPLE Some of the Window Manager source is provided as an
example of a program that implements windowing tech-
niques, message passing, and process creation.
In addition to the files listed in the release note
the following files are included in the SAMPLE
subdirectory:
CCUTLS.H
UTLERRS.H
DISK4.DOC Developer Kit Disk 4 - Programmer's Utilities
and Tools and C Compiler
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This disk contains the assembler, C compiler, linkers, debugger, and
other programming tools and utilities. These tools and utilities are all
documented in the PROGRAMMER'S UTILITIES GUIDE. Supplemental discussions
of assembly language programming conventions, file load formats, and the use
of the COFF and CRUNCH utilities are contained in the CONCURRENT DOS
SUPPLEMENT FOR COMPUTERS BASED ON THE MOTOROLA MC68000 FAMILY OF
MICROPROCESSORS.
The C library contains CP/M 68K code rather than CDOS 68K native mode
code and therefore, the executable files produced can only be run on CDOS 68K
systems that include the CP/M 68K front end. CDOS native mode C programs can
be produced by using the SYSLIB.L68 library included on Developer Kit Disk 5.
DISK5.DOC Developer Kit Disk 5 - SYSTEM LIBRARY
6 August 1986 CDOS 68K, ver. 1.2
-----------------------------------------------------------------------------
This diskette contains the sources, linkable library, submit files,
and batch files for a library that will allow you to write almost normal 'C'
programs that will execute under CDOS version 1.2 for the MC68000 family of
microprocessors. In addition to the files listed in the Release Note, the
following files are provided on this diskette:
SYSLINK BAT COMPL68 BAT
LD C BUILDL68 BAT
STD40 H LDIV S
LIBCALLS H LREM S
OSIF O LMUL S
GSTART O STRNCMP C
GSTART C STRCAT C
OSIF S STRCPY C
The following files listed in the Release Note have not been provided:
CRCK.C
QATOOLS.C
PRINTF.C
JPRT.C
This library is designed for use with the CP/M 68K C compiler and
contains the necessary 'C' functions to permit extremely sophisticated
system programs however, it is by no means complete. K&R standards were not
strictly adhered to. Two sample programs have been included as an illustra-
tion of what can be done with this library and to allow you to learn from
what we have learned.
SUBMIT FILES:
The submit files, which were originally provided for use in a CP/M
68K crosss-developement mode, compile and link the library source
into the file SYSLIB.L68. Use the the batch files of the same names
under CDOS 68K.
The submit files are meant to be more than just tools; they are
also valuable examples of how things can be accomplished. Feel free
to study and modify them to suit your needs.
COMPL68.SUB -- This file will compile and assemble all
of the source modules for SYSLIB.L68.
BUILDL68.SUB -- Invokes AR68 to archive all of the .O files
to create the library.
BATCH FILE:
COMPL68.BAT -- See COMPL68.SUB
BUILDL68.BAT -- See BUILDL68.SUB
SYSLINK.BAT -- An example of the linker command line to link
a program with the system library.
SAMPLE PROGRAMS:
CVT40.C -- A simple program to perform numeric
conversions. Hexadecimal numbers are proceeded by a
'0x', octal numbers are prefixed with '0', and decimal
numbers begin with the decimal digit. This program
demonstrates the use of the SYSLIB functions.
LD.C -- Does S_LOOKUPS on the Disk File Table looking
for sub-directories. LD may be invoked with or without a
argument. Wild cards are allowed.
DISK6.DOC Developer Kit Supplement Disk 1 - Driver and System
Sources
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This diskette is organized into three subdirectories:
DRV_SRC -- Contains all of the CDOS 68K driver modules in source form.
In addition to the files listed in the release note, this subdirectory
contains the file CPASM.BAT which is used to process the RAMDISK driver
source component BTOOLS.PS. To produce a loadable ramdisk driver, the
linker output file RDD.68K must be processed by the CRUNCH utility.
SYS_SRC -- Contains all of the CDOS 68K system configuration modules
in source form. Also, the file listed in the release note as OMMUA.S
is named OMMUA.PS. Files with the file extension "PS" are assembler
files that use the #include directive and must be processed by the C
preprocessor CP68.68k.
HEADERS -- Contains all of the .h files used to compile the sources
in DRV_SRC and SYS_SRC.
In order to conserve disk space, some of the .h files that are used to
compile the SYSLIB sources may not have been duplicated on this disk. Check
Developer Kit Disk 5 for additional .h files.
DISK7.DOC Developer Kit Supplement Disk 2 - System Debugger,
System Generation
Tools and Objects
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This diskette is organized into two subdirectories:
DEBUGGER -- Contains all of the files necessary to debug a CDOS 68K
system under CP/M 68K. Instructions for using the cross-environment
debugger are provided in the CDOS 68K Release Note.
SYS_GEN -- Organized into two subdirectories:
TOOLS -- Contains .BAT and .COM files to link a new system file.
The different permutations of hardware and features are described
in the CDOS 68K Release Note. To link a new system file you must
increase the stack size of LINK68.68K to F000h with the following
command:
SS -sf000 link68.68k
OBJECTS -- Contains some of the objects files required to link a new
system file.
NOTE: The files BASE.O, COFFLOAD.O, and COMMAND.O are on Developer Kit
Supplement Disk 2 instead of Developer Kit Disk 3 as shown in the CDOS
68K Release Note.
DISK8.DOC Developer Kit Supplement Disk 3 - System Generation
Objects
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This diskette is contains the remainder of the object files required to\
generate a new system file. In general the files are organized into the
following categories:
File System files:
FSCACHE.O
FSDM.O
FMNAME.O
FSPATH.O
FSVOL.O
FSWINDOW.O
HOOK.O
CP/M 68k Front End files:
FE1.O
FE2.O
FE68.O
FESTUB.O (used in systems with no front end)
FEINIT.O
FEMAIN.O
FE.O
FEU1.O
FEU2.O
FPOOL.O
FPOOL68K.O (used in systems with no front end)
FPRINTF.O
SUP68K.O
SUP68KNF.O (used in systems with no front end)
Console Driver files:
VCDRCOPY.O
VCDRTOOL.O
VCDRV.O
VCDRVWRT.O
IBMTOVM.O
VMCONASM.O
VMKB.O
Disk Driver files
VMDISKA.O
VMRWINDK.O
Serial Port Driver files
VM400.O
VT52.O
SDRV.O
DRT.O
Kernel, Resource Managers and Misc. files
ABORT.O AFLAG.O ALLOCATE.O ASYNC.O
ASYNCA.O BASE.O COFFLOAD.O COMMAND.O
CPMLOAD.O CRMAN.O CRMCONV8.O CRMCOPY.O
CRMCREAT.O CRMDEL.O CRMREAD.O CRMGSL.O
CRMINST.O CRMKB.O CRMMOUSE.O CRMOPEN.O
CRMRDEL.O CRMWIND.O CRMWRITE.O CRMXLAT.O
DINIT.O DVRIF.O EXCEPT.O FREE.O
HEAP.O INSTALL.O KFUNCS.O KTOOLS.O
LOAD68K.O LUTILS.O M68.O MISMAN.O
MGETBLK.O NULLDEV.O OFILE.O OSMEM.O
OVERLAY.O PANIC68.O PEWTER.O PIPE.O
PMGET.O PROCESS.O RDELIM.O RTMIF.O
SUPERMAN.O SWI68K.O TABLES.O TOOLS.O
VMCLK.O VMCONFIG.O VMPANIC.O VMQUEUE.O
VPROBE.O
NOTE: The files BASE.O, COFFLOAD.O, and COMMAND.O are on Developer Kit
Supplement Disk 2 instead of Developer Kit Disk 3 as shown in the CDOS
68K Release Note.
DISK9.DOC OEM Redistribution Kit Disk 1 - Utility Objects
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This diskette contains the object files and batch files to build the
following utilities:
RECDIR
FSET
MORE
SORT
CHKDSK
PROCESS
CONFIG
RENAME
DATE
DIR
DISKSET
FIND
TIME
TREE
TYPE
COPY
VER
VOL
BACKUP
WMEX
RESTORE
LOGON
COMP
PASSWORD
RECFILE
DISK10.DOC OEM Redistribution Kit Disk 2 - System Libraries
Shell Objects, Booter
Source, and OEM
Configurable Utilities
Sources
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This diskette is organized into the following subdirectories:
L68S -- System libraries linked into the shell and the CDOS utilities.
SHEL_OBJ -- Shell object file and the linker input file SHELL.COM to
regenerate the shell.
BOOTER -- Sources to the booter used with CDOS 68K for the VME/10.
CFG_UTL -- Sources and linker input files for the following OEM
configurable utilities:
COFF
FORMAT
SYS
DISKCOMP
DISKCOPY
CRUNCH
SS
This subdirectory also includes the files PORTAB.H and STDIO.H. These
are special versions the header files designed specifically for use when
compiling the BOOTER and other utilities. Do not use other versions of
PORTAB.H or STDIO.H when compiling sources included on this disk.
DISK11.DOC OEM Redistribution Kit Disk 3 - System Message Source,
CP/M68K to CDOS File
Transfer Utility, and
Special Sources
6 August 1986 CDOS 68K ver. 1.2
_______________________________________________________________________________
This diskette is organized into the following subdirectories:
CCMSGS -- Contains the sources to all of the general system messages in
COMBINE'd file format. Convert to individual files using the EXPAND
utility.
UTL_MSGS -- Contains the sources to these utilities in COMBINE'd file
format. Convert to individual files using the EXPAND utility.
RECDIR
FSET
MORE
SORT
CHKDSK
PROCESS
CONFIG
RENAME
DATE
DIR
DISKSET
FIND
TIME
TREE
TYPE
COPY
VER
VOL
BACKUP
WMEX
RESTORE
LOGON
COMP
PASSWORD
RECFILE
Source -- Contains the source to files which must be modified to run CDOS
68K on a Motorola 68020 microprocessor. See the CDOS 68K Release Note
for additional information; these files are named DISPA.PS and MMU.PS and
should be assembled using the CPASM.BAT file found in the DRV_SRC directory
on Developer Kit Supplement Disk 1. This subdirectory also contains the
files STRUCT.EQU, PANIC.EQU, and CPUMMU.EQU which are not shown on the list
of included files in the RELEASE NOTE.
VMUTIL -- Contains the source and executable file for the CP/M 68K to CDOS
68K file transfer utilitiy.
SHEL_MSG -- Contains the sources to the utilities built in to the shell in
COMBINE'd file format. Convert to individual files using the EXPAND utility.