| 1 | /* $Id: ModuleBase.h,v 1.2 2000-01-22 18:20:58 bird Exp $
|
|---|
| 2 | *
|
|---|
| 3 | * ModuleBase - Declaration of the Basic module class.
|
|---|
| 4 | *
|
|---|
| 5 | * Copyright (c) 1999 knut st. osmundsen
|
|---|
| 6 | *
|
|---|
| 7 | * Project Odin Software License can be found in LICENSE.TXT
|
|---|
| 8 | *
|
|---|
| 9 | */
|
|---|
| 10 | #ifndef _MODULEBASE_H_
|
|---|
| 11 | #define _MODULEBASE_H_
|
|---|
| 12 |
|
|---|
| 13 |
|
|---|
| 14 | /*******************************************************************************
|
|---|
| 15 | * Defined Constants And Macros *
|
|---|
| 16 | *******************************************************************************/
|
|---|
| 17 | /*
|
|---|
| 18 | * Error definitions (used in addition to them in bseerr.h)
|
|---|
| 19 | */
|
|---|
| 20 | #define ERROR_FAILED_TO_ADD_OBJECT 0x42000000UL
|
|---|
| 21 | #define ERROR_INITMETHOD_NOT_INITTIME 0x42000001UL
|
|---|
| 22 | #define ERROR_INTERNAL_PROCESSING_ERROR 0x42000002UL
|
|---|
| 23 |
|
|---|
| 24 |
|
|---|
| 25 | /*
|
|---|
| 26 | * Some useful macros.
|
|---|
| 27 | */
|
|---|
| 28 | #define NOREF(a) (a=a) /* Not referenced parameter warning fix. */
|
|---|
| 29 | #define ALIGN(a, alignment) (((a) + (alignment - 1UL)) & ~(alignment - 1UL))
|
|---|
| 30 | /* aligns something, a, up to nearest alignment boundrary-
|
|---|
| 31 | * Note: Aligment must be a 2**n number. */
|
|---|
| 32 |
|
|---|
| 33 | /*
|
|---|
| 34 | * Output macros.
|
|---|
| 35 | * Macros: option infolevel
|
|---|
| 36 | * printIPE -W1 Error
|
|---|
| 37 | * printErr -W1 Error
|
|---|
| 38 | * printWar -W2 Warning
|
|---|
| 39 | * printInf -W3 Info
|
|---|
| 40 | * printInfA -W4 InfoAll
|
|---|
| 41 | */
|
|---|
| 42 | #define printIPE(a) (ModuleBase::ulInfoLevel >= ModuleBase::Error ? \
|
|---|
| 43 | ModuleBase::printf("\nerror(%d:"__FUNCTION__"): !Internal Processing Error!\n\t", __LINE__), \
|
|---|
| 44 | ModuleBase::printf a, \
|
|---|
| 45 | ModuleBase::printf("\n") \
|
|---|
| 46 | : (void)0,(void)0,(void)0 )
|
|---|
| 47 | #define printErr(a) (ModuleBase::ulInfoLevel >= ModuleBase::Error ? \
|
|---|
| 48 | ModuleBase::printf("error(%d:"__FUNCTION__"): ", __LINE__), \
|
|---|
| 49 | ModuleBase::printf a \
|
|---|
| 50 | : (void)0,(void)0 )
|
|---|
| 51 | #define printWar(a) (ModuleBase::ulInfoLevel >= ModuleBase::Warning ? \
|
|---|
| 52 | ModuleBase::printf("warning("__FUNCTION__"): "), \
|
|---|
| 53 | ModuleBase::printf a \
|
|---|
| 54 | : (void)0,(void)0 )
|
|---|
| 55 | #define printInf(a) (ModuleBase::ulInfoLevel >= ModuleBase::Info ? \
|
|---|
| 56 | ModuleBase::printf a : (void)0 )
|
|---|
| 57 | #define printInfA(a)(ModuleBase::ulInfoLevel >= ModuleBase::InfoAll ? \
|
|---|
| 58 | ModuleBase::printf a : (void)0 )
|
|---|
| 59 |
|
|---|
| 60 |
|
|---|
| 61 | /*
|
|---|
| 62 | * Misc
|
|---|
| 63 | */
|
|---|
| 64 | #define PAGESIZE 0x1000
|
|---|
| 65 |
|
|---|
| 66 |
|
|---|
| 67 |
|
|---|
| 68 |
|
|---|
| 69 | /**
|
|---|
| 70 | * Base class for executable modules.
|
|---|
| 71 | * @author knut st. osmundsen
|
|---|
| 72 | * @approval not approved yet...
|
|---|
| 73 | */
|
|---|
| 74 | class ModuleBase
|
|---|
| 75 | {
|
|---|
| 76 | public:
|
|---|
| 77 | /** @cat Constructor/Destructor */
|
|---|
| 78 | ModuleBase(SFN hFile);
|
|---|
| 79 | virtual ~ModuleBase();
|
|---|
| 80 |
|
|---|
| 81 | /** @cat Public Main methods */
|
|---|
| 82 | virtual ULONG init(PCSZ pszFilename);
|
|---|
| 83 | virtual ULONG read(ULONG offLXFile, PVOID pvBuffer, ULONG cbToRead, ULONG flFlags, PMTE pMTE) = 0;
|
|---|
| 84 | virtual ULONG applyFixups(PMTE pMTE, ULONG iObject, ULONG iPageTable, PVOID pvPage,
|
|---|
| 85 | ULONG ulPageAddress, PVOID pvPTDA); /*(ldrEnum32bitRelRecs)*/
|
|---|
| 86 | #ifndef RING0
|
|---|
| 87 | virtual ULONG writeFile(PCSZ pszLXFilename);
|
|---|
| 88 | #endif
|
|---|
| 89 |
|
|---|
| 90 | /** @cat public Helper methods */
|
|---|
| 91 | virtual VOID dumpVirtualLxFile() = 0;
|
|---|
| 92 | BOOL queryIsModuleName(PCSZ pszFilename);
|
|---|
| 93 |
|
|---|
| 94 | /** @cat static print method */
|
|---|
| 95 | static VOID printf(PCSZ pszFormat, ...);
|
|---|
| 96 |
|
|---|
| 97 | protected:
|
|---|
| 98 | /** @cat private data members. */
|
|---|
| 99 | #ifdef DEBUG
|
|---|
| 100 | BOOL fInitTime; /* init time indicator (debug) */
|
|---|
| 101 | #endif
|
|---|
| 102 | SFN hFile; /* filehandle */
|
|---|
| 103 | PSZ pszFilename; /* fullpath */
|
|---|
| 104 | PSZ pszModuleName; /* filename without extention. */
|
|---|
| 105 |
|
|---|
| 106 | /** @cat public static data. */
|
|---|
| 107 | public:
|
|---|
| 108 | static ULONG ulInfoLevel; /* Current output message detail level. */
|
|---|
| 109 | enum {Quiet, Error, Warning, Info, InfoAll}; /* Output message detail levels. */
|
|---|
| 110 | };
|
|---|
| 111 |
|
|---|
| 112 |
|
|---|
| 113 | #endif
|
|---|
| 114 |
|
|---|
| 115 |
|
|---|