ntldropts.c File Reference

#include <freeldr.h>
#include "ntldropts.h"

Include dependency graph for ntldropts.c:

Go to the source code of this file.

Functions
PCSTR	NtLdrGetNextOption (IN OUT PCSTR *Options, OUT PULONG OptionLength OPTIONAL)
PCSTR	NtLdrGetOptionExN (IN PCSTR Options, IN PCCH OptionName, IN ULONG OptNameLength, OUT PULONG OptionLength OPTIONAL)
PCSTR	NtLdrGetOptionEx (IN PCSTR Options, IN PCSTR OptionName, OUT PULONG OptionLength OPTIONAL)
PCSTR	NtLdrGetOption (IN PCSTR Options, IN PCSTR OptionName)
VOID	NtLdrAddOptions (IN OUT PSTR LoadOptions, IN ULONG BufferSize, IN BOOLEAN Append, IN PCSTR NewOptions OPTIONAL)

Function Documentation

NtLdrAddOptions()

VOID NtLdrAddOptions	(	IN OUT PSTR	LoadOptions,
		IN ULONG	BufferSize,
		IN BOOLEAN	Append,
		IN PCSTR NewOptions	OPTIONAL
	)

Definition at line 140 of file ntldropts.c.

{
    ULONG OptionsLength;
    ULONG NewOptsLength;
    BOOLEAN AddSeparator;
 
    if (!LoadOptions || (BufferSize == 0))
        return;
    // ASSERT(strlen(LoadOptions) + 1 <= BufferSize);
 
    if (!NewOptions || !*NewOptions)
        return;
 
    if (Append)
    {
        OptionsLength = (ULONG)strlen(LoadOptions);
        OptionsLength = min(OptionsLength, BufferSize-1);
 
        /* Add a whitespace separator if needed */
        if (OptionsLength != 0 &&
            (LoadOptions[OptionsLength-1] != ' ') &&
            (LoadOptions[OptionsLength-1] != '\t') &&
            (*NewOptions != '\0') &&
            (*NewOptions != ' ') &&
            (*NewOptions != '\t'))
        {
            RtlStringCbCatA(LoadOptions, BufferSize * sizeof(CHAR), " ");
        }
 
        /* Append the options */
        RtlStringCbCatA(LoadOptions, BufferSize * sizeof(CHAR), NewOptions);
    }
    else
    {
        NewOptsLength = (ULONG)strlen(NewOptions);
        NewOptsLength = min(NewOptsLength, BufferSize-1);
 
        /* Add a whitespace separator if needed */
        AddSeparator = FALSE;
        if (NewOptsLength != 0 &&
            (NewOptions[NewOptsLength-1] != ' ') &&
            (NewOptions[NewOptsLength-1] != '\t') &&
            (*LoadOptions != '\0') &&
            (*LoadOptions != ' ') &&
            (*LoadOptions != '\t'))
        {
            AddSeparator = TRUE;
            ++NewOptsLength;
        }
 
        /*
         * Move the original load options forward (possibly truncating them
         * at the end if the buffer is not large enough) to make place for
         * the options to prepend.
         */
        OptionsLength = (ULONG)strlen(LoadOptions) + 1;
        OptionsLength = min(OptionsLength, BufferSize - NewOptsLength);
        RtlMoveMemory(LoadOptions + NewOptsLength,
                      LoadOptions,
                      OptionsLength * sizeof(CHAR));
        /* NULL-terminate */
        (LoadOptions + NewOptsLength)[OptionsLength-1] = '\0';
 
        /* Restore the new options length back to its original value */
        if (AddSeparator) --NewOptsLength;
        /* Prepend the options and add the whitespace separator if needed */
        strncpy(LoadOptions, NewOptions, NewOptsLength);
        if (AddSeparator) LoadOptions[NewOptsLength] = ' ';
    }
}

Referenced by NtLdrUpdateLoadOptions().

NtLdrGetNextOption()

PCSTR NtLdrGetNextOption	(	IN OUT PCSTR *	Options,
		OUT PULONG OptionLength	OPTIONAL
	)

Definition at line 16 of file ntldropts.c.

{
    PCSTR NextOption;
    PCSTR Option = NULL;
    ULONG Length = 0;
 
    if (OptionLength)
        *OptionLength = 0;
 
    if (!Options || !*Options)
        return NULL;
 
    /* Loop over each option */
    NextOption = *Options;
    while (*NextOption)
    {
        /* Skip possible initial whitespace */
        NextOption += strspn(NextOption, " \t");
 
        /* Stop now if we have already found an option.
         * NextOption points to the next following option. */
        if (Option)
            break;
 
        /*
         * Check whether a new option starts. Options are delimited
         * with an option separator '/' or with whitespace.
         */
        if (*NextOption == '/')
            ++NextOption;
 
        /* Get the actual length of the option until
         * the next whitespace or option separator. */
        Length = (ULONG)strcspn(NextOption, " \t/");
 
        /* Retrieve the option if present and go to the beginning of the next one */
        if (Length != 0)
            Option = NextOption;
 
        /* Restart after the end of the option */
        NextOption += Length;
    }
 
    *Options = NextOption;
    if (Option && OptionLength)
        *OptionLength = Length;
    return Option;
}

Referenced by NtLdrGetHigherPriorityOptions(), NtLdrGetOptionExN(), and NtLdrUpdateLoadOptions().

NtLdrGetOption()

PCSTR NtLdrGetOption	(	IN PCSTR	Options,
		IN PCSTR	OptionName
	)

Definition at line 128 of file ntldropts.c.

{
    return NtLdrGetOptionEx(Options, OptionName, NULL);
}

Referenced by GetSerialMouseDetectionBitmap(), LoadAndBootWindows(), LoadReactOSSetup(), LoadWindowsCore(), RamDiskInitialize(), and WinLdrSetupEms().

NtLdrGetOptionEx()

PCSTR NtLdrGetOptionEx	(	IN PCSTR	Options,
		IN PCSTR	OptionName,
		OUT PULONG OptionLength	OPTIONAL
	)

Definition at line 117 of file ntldropts.c.

{
    return NtLdrGetOptionExN(Options, OptionName,
                             (ULONG)strlen(OptionName),
                             OptionLength);
}

Referenced by GetSerialMouseDetectionBitmap(), LoadAndBootWindows(), LoadReactOSSetup(), LoadWindowsCore(), NtLdrGetOption(), and RamDiskInitialize().

NtLdrGetOptionExN()

PCSTR NtLdrGetOptionExN	(	IN PCSTR	Options,
		IN PCCH	OptionName,
		IN ULONG	OptNameLength,
		OUT PULONG OptionLength	OPTIONAL
	)

Definition at line 73 of file ntldropts.c.

{
    PCSTR NextOptions;
    PCSTR Option = NULL;
    ULONG OptLength = 0;
 
    if (OptionLength)
        *OptionLength = 0;
 
    if (!Options || !*Options)
        return NULL;
    if (!OptionName || (OptNameLength == 0) || !*OptionName)
        return NULL;
 
    NextOptions = Options;
    while ((Option = NtLdrGetNextOption(&NextOptions, &OptLength)))
    {
        /*
         * Check whether the option to find exactly matches the current
         * load option, or is a prefix thereof if this is an option with
         * appended data.
         */
        if ((OptLength >= OptNameLength) &&
            (_strnicmp(Option, OptionName, OptNameLength) == 0))
        {
            if ((OptLength == OptNameLength) ||
                (OptionName[OptNameLength-1] == '=') ||
                (OptionName[OptNameLength-1] == ':'))
            {
                break;
            }
        }
    }
 
    if (Option && OptionLength)
        *OptionLength = OptLength;
    return Option;
}

Referenced by NtLdrGetHigherPriorityOptions(), and NtLdrGetOptionEx().