x11include/xorg-server-1.0.1/x86emu.h

b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/****************************************************************************
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*                       Realmode X86 Emulator Library
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*               Copyright (C) 1996-1999 SciTech Software, Inc.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*                    Copyright (C) David Mosberger-Tang
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*                      Copyright (C) 1999 Egbert Eich
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  ========================================================================
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  Permission to use, copy, modify, distribute, and sell this software and
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  its documentation for any purpose is hereby granted without fee,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  provided that the above copyright notice appear in all copies and that
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  both that copyright notice and this permission notice appear in
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  supporting documentation, and that the name of the authors not be used
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  in advertising or publicity pertaining to distribution of the software
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  without specific, written prior permission.  The authors makes no
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  representations about the suitability of this software for any purpose.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  It is provided "as is" without express or implied warranty.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  THE AUTHORS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  EVENT SHALL THE AUTHORS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  PERFORMANCE OF THIS SOFTWARE.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*  ========================================================================
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync* Language:     ANSI C
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync* Environment:  Any
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync* Developer:    Kendall Bennett
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync* Description:  Header file for public specific functions.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*               Any application linking against us should only
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*               include this header
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync*
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync****************************************************************************/
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#ifndef __X86EMU_X86EMU_H
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define __X86EMU_X86EMU_H
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#ifdef SCITECH
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#include "scitech.h"
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define X86API  _ASMAPI
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define X86APIP _ASMAPIP
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsynctypedef int X86EMU_pioAddr;
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#else
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#include "x86emu/types.h"
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define X86API
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define X86APIP *
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#endif
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#include "x86emu/regs.h"
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/*---------------------- Macros and type definitions ----------------------*/
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#ifdef PACK
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync# pragma    PACK   /* Don't pack structs with function pointers! */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#endif
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/****************************************************************************
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncREMARKS:
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncData structure containing ponters to programmed I/O functions used by the
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncemulator. This is used so that the user program can hook all programmed
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncI/O for the emulator to handled as necessary by the user program. By
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncdefault the emulator contains simple functions that do not do access the
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsynchardware in any way. To allow the emualtor access the hardware, you will
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncneed to override the programmed I/O functions using the X86EMU_setupPioFuncs
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncfunction.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncHEADER:
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncx86emu.h
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncMEMBERS:
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncinb     - Function to read a byte from an I/O port
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncinw     - Function to read a word from an I/O port
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncinl     - Function to read a dword from an I/O port
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncoutb    - Function to write a byte to an I/O port
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncoutw    - Function to write a word to an I/O port
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncoutl    - Function to write a dword to an I/O port
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync****************************************************************************/
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsynctypedef struct {
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    u8      (X86APIP inb)(X86EMU_pioAddr addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    u16     (X86APIP inw)(X86EMU_pioAddr addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    u32     (X86APIP inl)(X86EMU_pioAddr addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    void    (X86APIP outb)(X86EMU_pioAddr addr, u8 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    void    (X86APIP outw)(X86EMU_pioAddr addr, u16 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    void    (X86APIP outl)(X86EMU_pioAddr addr, u32 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    } X86EMU_pioFuncs;
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/****************************************************************************
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncREMARKS:
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncData structure containing ponters to memory access functions used by the
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncemulator. This is used so that the user program can hook all memory
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncaccess functions as necessary for the emulator. By default the emulator
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsynccontains simple functions that only access the internal memory of the
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncemulator. If you need specialised functions to handle access to different
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsynctypes of memory (ie: hardware framebuffer accesses and BIOS memory access
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncetc), you will need to override this using the X86EMU_setupMemFuncs
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncfunction.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncHEADER:
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncx86emu.h
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncMEMBERS:
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncrdb     - Function to read a byte from an address
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncrdw     - Function to read a word from an address
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncrdl     - Function to read a dword from an address
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncwrb     - Function to write a byte to an address
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncwrw     - Function to write a word to an address
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncwrl     - Function to write a dword to an address
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync****************************************************************************/
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsynctypedef struct {
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    u8      (X86APIP rdb)(u32 addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    u16     (X86APIP rdw)(u32 addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    u32     (X86APIP rdl)(u32 addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    void    (X86APIP wrb)(u32 addr, u8 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    void    (X86APIP wrw)(u32 addr, u16 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    void    (X86APIP wrl)(u32 addr, u32 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    } X86EMU_memFuncs;
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/****************************************************************************
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync  Here are the default memory read and write
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync  function in case they are needed as fallbacks.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync***************************************************************************/
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern u8 X86API rdb(u32 addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern u16 X86API rdw(u32 addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern u32 X86API rdl(u32 addr);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern void X86API wrb(u32 addr, u8 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern void X86API wrw(u32 addr, u16 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern void X86API wrl(u32 addr, u32 val);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#ifdef END_PACK
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync# pragma    END_PACK
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#endif
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/*--------------------- type definitions -----------------------------------*/
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsynctypedef void (X86APIP X86EMU_intrFuncs)(int num);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern X86EMU_intrFuncs _X86EMU_intrTab[256];
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/*-------------------------- Function Prototypes --------------------------*/
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#ifdef  __cplusplus
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncextern "C" {                        /* Use "C" linkage when in C++ mode */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#endif
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_setupMemFuncs(X86EMU_memFuncs *funcs);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_setupPioFuncs(X86EMU_pioFuncs *funcs);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_setupIntrFuncs(X86EMU_intrFuncs funcs[]);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_prepareForInt(int num);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/* decode.c */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_exec(void);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_halt_sys(void);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#ifdef  DEBUG
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define HALT_SYS()  \
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    printk("halt_sys: file %s, line %d\n", __FILE__, __LINE__), \
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync    X86EMU_halt_sys()
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#else
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define HALT_SYS()  X86EMU_halt_sys()
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#endif
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync/* Debug options */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_DECODE_F          0x000001 /* print decoded instruction  */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_TRACE_F           0x000002 /* dump regs before/after execution */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_STEP_F            0x000004
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_DISASSEMBLE_F     0x000008
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_BREAK_F           0x000010
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_SVC_F             0x000020
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_SAVE_IP_CS_F      0x000040
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_FS_F              0x000080
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_PROC_F            0x000100
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_SYSINT_F          0x000200 /* bios system interrupts. */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_TRACECALL_F       0x000400
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_INSTRUMENT_F      0x000800
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_MEM_TRACE_F       0x001000
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_IO_TRACE_F        0x002000
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_TRACECALL_REGS_F  0x004000
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_DECODE_NOPRINT_F  0x008000
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_EXIT              0x010000
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#define DEBUG_SYS_F             (DEBUG_SVC_F|DEBUG_FS_F|DEBUG_PROC_F)
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_trace_regs(void);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_trace_xregs(void);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncvoid    X86EMU_dump_memory(u16 seg, u16 off, u32 amt);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncint     X86EMU_trace_on(void);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsyncint     X86EMU_trace_off(void);
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#ifdef  __cplusplus
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync}                                   /* End of "C" linkage for C++       */
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#endif
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync#endif /* __X86EMU_X86EMU_H */