xfree86/int10/INT10.HOWTO

14 xfree86/os-support/int10/xf86int10.h must be included.
26 will  be returned.   The driver  should store  this pointer  for later
36 can  be called.  It  allocates num  consecutive  pagesize chunks.   It
52 the ax, bx, cx, dx, si, di  and es x86-CPU registers can be set in the
73 a CPU  emulator the emulator and  CPU specific interfaces  can be held
78 environment and the emulation layer  have to be ported. Several helper
81 A CPU emulator should meet certain requirements to be usable
93 3.  The emulator  should be able to use  externally provided functions
97  this mode is to be used, the OS environment has to be able to provide
98  that, ie. it must be able to remap the processes virtual memory space
100  externally  provided functions the  real mode  process memory  can be
102  have to be consecutive.
111 generic.c.  It  should be  usable  with  any  emulator satisfying  the
113 setup may be skipped when porting int10 to new emulator.
115 If the  vm86() is to be used  no memory access functions  can be used.
118 code may  have to  be designed, too.  The following section  will give
119 guidelines how  this may be  done. A sample implementation  using SysV
121 virtual  address  space  just  prior  to execution  may  be  found  in
126 method 1 can be turned on by defining _PC.
144 should be allocated.  This structure contains the following fields:
146     a. int entityIndex   - index of the entity whose BIOS is to be
156     g. int num           - number of the int to be called.
164 should be called. If this function returns FALSE any already allocated
165 memory should be freed and xf86Int10Init(0 should exit returning NULL.
167 If the  platform has  a PC  like system BIOS  it may  be copied  to or
173 may be  called to set  up a rudimentary  system BIOS sufficient  to be
176 int vector and BIOS data area is available it should be copied to 0 to
178 video interrupt  related entries should  be reset for  all non-primary
183 correct video BIOS  entry points the BIOS must  be warm-booted.  If no
184 PC-like int vector is available one can be set up by calling
188 In this  case the  video BIOS  has to be  warm-booted always.   If the
189 video BIOS  for this entity has  been installed during boot  it may be
195 should  be called  to copy  the BIOS  image from  PCI  ROM.  'address'
196 specifies the address this image should be copied to. Sufficient space
197 to  hold an entire  BIOS image  should be  allocated prior  to calling
204 may be called.  It sets up a 'hlt' instruction  in the emulator memory
206 this address will be pushed onto  the return stack.  If the BIOS needs
207 to be  warm-booted this should be done  before leaving xf86InitInt10()
212 The  implementation of this  function will  be discussed  below.  This
213 function  should be  wrapped  by calls  to void  LockLegacyVGA(screen,
221 In case  a platform specific  mapping has to  be performed to  map the
227 has to  be provided. It will  be called by a  helper function whenever
230 virtual memory  will have to be  remapped to address 0  of the virtual
240 should  be  provided.  If  the  entity  to  be  freed  was  mapped  by
241 MapCurrentInt10() this mapping needs to be undone also.
250 this memory.  The offset in real  mode memory needs to  be returned in
264 This function will  be called from xf86InitInt10(). It  may be used to
290 should be called.
299 compiler.h. Optionally the PIO  instructions can be logged by defining
306 might have  to be modified  or even rewritten  for other OS.   So your
315 is provided. The use should be self explanatory.
322 ways  to access  memory and  xf86 CPU  registers: Defines  need  to be
328 vm86-mode under  Linux and x86emu.  They may be activated  by defining
332 memory  access functions.  In this  case a  global variable  should be
333 defined  which can  hold this  pointer. This  variable can  be  set in
334 MapCurrentInt10().  It also  must be  set in  xf86InitInt10()  if this