Skip to content

An example MASM32 program able to load APIs by 16-bit linear hash

Notifications You must be signed in to change notification settings

hidefromkgb/imports

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 

Repository files navigation

imports

An example MASM32 program able to load APIs by 16-bit linear hash. Does not import anything via import sections. Acquires KERNEL32.DLL base address via PEB_LDR_DATA structure. Implements API address retrieval by manual calculation based on data from libraries` IMAGE_EXPORT_DIRECTORY structure (namely, AddressOfNameOrdinals and AddressOfFunctions members).

The algorithm fills the table named prc with addresses of APIs. Addresses are gotten by reading through the export table (located in AddressOfNames) of a corresponding DLL. Each name (AddressOfNames[N]) is hashed and compared to hashes from the program`s hash table. If there is a match, the algorithm reads the actual position P from AddressOfNameOrdinals[N], and retrieves the address of the needed API by reading AddressOfFunctions[P].

TBL_SIZE constant defines the resulting address table length in DWORDs. May be greater (but not less!) than the hash table length.
API_MULT is a linear hash multiplier. Has to be prime and 16-bit unsigned.
API_PLUS is a linear hash constant term. Has to be 16-bit signed.

Hash table consists of several segments going one right after another.
Segment structure (not including first segment which is discussed later) is as follows:

|D|K|w1| … __|__wK|

  • D = null-terminated name of the DLL from which to load next K functions
  • K = number of functions to load from the corresponding DLL, 1 byte
  • w1-wK = hashes of target names (2 bytes each, sorted in ascending order)

D beginning from zero character is treated as ending mark. Technically, the name of any file unable to be loaded as DLL (or simply nonexistent) will behave similarly, but zero char is more convenient as I consider.

Each L-th address in resulting prc table corresponds to the function whose name is encoded with L-th hash in hash table.

The very first segment is presumed to contain hashes of functions to be loaded from KERNEL32, so this segment cannot have a D member, so it begins immediately with K.
This segment MUST contain the hash for LoadLibrary(), and the resulting table must reserve a position for it, since it is necessary for further DLL loading. Even if no library except KERNEL32 is used, it still has to be present. Alternatively, the call itself may wiped out from the algo; you decide.
FIX: Windows 7 and upper do not load KERNEL32 immediately after program start, thus making LoadLibraryA() unaccessible. Fortunately, LoadLibraryExA() is still available, so the algo now uses it instead.
FIX: WINE does load KERNEL32 into our address space, but places it at the end of the libraries list, so we now try to find LoadLibraryExA() in every library present in the list, not only the first. If none of the loaded libraries contains this API (which is generally nonsense, but nonetheless), the program will eventually segfault at a zero address.


P.S.:
Each possible initializing vector for a 16-bit linear hash, (API_MULT; API_PLUS), results in the hash having a number of collisions.
The (0xFBC5; 0xFFFF) pair I used in this example has these:

GDI32:
[ AEEC ] GetKerningPairsW / SetBoundsRect

KERNEL32:
[ 4ADC ] GetFileBandwidthReservation / WaitForMultipleObjects
[ 5AF0 ] AllocateUserPhysicalPages / InitializeSListHead
[ 5C6E ] GetSystemFileCacheSize / UnregisterWaitEx
[ 756F ] LocalShrink / RegisterWaitForSingleObject
[ 8E42 ] CreateThreadpoolTimer / GetPrivateProfileStringW
[ E1D2 ] SetLocalPrimaryComputerNameW / _lclose
[ F38C ] Heap32Next / WakeConditionVariable

OPENGL32:
[ 4BC0 ] glTexCoord1d / glTexCoord1sv

So, check your function set carefully!


P.P.S.:
The actual function set provided in this example does not bear a particular purpose, and is intended only for demonstration.

After I finally manage to get rid of the nasty access violation bug, I plan to post a program that facilitates hash table creation, based on the function set you provide.

About

An example MASM32 program able to load APIs by 16-bit linear hash

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published