Click here to Skip to main content
13,050,429 members (132,613 online)
Click here to Skip to main content
Add your own
alternative version


207 bookmarked
Posted 21 Apr 2004

Kernel-mode API spying - an ultimate hack

, 21 Apr 2004
Rate this:
Please Sign up or sign in to vote.
An article on kernel-mode API spying.


After having published my article about process-wide API spying, I received plenty of encouraging messages - readers have generally accepted my model of hooking function calls. In this article, we will extend our model to kernel- mode spying, and hook the API calls that are made by our target device driver. We will also introduce a brand-new way of communication between the kernel-mode driver and the user-mode application - instead of using system services, we will implement our own mini-version of Asynchronous Procedure Calls. This task is not as complicated as it may seem - in fact, it is just shockingly easy. Windows flat memory model offers us plenty of exciting opportunities - the only thing we need is a sense of adventure (plus a good knowledge of assembly language, of course). All tips and tricks, described in this article, are 100% of my own design - you would not find anything more or less similar to these tricks anywhere.

I took into account the messages, saying that I should have provided the readers with the source code. Therefore, the source code for this article is available for download (please read the installation instructions in the end of the article).

Important: This article is based upon the bold assumption that you have read my previous article about process-wide API spying. If you haven't read it yet, go and do it now. This is an absolute must - otherwise, you will be unable to understand absolutely anything here, and the whole article will seem totally incoherent to you.


First of all, let's look at complications, arising from the fact that our spying activity is going to take place in the kernel mode. To begin with, Windows is a protected system, which means user-mode applications have no access to the kernel address space. Therefore, a spying DLL, described in the previous article, cannot work in kernel mode - in order to start spying in kernel mode, we have to write not a DLL but a kernel-mode spying driver.

Our spying driver has to communicate with the user-mode controller application, and do it asynchronously. Any virtual address in the lower 2G of the process address space is meaningless for the kernel code - even in the same process. This means kernel-mode code cannot call user-mode functions, so that our driver cannot send a window message to its controller application the way user-mode spying DLL does, because SendMessage() API function resides in user-mode address space. In fact, even if our driver could call SendMessage(), doing so would be an extremely unwise move on its behalf - SendMessage() does not return until the message gets processed, and kernel-mode code cannot afford to wait patiently for the user-mode one to accomplish its task, unless we are desperate to bring the system down. Therefore, we must find some way of asynchronous communication between the spying driver and its controller application.

Furthermore, if we spy on user-mode modules, we can save the original return address, as well as other relevant information, in the thread local storage. However, our kernel-mode driver cannot call user-mode TlsGetValue() or TlsSetValue(). TLS-related system functions that can be called by kernel-mode code don't seem to exist. If you disassemble TlsAlloc(), TlsGetValue() or TlsSetValue(), you will see that neither of these functions invokes INT 2Eh, i.e. managing TLS does not involve system services. Once every user-mode thread in the system receives its own copy of CPU stack and registers, the FS register is mapped to the beginning of the section where thread-specific data is stored. This is how kernel32.dll implements thread local storage - everything is implemented purely by user-mode code, which cannot be called by our spying driver. Therefore, we have to find some other thread-safe way of saving the original return address, as well as all other relevant information.

In addition to the above, we should not forget that our spying code may run at any IRQL. Some system services may be called at any IRQL, and some are IRQL-dependent. Therefore, we have to take the current IRQL into account when we call certain system services. Furthermore, we must make sure that, if our spying code currently runs at high IRQL, it does not go anywhere close to the paged pool. If our spying code tries to access the paged memory while running at high IRQL, or calls any function that tries to do it, the “blue screen of death”, due to the page fault, is inevitable.

We should also keep in mind that kernel-mode code is interruptible. If an interrupt occurs while our spying code runs, the system will transfer control to the interrupt handler, which may call some API function that we have hooked. In other words, the system may interrupt the execution of our spying code only in order to execute exactly the same spying code. As a result, when our interrupted code continues its execution, it may find global variables and resources in the state, very different from the one they used to be in before the interrupt had occurred. We should always remember this, and disable interrupts whenever we expect global variables and resources to be immutable while our code runs - otherwise, we can get an unpleasant surprise (i.e., the "blue screen", which is the system's standard reaction to any mistake we make in kernel-mode code).

As you can see, in order to work in kernel mode, Prolog() and Epilog() need quite a few adjustments. Although ProxyProlog() and ProxyEpilog() may stay as they are - the only thing they do is saving and restoring CPU registers and flags, which is done the same way in both kernel and user modes. We will start with "theoretical foundations" - first, we will look at how our custom asynchronous message queue and TLS can be implemented, and proceed to the actual task of spying afterwards.

Asynchronous Message Queuing

Look at the code below (I hope that, after having read my previous article, you are able to recognize handcrafted indirect jump instruction):

BYTE chunk1[32];
chunk1[0]=0xFF;chunk1[1]=0x25;int i=(int)&chunk1[6];
CreateThread(0,0,(LPTHREAD_START_ROUTINE)&chunk1[0],0,0 ,&dw);

What does the newly created thread do? Absolutely nothing - in the beginning of chunk1 array, it finds the instruction to jump to the location, address of which is stored 6 bytes above the beginning of chunk1 array. However, the only thing stored there is the address of chunk1 array itself. Therefore, the code is instructed to jump to its current position, where it finds the instruction to jump to its current position, etc., etc., etc... As a result, the thread gets into the processor-level version of infinite loop, and is unable to move anywhere - it spins at its start address.

What is going to happen if, at some point, the program executes the following lines (addr is the variable, containing a pointer to the function which, for the sake of simplicity, takes no arguments):

//fill the array with the machine codes

// what is going to happen???

When the last line of the above code gets executed, the thread will break out of its infinite loop, and jump to the handcrafted code in chunk2 array. Why? Because the thread is instructed to jump to the location, address of which is stored 6 bytes above the beginning of chunk1 array. We wrote the address of chunk1 array there, and, as a result, made the thread spin. If we write some other address 6 bytes above the beginning of chunk1 array, the code flow will jump to the new location.

The code in chunk2 array (starting from byte 10, i.e. the location to which our thread will jump) instructs the thread to push the address of chunk2 array on the stack, and to jump to the target function. Therefore, after the target function returns, the code flow will jump to the beginning of chunk2 array, where it will find the instruction to jump to the location, address of which is stored 6 bytes above the beginning of chunk2 array. Once the only thing stored there is the address of chunk2 array, the thread starts spinning again.

We can repeat this sequence again and again and again with chunk3, chunk4, chunk5, etc. - the thread will break out of its infinite loop, execute the target function, enter an infinite loop, break out when the next chunk of instructions arrives, execute the target function, enter an infinite loop again, and so on and so forth. Therefore, we can schedule the target function for subsequent execution simply by writing data to the array, rather than by means of system-defined APC. We can do it whenever we wish - our thread never terminates. The only thing we need to know is the location where the thread currently spins, or, in case if it currently executes the target function, the location where it will spin after the target function returns - we have to write the address we want it to jump to 6 bytes above this location. In practical terms, it makes sense to allocate all these chunks from the same pool, and to use an offset index as a pointer into this pool. When the pool gets fully packed, we can reuse it- all we have to do is to set an index to zero, and start it over again.

Let's say the thread runs in the user-mode process X. It is understandable that the function we want it to execute must reside in the address space of user-mode process X as well, but what about the code that actually fills the array with the machine instructions and makes the thread break out of its infinite loop? Where should it reside? It can reside anywhere - in the same module, in a different module of the same process, in another user-mode process, or even in kernel- mode driver. Furthermore, this code can be concurrently executed by different threads in different processes. As long as this code has a write access to the address space of the process X, it can post an asynchronous message that schedules the target function for execution. In order to do so, it does not need any system services - what it needs are the addresses of the target function and of the pool (as they are known to the process X), the ability to write data to this pool, plus the current value of offset index. This approach is absolutely generic, and can be used whenever we need to post an asynchronous message to an application, but, for some reason, are unable to use system-defined APC and asynchronous message queuing.

Now, let's look at how we can save thread-specific data without using system-defined TLS.

Storing Thread-Specific Data

Prolog and epilog of any function that uses EBP register as a base pointer to its local variables look like the following:

push ebp; save ebp
mov ebp,esp
sub esp, XXX; allocate local variables 
do actual things...
mov esp,ebp
pop ebp; restore ebp

It is easy to see that, as a very first step, the function must save the value of EBP register on the stack, and restore it before returning the control. This is an absolute must - otherwise, the caller will be unable to keep track of its local variables after the function returns. It is also easy to see that the function saves the value of EBP on the stack just one stack entry above the function's return address, and then copies the current value of ESP into EBP register. Therefore, the current value of EBP register always points to the location that stores the previous value of EBP.

What does it have to do with spying? Look at how our spying code flow affects the original value of EBP, i.e. the value of EBP at the time when ProxyProlog() starts execution (I hope you remember our "spying team" from the previous article):

  • ProxyProlog() - does not change EBP value before calling Prolog()
  • Prolog() - Once Prolog() is not a naked routine, the compiler will definitely generate instructions to save the value of EBP above Prolog()'s return address, and to pop this value into EBP register before Prolog() returns.
  • ProxyProlog() - does not change EBP value after Prolog() returns.

    Actual callee - either saves the original value of EBP and restores it before returning control, or leaves EBP register intact. In any case, the original value of EBP is of no importance for the actual callee - it is only the client code that actually uses it.

  • ProxyEpilog() - does not change EBP value before calling Epilog()
  • Epilog() - Once Epilog() is not a naked routine, the compiler will definitely generate instructions to save the value of EBP above Epilog()'s return address....

    Did you get it? The value, stored above Prolog()'s return address, is always going to be equal to the one, stored above Epilog()'s return address!!! Furthermore, this value in itself is of no importance until the program flow returns to the client code. This is what we can take advantage on.

  • Prolog() can save the original value of EBP, along with the original return address and all other relevant information, in the Storage structure, and write the pointer to this structure just above its return address. Once the same pointer to the Storage structure is going to be stored above Epilog()'s return address, and the original value of EBP is available from this structure, Epilog() can write this value above its return address, so that it will get popped into EBP register before Epilog() returns. As a result, at the time when the program flow jumps to the client code, the value of EBP is going to be exactly the same it used to be at the time when ProxyProlog() started execution.

    Therefore, we can save the pointer to the Storage structure in the location, pointed to by EBP register, rather than in the thread local storage - our spying code is going to stay thread-safe anyway. Such approach is suitable for both kernel-mode and user-mode spying. It is needless to say that, in case of kernel-mode spying, the Storage structure must be allocated from non-paged pool - our spying code may run at high IRQL.

Armed with this theoretical knowledge, we can implement it in practice, and proceed to the actual task of kernel-mode spying. I am sorry - I forgot to tell you that overwriting the addresses of functions, imported by kernel-mode driver, is a bit different from modifying user-mode module's IAT.

Kernel-Mode Spying

First of all, let's look at how IAT is filled with the addresses of imported functions at load time. As a first step, the loader has to locate the module's import directory, i.e. the array of IMAGE_IMPORT_DESCRIPTOR structures, from which it can obtain the pointers to Import Name and Import Address tables. After having obtained the name of the imported function from the Import Name Table, the loader can get its address from the IMAGE_EXPORT_DIRECTORY of the module that exports the given function, and write this address to the Import Address Table, so that the program can call the imported function. It is understandable that the Import Address Table is needed as long as the program runs, but what about the Import Name Table and the array of IMAGE_IMPORT_DESCRIPTOR structures? Are they needed after the loader fills the Import Address Table with the addresses of imported functions? Not really - they are needed only at the load time. What is the point of keeping them in memory after the module gets loaded?

As long as they reside in pageable memory, this is not really a big deal - they will be normally swapped to the disk, and get loaded into RAM only if we want to access them, i.e. they are not going to take up space in RAM anyway. Once user-mode modules can be paged to the disk, the loader just cannot be bothered to discard the Import Name Table and the array of IMAGE_IMPORT_DESCRIPTOR structures from memory after the user module gets loaded - it is not worth an effort. Therefore, the pointer to the array of IMAGE_IMPORT_DESCRIPTOR structures, available from the target user module's IMAGE_OPTIONAL_HEADER, is always valid.

However, the kernel-mode driver, apart from its code that has been explicitly marked as pageable, has to be constantly loaded in RAM, which, compared to virtual memory, is scarce. Under such circumstances, keeping the Import Name Table and the array of IMAGE_IMPORT_DESCRIPTOR structures in memory is just an unreasonable waste of resources. In order to solve this problem, the linker may place the Import Name Table and the array of IMAGE_IMPORT_DESCRIPTOR structures to the driver's INIT section, along with DriverEntry() and DriverReinitialize() routines, i.e. the code that is needed only during driver's initialization. After the driver is loaded, the loader simply discards its .INIT section from memory, because it does not contain any information that may be needed after driver's initialization. As a result, after the driver is loaded, the pointer to the array of IMAGE_IMPORT_DESCRIPTOR structures, available from the target driver's IMAGE_OPTIONAL_HEADER, may point right to the middle of nowhere, and, hence, should not be accessed - in order to figure it out, I had to spend two evenings in "blue screen - reboot loop".

However, the array of IMAGE_IMPORT_DESCRIPTOR structures contains information, crucial for locating the Import Address Table. What are we going to do? We will map the target driver's file into the memory, and obtain all necessary information from the file mapping. This can be done by the user-mode controller application. Look at the code below:

    ULONG Reserved[2];
    PVOID Base;
    ULONG Size;
    ULONG Flags;
    USHORT Index;
    USHORT Unknown;
    USHORT LoadCount;
    USHORT ModuleNameOffset;
    CHAR ImageName[256];

int spy(char*path)
    DWORD a,dw,x,num; 
    SYSTEM_MODULE_INFORMATION info;char buff[256]; 
    DWORD* base=0;char* fullname; char* drivername1;char* drivername2;

    //get the name of the target driver

        if(path[a]=='/'||path[a]=='\\' )

    //get the list of all loaded drivers
    typedef DWORD (__stdcall*func)(DWORD,LPVOID,DWORD,DWORD*);

    func ZwQuerySystemInformation=

    BYTE *array=new BYTE[dw];

    // check if the target driver is loaded


            "This driver is not loaded",
            "spy",MB_OK);return 0;
    // map the target driver's file into memory
    // and get the pointer to import directory
    HANDLE filehandle=CreateFile(path,GENERIC_READ|GENERIC_WRITE,
    HANDLE maphandle=CreateFileMapping(filehandle,0,
    IMAGE_DOS_HEADER * dosheader=(IMAGE_DOS_HEADER *)readbuff;


    int totalcount=0;DWORD*ptr=(DWORD*)&buff[16];

    // now we are filling the control array with offsets to IATs
    // and numbers of entries in each IAT

        DWORD firstthunk=descriptor->FirstThunk;


    // create the thread and the pool
    writebuff=(BYTE* )VirtualAllocEx(GetCurrentProcess(),
    writebuff=(BYTE* )VirtualAllocEx(GetCurrentProcess(),

    writebuff[0]=0xFF;writebuff[1]=0x25;int i=(int)&writebuff[6];
    HANDLE threadhandle=CreateThread(0,0,
        (LPTHREAD_START_ROUTINE)&writebuff[0],0,0 ,&dw);


    // keep on filling the control array with relevant info

    // open the spying driver
            "Spying driver is not loadeded","spy",MB_OK);return 0;

    //create the logfile
    char namebuff[256]; 
    strcpy(&namebuff[a], "spylogfile.txt");


    // send the control array to the spying driver

    return 1;

As a first step, we find the address at which our target driver is loaded in memory. We do it by calling ZwQuerySystemInformation() native API function, which can return information about all currently loaded drivers. ZwQuerySystemInformation() returns this information as an array of SYSTEM_MODULE_INFORMATION structures. Base field of SYSTEM_MODULE_INFORMATION structure indicates the address at which the given driver is loaded, and ImageName field may contain either the name of the driver, or the whole path to the driver's file. If ImageName field contains the path, we extract the name of the driver from the path, and compare it to the target driver's name, which has also been extracted from the path that was received by spy() as an argument. We do it until we locate the target driver, and save the Base field of its corresponding SYSTEM_MODULE_INFORMATION structure in local variable.

Then we map the target driver's file into the memory, and locate its import directory, i.e. the array of IMAGE_IMPORT_DESCRIPTOR structures. The FirstThunk field of every IMAGE_IMPORT_DESCRIPTOR structure indicates the offset to the beginning of Import Address Table that corresponds to the given imported module, and the OriginalFirstThunk field indicates the offset to the beginning of the array of IMAGE_THUNK_DATA structures. By counting the number of IMAGE_THUNK_DATA structures that have non-zero value of the Function field, we can find the number of entries in IAT that corresponds to the given imported module. For every imported module, we get the offset to the beginning of its corresponding Import Address Table, and count the number of entries in this table. We write these values into the control array, starting from control array's 16th byte. We also save pointers to the names of imported functions in global functionbuff array.

Then we allocate a page of virtual memory, fill first 10 bytes of it with the machine codes, and create the thread which will process our asynchronous messages - it is going to spin in infinite loop until the message arrives. We also write the current value of our offset index (which is currently zero), and address of the logging function to be invoked asynchronously by the spying driver, into structbuff array. This function is too simple to be listed here - it just takes the return value of the API function and the position of its name in functionbuff array as parameters, formats the null-terminated string in the form ApiFunctionXXX - returned YYY, and writes it to the log file. The only thing worth mentioning is that this logging function definitely has to be declared with __stdcall calling convention, so that it pops its arguments off the stack.

Then we fill the first 16 bytes of the control array with the remaining relevant data. This includes the address at which the target driver is loaded, the number of functions imported by the target driver, the address of the pool, and the address of the array that stores the address of the target function and the offset index. Then we create the log file in the folder where the controller application's .exe file resides. Finally, we send the control array to the spying driver by calling DeviceIoControl() with our user-defined IOCTL_START_SPYING command.

Now, let's look at what happens in the kernel mode after our spying driver receives IOCTL_START_SPYING command:

typedef struct tagRelocatedFunction{
LONG address;
LONG function;
} RelocatedFunction,*PRelocatedFunction;

typedef struct tagStorage{
    DWORD isfree;
    DWORD retaddress;
    DWORD prevEBP;
    RelocatedFunction* ptr;

//global variables
char savebuff[64];KEVENT event1,event2;
long totalcount=0,base,userbuff,userstruct;
unsigned char *replacementchunks;DWORD *functionarray;
Storage storagearray[256];
BYTE retbuff[16];BOOLEAN ishooking;
DWORD * userstructptr; BYTE * userbuffptr;

NTSTATUS DrvDispatch(IN PDEVICE_OBJECT  devobject,IN PIRP irp)
    char*buff=NULL;PIO_STACK_LOCATION loc;
    DWORD thunk, count,x,a;long num,addr;DWORD * ptr;
    BYTE*byteptr; BYTE *array=0; RelocatedFunction * reloc;



        //free resources that might be allocated 
        //by our previous call to DrvDispatch

        //map the addresses of user -mode writebuff and structbuff
        //arrays into the kernel address space
        userbuffptr= (BYTE *) 
        userstructptr=(DWORD *)

        //save the remaining relevant data

        //allocate function replacement chunks
        replacementchunks=(unsigned char*)ExAllocatePool(NonPagedPool,

        //allocate the array that holds addresses of actual functions

        // overwrite IAT entries



                reloc=(RelocatedFunction *)&byteptr[6];




    return STATUS_SUCCESS;

As a first step, we map the addresses of user-mode pool, and of the array which holds the current value of offset index and the address of the target function, into the kernel address space. We save these pointers in userstructptr and userbuffptr global variables - we must make them available to Epilog(), which would need them. We also save their virtual addresses, as they are known to the user-mode code, in userstruct and userbuff global variables - Epilog() would need them when it fills the pool with the machine instructions.

Then we save the remaining data received in the control array, in global variables. We would need this data in order to unhook the functions that we are about to hook now, so we must make sure that it is available to DrvClose(), which is going to do this job. Then we allocate the arrays that are going to hold function replacement chunks and the addresses of actual functions - we already know the number of functions we need to hook, and, hence, the number of bytes to allocate. We save these pointers in replacementchunks and functionarray global variables - we must make them available to Prolog() and DrvClose().

At this point, we can proceed to the actual task of overwriting IAT entries. We don't even have to process PE-related structures - the user-mode controller application has provided us with all information we need. I hope that, after having read my previous article, you are able to understand how we do it, so I don't go into details here - the only difference is that RelocatedFunction structure stores not the actual address of imported function, but the position at which this address can be found in functionarray table.

Now, let's look at modifications that have to be applied to Prolog() and Epilog(). ProxyProlog() and ProxyEpilog() don't need any modifications, so we don't discuss them here.

 void __stdcall Prolog(DWORD * relocptr)

    DWORD x;DWORD *ebpptr; int a=0;
    RelocatedFunction * reloc=(RelocatedFunction*)relocptr[0];
    DWORD *retaddessptr=relocptr+1;
    KIRQL irql=KeGetCurrentIrql( );

    //find the first available Storage structure
        KeWaitForSingleObject (&event1,Executive,KernelMode,0,0);

    _asm {
            lea ebx,storagearray
start:                  mov ecx,dword ptr[ebx]
            cmp ecx,100
            jne fin
            add ebx,16
            jmp start
fin:                  mov dword ptr[ebx],100
            mov storptr,ebx


    //store all relevant information in the Storage structure
    _asm mov ebpptr,ebp

    //modify the CPU stack


As a first step, Prolog() locates the first available Storage structure in storagearray table, and sets its isfree field to 100, i.e. marks it as having been occupied. We have to synchronize this operation, so we wait on synchronization event that has been initialized in DriverEntry() (DriverEntry() initializes two synchronization events and fills the retbuff array with the instructions that call ProxyEpilog(), i.e. does pretty much the same things as DllMain() in the previous article). Once we are about to wait until our event is set to the signaled state, i.e. possibly for non-zero interval, we must make sure that we do it if and only if current IRQL is below the DISPATCH_LEVEL. We also have to make sure that this operation does not get interrupted, so we disable interrupts by clearing IF flag. Once we must re-enable them as quickly as possible, the code that locates the first available Storage structure is written in pure assembly.

Then we store all relevant information in the Storage structure. This includes the original return address, the value pointed to by EBP register, and the pointer to RelocatedFunction structure. Finally, we modify the CPU stack the way we did it in the previous article, and write the pointer to the Storage structure to the location, pointed to by EBP register, i.e., one stack entry above Prolog()'s return address.

Now, let's look at Epilog():

void  __stdcall Epilog(DWORD*retvalptr)

    DWORD *ebpptr;
    DWORD*retaddessptr=retvalptr+1;DWORD retval=retvalptr[0];
    Storage*storptr;RelocatedFunction * reloc;
    DWORD i,a,b,pos,n;    KIRQL irql;

    // get the pointer to the Storage structure
    _asm mov ebpptr,ebp


    //modify the CPU stack

    // mark the Storage structure as free

    if (!ishooking)

    // now we are going to send data to
    // the controller application:

mov ebx,userstructptr
mov ecx,dword ptr[ebx]
mov a,ecx
add ecx,32
cmp ecx,4096
jl skip
sub ecx,4096
skip: mov pos,ecx
mov dword ptr[ebx],ecx

mov ebx,userbuffptr
add ebx,ecx
add ebx,6

mov edx,userbuff
add edx,ecx
mov dword ptr[ebx],edx


    // keep on filling the array with machine codes

    // instructions to spin 

    // instructions to push arguments

    //instruction to jump to the target function

    //finally, schedule the target function for execution

Epilog() gets the pointer to the Storage structure from the location pointed to by EBP register, obtains the original return address and the original value of EBP from this structure, and modifies the CPU stack - it stores the original value of EBP one stack entry above its return address, and replaces the address to which ProxyEpilog() would otherwise return control, with the original return address. Then sets the isfree field of the Storage structure to 0, i.e. marks it as free. Finally, it informs the controller application that the given API function has returned, and sends it the return value of this function. The way it is being done requires a little bit more attention.

We schedule the thread, which runs in the controller application's process, for asynchronous execution of the target function, by writing the machine codes to the pool the way it was explained in introduction. First of all, we need to get the current value of offset index in order to find the address of the chunk where we are going to write data, to write the address of this chunk (as it is known to the controller application) 6 bytes above its beginning, and to update the value of offset index. We must synchronize this operation, and make sure that it does not get interrupted. Therefore, we wait until the synchronization event is set to the signaled state (certainly, if and only if current IRQL is below the DISPATCH_LEVEL), and then disable interrupts. Once we must re-enable them as quickly as possible, the code that executes the above tasks is, again, written in pure assembly.

After having accomplished the above, we must fill the remaining part of the chunk with handcrafted instructions to push the index of real callee's address in functionarray table (which is available from RelocatedFunction structure, pointer to which was saved in Storage structure), the real callee's return value, and the address of the current chunk (as it is known to the controller application), on the stack, and then to jump to the logging function. At this point, we already don't have to worry about either interrupts or context switches - the concurrent threads are already unable to overwrite our data anyway. Therefore, before proceeding to the above task, we re-enable interrupts and set the synchronization event to the signaled state, so that other threads don't need to wait until we finish filling the chunk with the machine codes. Once the remaining part of the job is not so time-critical, we can afford to do it in C, rather than assembly.

Finally, we schedule the logging function, which resides in controller's application address space, for execution, by writing the address of the current chunk's 10th byte (as it is known to the controller application) 6 bytes above the address of the previous chunk.

As a result, when the logging function starts execution, it will receive the index of real callee's address in functionarray table and its return value as parameters. Once the functionbuff table in controller application's address space stores names of functions imported by target driver, in the same order as functionarray table in kernel address space stores their addresses, the former parameter is sufficient for locating the name of the real callee. Therefore, the logging function formats the null-terminated string in the form ApiFunctionXXX - returned YYY, and writes it to the log file.

As you can see, kernel-mode spying is a not so terribly complex task, although it makes us worry about things we don't even have to know about when spying in user-mode. The funniest thing is that this model is suitable for user-mode spying as well. Therefore, the source code, provided with this article, applies to my previous article as well.

In order to run the sample application, you have to copy the spying driver into the C://WINNT/system32/drivers directory. And to create an on-demand-start service, it can be done either manually, or with the following lines:


You must manually start the spying service by typing net start spyservice line on the command prompt before running the application. Click on Start button in the Spy menu, choose the driver you want to spy on, relax for a while, and then either click on Stop button, or just close the program. After that, you can open the log file in the text editor, and examine its contents.

Warning: The spying driver has been built by Windows 2000 DDK, and tested on Windows 2000. I really don't know what happens if you run it on any other NT platform - it is your task to find it out. If it does not work, you can always rebuild the spying driver for your platform - the source code would not need any modifications for sure.

Furthermore, I would not advise you to hook Ntfs.sys with this sample. I still have to figure out why it happens, but if you try to hook Ntfs.sys, the system starts slowing down, stops responding pretty shortly, and, finally, goes off after a while. This is not an issue when hooking all other drivers. I tried to hook keyboard and mouse class drivers, i8042prt, atapi, disk, CDROM, floppy, videoport and display - it works fine everywhere. I think that all problems with Ntfs.sys arise because, once our spying code synchronizes all calls that are made by different threads in different systems and user processes, the system cannot cope with the resulting slowdown - in case of Ntfs.sys, some of these calls are made by system threads of high priority, but our spying code currently does not take priority into the account. Probably, we should also take the priority of the calling thread into the account when we synchronize calls and disable interrupts. However, this is only the suggestion - I am not yet in a position to make a definite conclusion (otherwise, instead of speaking about this problem, I would just fix it, wouldn't I?)

I would highly appreciate if you send me an e-mail with your comments and suggestions.


In conclusion, I must say that, although we are able to hook the API calls that are made by both user-mode modules and kernel-mode drivers, our exploration of Windows is far from being over. Would not it be interesting to hook the calls that are made by the system to the target driver? It is obvious that the system has to store the addresses of all functions exported by the driver, in some kind of service table, so that it can call the driver. Therefore, we have to locate this table somehow.

Furthermore, even our process-wide API spying is far from being complete - we can hook only the old-fashioned functional API. Would not it be interesting to spy on COM interfaces as well? In the forthcoming articles, we will try to do the above mentioned things.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Anton Bassov
Web Developer
Luxembourg Luxembourg
No Biography provided

You may also be interested in...

Comments and Discussions

GeneralMy vote of 5 Pin
gndnet25-Jul-12 10:02
membergndnet25-Jul-12 10:02 
GeneralHelp! every's advice. Pin
songjacki8-Mar-09 1:25
membersongjacki8-Mar-09 1:25 
GeneralHookAPI - WriteProcessMemory Pin
Vitoto1-Jan-06 9:16
memberVitoto1-Jan-06 9:16 
Generalprevent files I/O to USB disk driver Pin
hoangchau7-Dec-05 20:28
memberhoangchau7-Dec-05 20:28 
QuestionPE Graphical Area Access? Pin
IslamianFalcon24-Nov-05 20:56
memberIslamianFalcon24-Nov-05 20:56 
AnswerRe: PE Graphical Area Access? Pin
Vertexwahn4-Dec-05 21:42
memberVertexwahn4-Dec-05 21:42 
GeneralRe: PE Graphical Area Access? Pin
IslamianFalcon5-Dec-05 20:30
memberIslamianFalcon5-Dec-05 20:30 
GeneralThis code vs your other code... Pin
Anonymous18-Oct-05 17:47
sussAnonymous18-Oct-05 17:47 
GeneralMap Pin
luolody23-Sep-05 20:49
memberluolody23-Sep-05 20:49 
GeneralRe: Map Pin
Anton Bassov24-Sep-05 7:05
memberAnton Bassov24-Sep-05 7:05 
Generalkernell mode keylogger Pin
Kristof VB6-Aug-05 3:58
memberKristof VB6-Aug-05 3:58 
GeneralRe: kernell mode keylogger Pin
Anton Bassov7-Aug-05 12:46
memberAnton Bassov7-Aug-05 12:46 
GeneralRe: kernell mode keylogger Pin
geek18-Aug-05 3:18
membergeek18-Aug-05 3:18 
GeneralRe: kernell mode keylogger Pin
Anton Bassov18-Aug-05 4:03
memberAnton Bassov18-Aug-05 4:03 
GeneralRe: kernell mode keylogger Pin
Medus21-Nov-05 9:24
memberMedus21-Nov-05 9:24 
GeneralRe: kernell mode keylogger Pin
Anton Bassov21-Nov-05 11:07
memberAnton Bassov21-Nov-05 11:07 
GeneralRe: kernell mode keylogger Pin
Medus22-Nov-05 11:18
memberMedus22-Nov-05 11:18 
>Hi mate
>Could you please provide me with some sample (if you have any). As you say, my work would never prevent your clients from reading all keystrokes on a system-wide basis. Apparently, you must be somehow able to read data BEFORE(!!!) keyboard interrupt gets raised. My software hooks kbd interrupt, reads scan code from the port (this task is normally supposed to be done by i8042prt.sys),removes it from the buffer,translates it into a virtual key, and, via some manipulations, injects it into keyboard input queue (this task is normally supposed to be done by kbdclass.sys).
>In other words, execution never reaches either 8042prt.sys or kbdclass.sys.

You seem to think that by reading 'directly' from the 'port' upon 'interrupt' that you're sitting on the hardware .... right ? Hence your certainty. Of course, thats not the case - You're sitting on an abstraction ... one of the many possibly HAL layers chosen dependent on architecture. You therefore must have faith in the integrity of the abstraction. Much as most sysadmins trust implicitly the integrity of IOS firmware and bootblock on their routers. The problem with this is when you hit a professional low-level tool. And, if you're on the russian scene you may well be aware of the fine work one group in particular has done in this area.

Now, why would someone want to sit in the HAL? Considering the complexity of the task and the fact that you appear to lose the comfort of drivers. Well, its part of a much bigger picture. (sidenote: In actual fact you can actually still leverage the usefulness of vendor drivers, without calling them in situ. Its messy, but we've had some successes with that before we switched to profiling)

Firstly, you'll note the efforts made recently by firewall vendors. Some of whom have become quite aggressive in their monitoring of both the driver (and protocol) stacks. Bad news for conventional rootkits, no? Its become increasingly difficult to create unknown 'sockets' by getting in below the firewall hook. Fortunately, with very few vendor protocol differences one can actually profile the NIC from the actual (not abstracted) port data... and then, once profiled, inject packets. We also get to see and remove packets before they even get to the NDIS ... which renders all commercial firewall software ineffective. And, as usual, hardware walls can be similarly part-profiled by examining remote port/ip of successful TCP handshakes, although currently we don't do this. Essentially, HAL gets us in - even below the NDIS. The result? No software wall currently detects our kits.

But feel free to dismiss this as Voodoo.

Keystrokes are a no-brainer in comparison... and yes, they WILL be picked up before your code gets thrown interrupt.

The problem is, no commercial software protection is going to want to get this dirty. Even if you did, you prolly ain't going to find it marketable - particularly given the relatively low-sophistication of publicly available rootkits and loggers. After all, the market chases the 'percieved threat' and currently thats predominantly gutter-code.

>Therefore, if you want to read the keystroke, you have to do it BEFORE(!!!) keyboard interrupt gets raised. Judging from your tone, you must know a way of doing it.
>In fact, I would not get surprized if, as a "coder of true HAL rootkits" you manage to read the keystroke even before the key gets pressed

You laugh, thats funny. Actually, we CAN get the key before the mobo without something as obvious as a barrel-logger. Or don't you rate hacked keyboards?... I wrote a PIC solution for keyboard-embedded logging with timed RF data-bursting. I drive past and aim my VAGI at the site... My handheld synchronises and tells me when the bugs next databurst is scheduled so I dont hang around looking suspicious... And then I can drop by as my counter hits zero to get all the keystrokes from the system. You can laugh again... And I'll point you to a site with a 4-part article outlining the schematics, firmware and various build options.

Essentially, its the ultimate keylogger because it will survive complete reformatting, visual inspection, and even stands a good chance of defeating a professional RF bugsweep due to its bursty nature (Which can be anything from hourly to weekly)

Whilst thats not a fair attack on your software, as it's not designed to thwart hardware-based logging, it's still a great example of how the 'book' on security is sadly lacking ... most admins are blissfully aware of such a possibility - which is precisely why they are so valuable in corporate espionage... moreso infact, than software loggers and rootkits.

But you're right - I ain't omniscient. How very clever of you notice : )

Sorry no, I ain't throwing out any example code. But if you need a demonstration of a rootkit that will undoubtedly foil your keying safeguards, then I'd be happy to oblige you privately at a Con of your choice (within reason). I'll even show you what you can do about it - but I garauntee your clients won't like the solution - and you can definately forget the possibility microsoft logo certification : )

What we do is NOT mainsteam.

In fact, we even build clip-over FPGA based devices for bugging network printers that rebroadcast on freq-shifted Wi-Fi giving us 'private spectrum' (Not exactly FCC approved, but WTH) - And we can use Selective Call Intercept boxes placed an the CP to get into a site to plant them too : ) .... for example, you position a low-wage phone-monkey who at some point nail-varnishes the jack... Despite the IT dept lasers are always an outside job... so, they make the call, it's diverted at the CP (either via DECT to a van, or by circuit from the CP) and we run a DTMF-driven soundboard to simulated the expected Call-Steering... Thats how we get our 'engineer' invited through the door, given a visitor pass and allowed to open and inspect the printer. The device is Then, not only do we have all your contracts, proposals, etc... but if we placed a 2-way then we also have a node on your LAN too. A parabolic on one side can often get a 1km link (If we lifted the FCC limiter on the 802.11 module) even in 'noisy' environments. For shielded buildings we can instead burst-reinject back through the local LAN as a poorer non-wireless solution.

So, from our POV 'security by the book' doesn't mean a great deal, nor does conventional approaches to ANY problem - including kernel-mode drivers as a security component. I hope you realise the great difference between a tiger-team and a script-monkey - like most security professionals you're possibly only aware of the latter threat.

Just to fill you in - our group is international, corporate and distinctively grey-hatted. We perform everything from OSCOR sweeps and Hi-Res Time-Domain Reflectrometry of private circuits to Pen-Tests and full blackhat/tiger services. Our diverse and talented membership includes people with extensive SIG-INT experience. We're all mature - I myself, though now retired, have ASM experience far predating the Zilog80 and have designed and built a high-speed, ultra-low-cost, supercluster leveraging the high-parallelism and low-cost of FPGA's into a 'flat-shared-everything cluster' which actually gives over 1000 times more bang-for-the-buck than a modern Cray SC or PC/SBC cluster in a semi-dedicated system... and can easily outperform one on many computing-tasks in a much smaller physical and logistical footprint (Once you take into account the Crays cooling and power supply requirements) - Feel free to laugh again, and again I can discuss details and post you various Cray specs for your own comparison. Because of this, we currently boast one of the most complete private rainbow-tables for NTLM/LM hashes.

Still want more Voodoo... ?

We also have a method of creating 'undetectable' code - in that a *conventional* AV signature cannot be formed. Indeed, the type of dedicated detection engine required to detect our multipass obfuscation of the decryption header (The weak link in any encrypted malware) would take long enough to perform a scan to render it prohibitively slow if used systemwide - and certainly too slow for a filesystem scan. Again, you can call 'BS' on this... yet sophos have had an example of this code for over 5 years now and, despite an annual prodding, it is YET to be detected in any AV product so forgive us if we feel we have the high-ground here too.

Now, you've had your laugh, in-fact... you're probably rolling around on the floor with tears running down your face - I'd now suggest you 'call me' on these points, I've certainly given you enough ammunition. But please don't continue to make fun of me unless you are similarly prepared to place your reputation on the line and your cards on the table. You can consider this a cordial invitation to a public peeing competition : )

(Oh, BTW, despite all the sarcastic jibes - I'd buy you a beer anytime)


Apologies if I sound a bit sharp - But telling someone to give up cus they don't stand a chance always gets me fired up : ) Its arrogant, impolite and is very much against everything my group and I stand for. Making sarcastic comments certainly doesn't help - and generally invites more of the same.

Your article here is to be applauded. There is precious little information out there for those wishing to learn to code below userspace on M$ boxes... and this is undoubtedly a fine example. But your arrogance in shooting down the original poster simply to bolster your work in that particular professional area is, I believe, a little off.

And THAT, Anton, is the point I tried to make earlier before things got heated : )

After all, despite how much you may detest rootkit and keylogger authors, its precisely people like myself and the OP that keep the IT security industry a billion-dollar baby at a time all the other IT disciplines are going through an economic slowdown. Indeed, many professionals have learned to feed from both ends.

Best regards,
GeneralRe: kernell mode keylogger Pin
Anton Bassov22-Nov-05 14:47
memberAnton Bassov22-Nov-05 14:47 
GeneralRe: kernell mode keylogger Pin
Medus23-Nov-05 6:05
memberMedus23-Nov-05 6:05 
GeneralRe: kernell mode keylogger Pin
Anton Bassov23-Nov-05 12:22
memberAnton Bassov23-Nov-05 12:22 
GeneralRe: kernell mode keylogger Pin
Medus24-Nov-05 16:35
memberMedus24-Nov-05 16:35 
GeneralRe: kernell mode keylogger Pin
Anton Bassov24-Nov-05 20:39
memberAnton Bassov24-Nov-05 20:39 
GeneralRe: kernell mode keylogger Pin
Medus25-Nov-05 6:39
memberMedus25-Nov-05 6:39 
GeneralRe: kernell mode keylogger Pin
ivan françois12-Aug-06 13:55
memberivan françois12-Aug-06 13:55 
GeneralRe: kernell mode keylogger Pin
_DmG_24-May-07 12:34
member_DmG_24-May-07 12:34 
Questionhow to block USB Pin
tungpn1-Jul-05 15:38
membertungpn1-Jul-05 15:38 
GeneralLocks up on XP Pin
Todd Smith23-Jun-05 12:52
memberTodd Smith23-Jun-05 12:52 
GeneralRe: Locks up on XP Pin
Vertexwahn4-Dec-05 20:50
memberVertexwahn4-Dec-05 20:50 
QuestionSlowdown caused by ntfs.sys driver hooks could be due to log file writes? Pin
rwid28-May-05 17:24
memberrwid28-May-05 17:24 
AnswerRe: Slowdown caused by ntfs.sys driver hooks could be due to log file writes? Pin
Anton Bassov31-May-05 15:04
memberAnton Bassov31-May-05 15:04 
GeneralRe: Slowdown caused by ntfs.sys driver hooks could be due to log file writes? Pin
rwid31-May-05 15:43
memberrwid31-May-05 15:43 
GeneralExcellent article! Just some questions... Pin
bengheng3-May-05 23:24
memberbengheng3-May-05 23:24 
GeneralRe: Excellent article! Just some questions... Pin
Anton Bassov31-May-05 15:00
memberAnton Bassov31-May-05 15:00 
GeneralTo grab copied file event Pin
tungpn13-Dec-04 21:11
membertungpn13-Dec-04 21:11 
GeneralRe: To grab copied file event Pin
Adrien Pinet25-Feb-05 22:23
memberAdrien Pinet25-Feb-05 22:23 
Generalhello I have something to ask Pin
euacela7-Aug-04 12:03
membereuacela7-Aug-04 12:03 
GeneralI really like you articles and your insight Pin
eku3-Aug-04 1:54
membereku3-Aug-04 1:54 
Generalquestion Pin
Pavel Koptev24-Jun-04 5:35
sussPavel Koptev24-Jun-04 5:35 
QuestionPost-Hook? Pin
paullox7-Jun-04 13:45
memberpaullox7-Jun-04 13:45 
AnswerRe: Post-Hook? Pin
Anton Bassov11-Jun-04 2:19
memberAnton Bassov11-Jun-04 2:19 
AnswerRe: Post-Hook? Pin
Anton Bassov25-Jan-05 23:53
memberAnton Bassov25-Jan-05 23:53 
GeneralGreat Article Pin
vijayv4-May-04 3:51
membervijayv4-May-04 3:51 
GeneralGreat Articles...^_^ Pin
hlchou1-May-04 23:11
memberhlchou1-May-04 23:11 
GeneralWindows DDK - Help Pin
Willian.BR27-Apr-04 1:30
sussWillian.BR27-Apr-04 1:30 
GeneralRe: Windows DDK - Help Pin
Anton Bassov28-Apr-04 2:14
memberAnton Bassov28-Apr-04 2:14 
GeneralRe: Windows DDK - Help Pin
A. Riazi1-May-04 23:50
memberA. Riazi1-May-04 23:50 
GeneralRe: Windows DDK - Help Pin
Anton Bassov25-Jan-05 23:57
memberAnton Bassov25-Jan-05 23:57 
GeneralRe: Windows DDK - Help Pin
virginlin16-Jun-05 4:06
membervirginlin16-Jun-05 4:06 
GeneralCould not compile. Pin
WREY22-Apr-04 9:53
memberWREY22-Apr-04 9:53 
GeneralRe: Could not compile. Pin
Jörgen Sigvardsson26-Apr-04 20:08
memberJörgen Sigvardsson26-Apr-04 20:08 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.170713.1 | Last Updated 22 Apr 2004
Article Copyright 2004 by Anton Bassov
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid