windows-server-2003/base/ntdll/ldrutil.c

/*++

Copyright (c) 1989  Microsoft Corporation

Module Name:

    ldrutil.c

Abstract:

    This module implements utility functions used by the NT loader (forked
    from ldrsnap.c).

Author:

    Michael Grier (MGrier) 04-Apr-2001, derived mostly from
        Mike O'Leary (mikeol) 23-Mar-1990

Revision History:

--*/

#include "ldrp.h"
#include "ntos.h"
#include <nt.h>
#include <ntrtl.h>
#include <nturtl.h>
#include <ntpsapi.h>
#include <heap.h>
#include "sxstypes.h"
#include <limits.h>

#define DLL_EXTENSION L".DLL"
#define DLL_REDIRECTION_LOCAL_SUFFIX L".Local"

#define INVALID_HANDLE_VALUE ((HANDLE)(LONG_PTR)-1)

BOOLEAN LdrpBreakOnExceptions = FALSE;


PLDR_DATA_TABLE_ENTRY
LdrpAllocateDataTableEntry (
    IN PVOID DllBase
    )

/*++

Routine Description:

    This function allocates a new loader data table entry.

Arguments:

    DllBase - Supplies the address of the base of the DLL image
              to be added to the loader data table.

Return Value:

    Returns the address of the allocated loader data table entry.

--*/

{
    PLDR_DATA_TABLE_ENTRY Entry;
    PIMAGE_NT_HEADERS NtHeaders;

    NtHeaders = RtlImageNtHeader (DllBase);

    if (NtHeaders) {

        Entry = RtlAllocateHeap (LdrpHeap,
                                 MAKE_TAG( LDR_TAG ) | HEAP_ZERO_MEMORY,
                                 sizeof(*Entry));

        if (Entry) {
            Entry->DllBase = DllBase;
            Entry->SizeOfImage = NtHeaders->OptionalHeader.SizeOfImage;
            Entry->TimeDateStamp = NtHeaders->FileHeader.TimeDateStamp;
            Entry->PatchInformation = NULL;
            return Entry;
        }
    }

    return NULL;
}


VOID
LdrpFinalizeAndDeallocateDataTableEntry (
    IN PLDR_DATA_TABLE_ENTRY Entry
    )
{
    ASSERT (Entry != NULL);

    if ((Entry->EntryPointActivationContext != NULL) &&
        (Entry->EntryPointActivationContext != INVALID_HANDLE_VALUE)) {

        RtlReleaseActivationContext (Entry->EntryPointActivationContext);
        Entry->EntryPointActivationContext = INVALID_HANDLE_VALUE;
    }

    if (Entry->FullDllName.Buffer != NULL) {
        LdrpFreeUnicodeString (&Entry->FullDllName);
    }

    LdrpDeallocateDataTableEntry (Entry);
}


NTSTATUS
LdrpAllocateUnicodeString (
    OUT PUNICODE_STRING StringOut,
    IN USHORT Length
    )
/*++

Routine Description:

    This routine allocates space for a UNICODE_STRING from the loader
    private heap.

Arguments:

    StringOut - Supplies a pointer to a UNICODE_STRING in which the
                information about the allocated string is written.  Any
                previous contents of StringOut are overwritten and lost.

    Length - Supplies the number of bytes of the string which StringOut
             must be able to hold.

Return Value:

    NTSTATUS indicating success or failure of this function.  In general
    the only reasons it fails are STATUS_NO_MEMORY when the heap allocation
    cannot be performed or STATUS_INVALID_PARAMETER when an invalid parameter
    value is passed in.

--*/
{
    ASSERT (StringOut != NULL);
    ASSERT (Length <= UNICODE_STRING_MAX_BYTES);

    StringOut->Length = 0;

    if ((Length % sizeof(WCHAR)) != 0) {
        StringOut->Buffer = NULL;
        StringOut->MaximumLength = 0;
        return STATUS_INVALID_PARAMETER;
    }

    StringOut->Buffer = RtlAllocateHeap (LdrpHeap, 0, Length + sizeof(WCHAR));

    if (StringOut->Buffer == NULL) {
        StringOut->MaximumLength = 0;
        return STATUS_NO_MEMORY;
    }

    StringOut->Buffer[Length / sizeof(WCHAR)] = L'\0';

    //
    // If the true length of the buffer can be represented in 16 bits,
    // store it; otherwise store the biggest number we can.
    //

    if (Length != UNICODE_STRING_MAX_BYTES) {
        StringOut->MaximumLength = Length + sizeof(WCHAR);
    }
    else {
        StringOut->MaximumLength = Length;
    }

    return STATUS_SUCCESS;
}


NTSTATUS
LdrpCopyUnicodeString (
    OUT PUNICODE_STRING StringOut,
    IN PCUNICODE_STRING StringIn
    )
/*++

Routine Description:

    This function makes a copy of a unicode string; the important aspect
    of it is that the string is allocated from the loader private heap.

Arguments:

    StringOut - Pointer to UNICODE_STRING in which the information about
        the copied string is written.  Any previous contents of StringOut
        are overwritten and lost.

    StringIn - Pointer to constant UNICODE_STRING which is copied.

Return Value:

    NTSTATUS indicating success or failure of this function.  In general
    the only reason it fails is STATUS_NO_MEMORY when the heap allocation
    cannot be performed.

--*/

{
    NTSTATUS st;

    ASSERT (StringOut != NULL);
    ASSERT (StringIn != NULL);

    st = RtlValidateUnicodeString (0, StringIn);

    if (!NT_SUCCESS(st)) {
        return st;
    }

    StringOut->Length = 0;
    StringOut->MaximumLength = 0;
    StringOut->Buffer = NULL;

    st = LdrpAllocateUnicodeString (StringOut, StringIn->Length);

    if (!NT_SUCCESS(st)) {
        return st;
    }

    RtlCopyMemory (StringOut->Buffer, StringIn->Buffer, StringIn->Length);
    StringOut->Length = StringIn->Length;

    return STATUS_SUCCESS;
}


VOID
LdrpFreeUnicodeString (
    IN OUT PUNICODE_STRING StringIn
    )
/*++

Routine Description:

    This function deallocates a string that was allocated using
    LdrpCopyUnicodeString.

Arguments:

    String - Pointer to UNICODE_STRING which is to be freed.  On exit,
                all the members are set to 0/null as appropriate.

Return Value:

    None

--*/

{
    ASSERT (StringIn != NULL);

    if (StringIn->Buffer != NULL) {
        RtlFreeHeap(LdrpHeap, 0, StringIn->Buffer);
    }

    StringIn->Length = 0;
    StringIn->MaximumLength = 0;
    StringIn->Buffer = NULL;
}


VOID
LdrpEnsureLoaderLockIsHeld (
    VOID
    )
{
    LOGICAL LoaderLockIsHeld =
        ((LdrpInLdrInit) ||
         ((LdrpShutdownInProgress) &&
          (LdrpShutdownThreadId == NtCurrentTeb()->ClientId.UniqueThread)) ||
         (LdrpLoaderLock.OwningThread == NtCurrentTeb()->ClientId.UniqueThread));

    ASSERT(LoaderLockIsHeld);

    if (!LoaderLockIsHeld) {
        RtlRaiseStatus(STATUS_NOT_LOCKED);
    }
}


int
LdrpGenericExceptionFilter (
    IN const struct _EXCEPTION_POINTERS *ExceptionPointers,
    IN PCSTR FunctionName
    )
/*++

Routine Description:

    Exception filter function used in __try block throughout the loader
    code instead of just specifying __except(EXCEPTION_EXECUTE_HANDLER).

Arguments:

    ExceptionPointers
        Pointer to exception information returned by GetExceptionInformation() in the __except()

    FunctionName
        Name of the function in which the __try block appears.


Return Value:

    EXCEPTION_EXECUTE_HANDLER

--*/
{
    const ULONG ExceptionCode = ExceptionPointers->ExceptionRecord->ExceptionCode;

    DbgPrintEx(
        DPFLTR_LDR_ID,
        LDR_ERROR_DPFLTR,
        "LDR: exception %08lx thrown within function %s\n"
        "   Exception record: %p\n"
        "   Context record: %p\n",
        ExceptionCode, FunctionName,
        ExceptionPointers->ExceptionRecord,
        ExceptionPointers->ContextRecord);

#ifdef _X86_
    // It would be nice to have a generic context dumper but right now I'm just trying to
    // debug X86 and this is the quick thing to do.  -mgrier 4/8/2001
    DbgPrintEx(
        DPFLTR_LDR_ID,
        LDR_ERROR_DPFLTR,
        "   Context->Eip = %p\n"
        "   Context->Ebp = %p\n"
        "   Context->Esp = %p\n",
        ExceptionPointers->ContextRecord->Eip,
        ExceptionPointers->ContextRecord->Ebp,
        ExceptionPointers->ContextRecord->Esp);
#endif // _X86_

    if (LdrpBreakOnExceptions) {

        char Response[2];

        do {
            DbgPrint ("\n***Exception thrown within loader***\n");
            DbgPrompt (
                "Break repeatedly, break Once, Ignore, terminate Process or terminate Thread (boipt)? ",
                Response,
                sizeof(Response));

            switch (Response[0]) {
            case 'b':
            case 'B':
            case 'o':
            case 'O':
                DbgPrint ("Execute '.cxr %p' to dump context\n", ExceptionPointers->ContextRecord);

                DbgBreakPoint ();

                if ((Response[0] == 'o') || (Response[0] == 'O')) {
                    return EXCEPTION_EXECUTE_HANDLER;
                }

            case 'I':
            case 'i':
                return EXCEPTION_EXECUTE_HANDLER;

            case 'P':
            case 'p':
                NtTerminateProcess (NtCurrentProcess(), ExceptionCode);
                break;

            case 'T':
            case 't':
                NtTerminateThread (NtCurrentThread(), ExceptionCode);
                break;
            }
        } while (TRUE);
    }

    return EXCEPTION_EXECUTE_HANDLER;
}


NTSTATUS
RtlComputePrivatizedDllName_U (
    IN PCUNICODE_STRING DllName,
    IN OUT PUNICODE_STRING NewDllNameUnderImageDir,
    IN OUT PUNICODE_STRING NewDllNameUnderLocalDir
    )

/*++

Routine Description:

    This function computes a fully qualified path to a DLL name. It takes
    the path of the current process and the base name from DllName and
    puts these together. DllName can have '\' or '/' as separator.

Arguments:

    DllName - Points to a string that names the library file. This can be
              a fully qualified name or just a base name. We will parse for
              the base name (the portion after the last '\' or '/' char.
              Caller guarantees that DllName->Buffer is not a NULL pointer!

    NewDllName - Has fully qualified path based on GetModuleFileNameW(NULL...)
                 and the base name from above.

Return Value:

    NTSTATUS: Currently: STATUS_NO_MEMORY or STATUS_SUCCESS.

--*/

{
    LPWSTR p, pp1, pp2;
    PWSTR  Dot;
    LPWSTR pFullImageName;
    USHORT cbFullImageNameLength;
    USHORT cbFullImagePathLengthWithTrailingSlash, cbDllFileNameLengthWithTrailingNULL;
    USHORT cbDllNameUnderImageDir, cbDllNameUnderLocalDir;
    ULONG  cbStringLength;
    PWSTR  Cursor = NULL;
    NTSTATUS status = STATUS_SUCCESS;
    LPWSTR pDllNameUnderImageDir = NULL;
    LPWSTR pDllNameUnderLocalDir = NULL;
    LPCWSTR pBuf1 = NewDllNameUnderImageDir->Buffer;
    LPCWSTR pBuf2 = NewDllNameUnderLocalDir->Buffer;

    cbFullImageNameLength = NtCurrentPeb()->ProcessParameters->ImagePathName.Length;
    pFullImageName = (PWSTR)NtCurrentPeb()->ProcessParameters->ImagePathName.Buffer;

    if (!(NtCurrentPeb()->ProcessParameters->Flags & RTL_USER_PROC_PARAMS_NORMALIZED)) {
        pFullImageName = (PWSTR)((PCHAR)pFullImageName + (ULONG_PTR)(NtCurrentPeb()->ProcessParameters));
    }

    ASSERT(pFullImageName != NULL);

    //
    // Find the end of the EXE path (start of its base-name) in pp1.
    // Size1 is number of bytes.
    //

    p = pFullImageName + cbFullImageNameLength/sizeof(WCHAR) - 1; // point to last character of this name
    pp1 = pFullImageName;
    while (p > pFullImageName) {
        if (RTL_IS_PATH_SEPARATOR(*p)) {
            pp1 = p + 1;
            break;
        }
        p -= 1;
    }

    //
    // Find the basename portion of the DLL to be loaded in pp2 and the
    // last '.' character if present in the basename.
    //

    pp2 = DllName->Buffer;
    Dot = NULL;

    if (DllName->Length) {

        ASSERT(RTL_STRING_IS_NUL_TERMINATED(DllName)); // temporary debugging

        p = DllName->Buffer + (DllName->Length>>1) - 1; // point to last char

        while (p > DllName->Buffer) {

            if (*p == (WCHAR) '.') {
                if (!Dot) {
                    Dot = p;
                }
            }
            else {
                if ((*p == (WCHAR) '\\') || (*p == (WCHAR) '/')) {
                    pp2 = p + 1;
                    break;
                }
            }
            p -= 1;
        }
    }

    //
    // Create a fully qualified path to the DLL name (using pp1 and pp2)
    // Number of bytes (not including NULL or EXE/process folder)
    //

    if (((pp1 - pFullImageName) * sizeof(WCHAR)) > ULONG_MAX) {
        DbgPrint ("ntdll: wants more than ULONG_MAX bytes \n");
        status = STATUS_NAME_TOO_LONG;
        goto Exit;
    }

    cbStringLength = (ULONG)((pp1 - pFullImageName) * sizeof(WCHAR));

    if (cbStringLength > UNICODE_STRING_MAX_BYTES) {
        status = STATUS_NAME_TOO_LONG;
        goto Exit;
    }

    cbFullImagePathLengthWithTrailingSlash = (USHORT)cbStringLength;

    //
    // Number of bytes in base DLL name (including trailing null char).
    //

    if (DllName->Length > (UNICODE_STRING_MAX_BYTES - sizeof(WCHAR))) {
        status = STATUS_NAME_TOO_LONG;
        goto Exit;
    }

    cbDllFileNameLengthWithTrailingNULL = (USHORT)(DllName->Length + sizeof(WCHAR) - ((pp2 - DllName->Buffer) * sizeof(WCHAR)));

    cbStringLength = cbFullImagePathLengthWithTrailingSlash
                     + cbDllFileNameLengthWithTrailingNULL;

    //
    // Allocate room for L".DLL"
    //

    if (Dot == NULL) {
        cbStringLength += sizeof(DLL_EXTENSION) - sizeof(WCHAR);
    }

    if (cbStringLength > UNICODE_STRING_MAX_BYTES) {
        status = STATUS_NAME_TOO_LONG;
        goto Exit;
    }

    cbDllNameUnderImageDir = (USHORT)cbStringLength;

    if (cbDllNameUnderImageDir > NewDllNameUnderImageDir->MaximumLength) {
        pDllNameUnderImageDir = (*RtlAllocateStringRoutine)(cbDllNameUnderImageDir);
        if (pDllNameUnderImageDir == NULL) {
            status = STATUS_NO_MEMORY;
            goto Exit;
        }
    }
    else {
        pDllNameUnderImageDir = NewDllNameUnderImageDir->Buffer;
    }

    Cursor = pDllNameUnderImageDir;
    RtlCopyMemory(Cursor, pFullImageName, cbFullImagePathLengthWithTrailingSlash);
    Cursor = pDllNameUnderImageDir + cbFullImagePathLengthWithTrailingSlash / sizeof(WCHAR);

    RtlCopyMemory(Cursor, pp2, cbDllFileNameLengthWithTrailingNULL - sizeof(WCHAR));
    Cursor += (cbDllFileNameLengthWithTrailingNULL - sizeof(WCHAR)) / sizeof(WCHAR);

    if (!Dot) {

        //
        // If there is no '.' in the basename add the ".DLL" to it.
        //
        // The -1 will work just as well as - sizeof(WCHAR) as we are
        // dividing by sizeof(WCHAR) and it will be rounded down
        // correctly as Size1 and Size2 are even.  The -1 could be
        // more optimal than subtracting sizeof(WCHAR).
        //

        RtlCopyMemory(Cursor, DLL_EXTENSION, sizeof(DLL_EXTENSION));

        cbDllFileNameLengthWithTrailingNULL += sizeof(DLL_EXTENSION) - sizeof(WCHAR); // Mark base name as being 8 bytes bigger.
    }
    else {
        *Cursor = L'\0';
    }

    cbStringLength = cbFullImageNameLength
                + sizeof(DLL_REDIRECTION_LOCAL_SUFFIX) - sizeof(WCHAR) //.local
                + sizeof(WCHAR) // "\\"
                + cbDllFileNameLengthWithTrailingNULL;

    if (cbStringLength > UNICODE_STRING_MAX_BYTES) {
        status = STATUS_NAME_TOO_LONG;
        goto Exit;
    }

    cbDllNameUnderLocalDir = (USHORT)cbStringLength;

    if ( cbDllNameUnderLocalDir > NewDllNameUnderLocalDir->MaximumLength) {
        pDllNameUnderLocalDir = (RtlAllocateStringRoutine)(cbDllNameUnderLocalDir);
        if (!pDllNameUnderLocalDir) {
            status = STATUS_NO_MEMORY;
            goto Exit;
        }
    }
    else {
        pDllNameUnderLocalDir = NewDllNameUnderLocalDir->Buffer;
    }

    Cursor = pDllNameUnderLocalDir;
    RtlCopyMemory(Cursor, pFullImageName, cbFullImageNameLength);
    Cursor = pDllNameUnderLocalDir + cbFullImageNameLength / sizeof(WCHAR);

    RtlCopyMemory(Cursor, DLL_REDIRECTION_LOCAL_SUFFIX, sizeof(DLL_REDIRECTION_LOCAL_SUFFIX) - sizeof(WCHAR));
    Cursor += (sizeof(DLL_REDIRECTION_LOCAL_SUFFIX) - sizeof(WCHAR)) / sizeof(WCHAR);

    *Cursor = L'\\';
    Cursor += 1;

    RtlCopyMemory(Cursor,
                  pDllNameUnderImageDir + cbFullImagePathLengthWithTrailingSlash/sizeof(WCHAR),
                  cbDllFileNameLengthWithTrailingNULL);


    NewDllNameUnderImageDir->Buffer = pDllNameUnderImageDir;

    if (pDllNameUnderImageDir != pBuf1) { // if memory is not-reallocated, MaximumLength should be untouched

        NewDllNameUnderImageDir->MaximumLength = cbDllNameUnderImageDir;
    }

    NewDllNameUnderImageDir->Length = (USHORT)(cbDllNameUnderImageDir - sizeof(WCHAR));

    NewDllNameUnderLocalDir->Buffer = pDllNameUnderLocalDir;

    if (pDllNameUnderLocalDir != pBuf2) {
        NewDllNameUnderLocalDir->MaximumLength = cbDllNameUnderLocalDir;
    }

    NewDllNameUnderLocalDir->Length = (USHORT)(cbDllNameUnderLocalDir - sizeof(WCHAR));

    return STATUS_SUCCESS;

Exit:
    if (!NT_SUCCESS(status)) {
        if (pDllNameUnderImageDir != NULL && pDllNameUnderImageDir != pBuf1) {
           (RtlFreeStringRoutine)(pDllNameUnderImageDir);
        }
        if (pDllNameUnderLocalDir != NULL && pDllNameUnderLocalDir != pBuf2) {
           (RtlFreeStringRoutine)(pDllNameUnderLocalDir);
        }
    }

    return status;
}