- updated compilation instructions for win32

- added descriptions for the clock sync option
This commit is contained in:
Volker Ruppert 2009-04-29 18:07:56 +00:00
parent c242176a0a
commit 93029206a1
3 changed files with 39 additions and 20 deletions

View File

@ -333,7 +333,13 @@ boot: disk
# This defines the parameters of the clock inside Bochs: # This defines the parameters of the clock inside Bochs:
# #
# SYNC: # SYNC:
# TO BE COMPLETED (see Greg explanation in feature request #536329) # This defines the method how to synchronize the Bochs internal time
# with realtime. With the value 'none' the Bochs time relies on the IPS
# value and no host time synchronization is used. The 'slowdown' method
# sacrifices performance to preserve reproducibility while allowing host
# time correlation. The 'realtime' method sacrifices reproducibility to
# preserve performance and host-time correlation.
# It is possible to enable both synchronization methods.
# #
# TIME0: # TIME0:
# Specifies the start (boot) time of the virtual machine. Use a time # Specifies the start (boot) time of the virtual machine. Use a time

View File

@ -1,7 +1,7 @@
<!-- <!--
================================================================ ================================================================
doc/docbook/user/user.dbk doc/docbook/user/user.dbk
$Id: user.dbk,v 1.256 2009-04-29 12:00:09 vruppert Exp $ $Id: user.dbk,v 1.257 2009-04-29 18:07:56 vruppert Exp $
This is the top level file for the Bochs Users Manual. This is the top level file for the Bochs Users Manual.
================================================================ ================================================================
@ -1876,9 +1876,11 @@ In Bochs 1.3 and before, the X11 GUI was always the default.
</thead> </thead>
<tbody> <tbody>
<row> <row>
<entry>win32 or Cygwin</entry> <entry>win32, Cygwin or MinGW/MSYS</entry>
<entry>--with-win32</entry> <entry>--with-win32</entry>
<entry>If using nmake method, compile using cl /nologo /MT /W3 /EHs-c- /DNDEBUG /DWIN32 /D_WINDOWS /D_CRT_SECURE_NO_WARNINGS. If using Visual C++ workspace, see the workspace file for compile settings. See <link linkend="compiling-win32">Compiling on Win32 with Microsoft VC++</link> for instructions. <entry>If using nmake method, compile using cl /nologo /MT /W3 /EHs-c- /DNDEBUG /DWIN32 /D_WINDOWS /D_CRT_SECURE_NO_WARNINGS.
If using Visual C++ workspace, see the workspace file for compile settings.
See <link linkend="compiling-win32">Compiling on Win32 with Microsoft VC++</link> for instructions.
</entry> </entry>
</row> </row>
<row> <row>
@ -2488,13 +2490,13 @@ The current solution to this problem is that the Bochs
configure script must be run on a different platform that does support configure script must be run on a different platform that does support
shell scripts, with options that cause it to configure for a Win32 shell scripts, with options that cause it to configure for a Win32
platform instead of the native one. Many people have access to a UNIX platform instead of the native one. Many people have access to a UNIX
machine that could run the configure script, or you can use Cygwin to machine that could run the configure script, or you can use Cygwin or
run the configure script MinGW/MSYS to run the configure script.
<footnote> <footnote>
<para> <para>
Because Bochs depends so much on the configure script, if you are doing Because Bochs depends so much on the configure script, if you are doing
much win32 Bochs development, you should consider downloading Cygwin much win32 Bochs development, you should consider downloading Cygwin or
so that you can run the configure step natively. MinGW/MSYS so that you can run the configure step natively.
</para> </para>
</footnote>. </footnote>.
</para> </para>
@ -2513,7 +2515,7 @@ workspace files, and pack it all into a .zip file in the directory above the
source directory <footnote> source directory <footnote>
<para> <para>
If the source directory is <filename>/home/joe/bochs-win32</filename>, the If the source directory is <filename>/home/joe/bochs-win32</filename>, the
resulting .zip file is in <filename>/home/joe/bochs-win32.zip</filename>. resulting .zip file is in <filename>/home/joe/bochs-win32-msvc-src.zip</filename>.
</para> </para>
</footnote>. The .zip file is all ready to transfer to the target Windows </footnote>. The .zip file is all ready to transfer to the target Windows
machine to be unzipped and compiled. Or, if you run the sh/make steps in machine to be unzipped and compiled. Or, if you run the sh/make steps in
@ -2523,21 +2525,20 @@ file.
<para> <para>
When you have the Win32 sources transferred to a Windows machine with VC++, When you have the Win32 sources transferred to a Windows machine with VC++,
find the workspace file called <filename>bochs.dsw</filename> and load it in find the workspace file called <filename>bochs.sln</filename> in the folder
VC++. Choose <command>Project:Set Active Project</command> and be sure that "vs2008" and load it in VC++. Choose <command>Project:Set Active Project</command>
"bochs" is selected. Then choose <command>Build:Build bochs.exe</command>. and be sure that "bochs" is selected. Then choose <command>Build:Build bochs.exe</command>.
This will build all the required libraries (iodev, cpu, etc.) and the auxiliary This will build all the required libraries (iodev, cpu, etc.) and the auxiliary
programs <filename>bximage.exe</filename>, <filename>bxcommit.exe</filename> programs <filename>bximage.exe</filename>, <filename>bxcommit.exe</filename>
and <filename>niclist.exe</filename>. and <filename>niclist.exe</filename>.
</para> </para>
<para> <para>
Using workspaces is easy and intuitive, but there is one caveat. The Using workspaces is easy and intuitive, but there is one caveat. The workspaces
workspaces come directly out of a ZIP file in come directly out of a ZIP file in <filename>build/win32/vs2008ex-workspace.zip</filename>,
<filename>build/win32/workspace.zip</filename>, and they are not controlled by and they are not controlled by the configure script. When you compile with certain
the configure script. When you compile with certain configure options (e.g. configure options (e.g. --with-sdl) you need to link with additional libraries.
--with-sdl) you need to link with additional libraries. For now you must For now you must add them to the VC++ workspace by hand. In version 2.0, we have improved
add them to the VC++ workspace by hand. In version 2.0, we have improved
the situation considerably by adding #if...#endif around every optional file the situation considerably by adding #if...#endif around every optional file
and including nearly every Bochs source file in the workspace. This solves the and including nearly every Bochs source file in the workspace. This solves the
problem of having to manually add source files to the workspace when you turn problem of having to manually add source files to the workspace when you turn
@ -3837,7 +3838,13 @@ This defines the parameters of the clock inside Bochs:
</para> </para>
<para><command>sync</command></para> <para><command>sync</command></para>
<para> <para>
TO BE COMPLETED (see Greg's explanation in <ulink url="http://sourceforge.net/tracker/?group_id=12580&amp;atid=362580&amp;func=detail&amp;aid=536329">feature request #536329</ulink>) This defines the method how to synchronize the Bochs internal time
with realtime. With the value 'none' the Bochs time relies on the IPS
value and no host time synchronization is used. The 'slowdown' method
sacrifices performance to preserve reproducibility while allowing host
time correlation. The 'realtime' method sacrifices reproducibility to
preserve performance and host-time correlation.
It is possible to enable both synchronization methods.
</para> </para>
<para><command>time0</command></para> <para><command>time0</command></para>
<para> <para>

View File

@ -631,7 +631,13 @@ This defines the parameters of the clock inside Bochs.
sync sync
TO BE COMPLETED (see Greg explanation in feature request #536329) This defines the method how to synchronize the Bochs internal time
with realtime. With the value 'none' the Bochs time relies on the IPS
value and no host time synchronization is used. The 'slowdown' method
sacrifices performance to preserve reproducibility while allowing host
time correlation. The 'realtime' method sacrifices reproducibility to
preserve performance and host-time correlation.
It is possible to enable both synchronization methods.
time0 time0