mirror of
https://github.com/reactos/reactos.git
synced 2024-09-28 21:44:31 +00:00
63 lines
2.2 KiB
Plaintext
63 lines
2.2 KiB
Plaintext
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
|
|
|