reactos/reactos
1998-11-29 19:28:18 +00:00
..
apps more chages to bring up to krnl0012 1998-10-05 14:31:06 +00:00
doc This commit was generated by cvs2svn to compensate for changes in r52, 1998-10-05 04:01:30 +00:00
drivers Used Ext partition detection macro and less intrusive register maps 1998-11-29 19:28:18 +00:00
iface/native Initial revision 1998-10-05 04:00:59 +00:00
include added support for CHECKED macro 1998-11-29 19:11:10 +00:00
lib udpate 1998-11-07 21:38:16 +00:00
loaders brings code in line with release 12 1998-10-05 04:50:07 +00:00
ntoskrnl Thread should be restarted in passive level. 1998-11-29 19:24:46 +00:00
boot.bat This commit was generated by cvs2svn to compensate for changes in r52, 1998-10-05 04:01:30 +00:00
copying_rex Initial revision 1996-01-23 01:02:17 +00:00
DIRS Initial revision 1998-10-05 04:00:59 +00:00
makefile.dos This commit was generated by cvs2svn to compensate for changes in r52, 1998-10-05 04:01:30 +00:00
makefile_rex brings code in line with release 12 1998-10-05 04:50:07 +00:00
NEWS Initial revision 1998-10-05 04:00:59 +00:00
README Initial revision 1998-10-05 04:00:59 +00:00
readme_rex This commit was generated by cvs2svn to compensate for changes in r10, 1998-08-25 04:27:41 +00:00
rules.mak added CHECKED to defines 1998-11-29 19:09:49 +00:00
TODO added driver unloading to list 1998-11-29 19:08:21 +00:00

Last updated 30/09/98

-- Compiling

Type 'make' to build the kernel on linux using a djgpp cross compiler, or
'make -fmakefile.dos' to build the kernel from dos using djgpp. No other 
configuration are supported at the moment, sorry.

-- Running

To run the kernel start from a clean dos system (no emm386 or windows) and
run 'boot.bat'. The kernel should boot, print diagnostic messages and begin
executing a simple user-mode shell. By default the kernel boots with a
minimum set of drivers but additional ones can be specified as the arguments
to 'boot.bat'.

-- Problems

This is strictly alpha quality software so expect plenty of those. If you
are submitting a bug report, please see the section below. If you have a fix 
for the problem, even better, please send all patches, fixes, enhancements etc 
to me (David Welch), our coordinator Dennis Winkley or the kernel mailing
list. (See contact addresses below)

-- Bug Reports

Thank you for taking the time to do this, we can only fix the bugs we know
about, however please include as much information as possible. Say what you
were trying to do at the time, what messages (if any) were displayed. If the
kernel crashed, it should print a message like this

     Exception s(r)
     CS:EIP    p(q)
     DS xxxxx ES xxxx FS xxxx
     ...
     Frames: xxxxx xxxxx xxxxx

Please include the exception type and error code (s and r). The eip 
address (q) is specific to your kernel, to be of use in fixing the problem
it needs to be translated to a function name. Do this by running

      nm --numeric-sort kimage > kernel.sym

kernel.sym should include a list of functions and their address, look for the
last function with an address less than the eip value. The functions should
sorted in ascending order by address.

If you suspect the problem is hardware related also include details of what
hardware devices you have installed.  

-- Contact addresses

Overall coordinator, Jason Filby (jasonfilby@yahoo.com)
Kernel coordinator, Dennis Winkley (dwinkley@mail.whitworth.edu)
Me, David Welch (welch@mcmail.com)

Specific components will probably have contact details for the authors in
the source file, a partial list of those working on the kernel can be found
on the kernel website. 

-- Additional documentation